Skip to guide
Macaron Docs

Desktop setup

Open your first project and start an agent.

Install the desktop app

Download the installer for your device at https://macaron.sh/download. On macOS, open the .dmg and drag Macaron into Applications. On Windows, run the installer and choose its installation folder.

Open it the first time

Macaron’s installers are not code-signed, so macOS and Windows ask you to confirm the first time you open the app. You do this once.

  • macOS 15 or later: open Macaron and close the warning that says macOS can’t check it. Open System Settings → Privacy & Security, scroll down to Security and click Open Anyway next to the message about Macaron. Enter your administrator password, then choose Open. Control-click → Open no longer gets past this check on macOS 15 and later.
  • Windows: if SmartScreen says Windows protected your PC, choose More info, then Run anyway.

Open a folder

Choose Open a local folder, then select your project. Macaron works with the files in that folder. You do not need a paid Macaron account to use local projects.

Start your agent

Open New agent and choose Claude Code, Codex, OpenCode or Droid. Connect that agent’s account or API key when prompted. Describe one task, review its proposed actions, then inspect the changed files and run your project checks.