Docs

Install

Download and install the signed, notarized Recoder desktop app for macOS, verify the download, and see what the app starts on your machine.

Recoder ships as a desktop app that runs entirely on your machine. There's no account required to start.

Download

Go to the download page and pick your platform. On macOS (Apple Silicon / arm64) the build is signed with an Apple Developer ID and notarized by Apple, so it installs without Gatekeeper warnings. Intel and universal builds are on the roadmap; Windows and Linux show a notify-me option until they ship.

Verify the download (recommended)

Every macOS build publishes a SHA-256 checksum. On the download page, expand “Verify checksum” and confirm it matches before installing:

shasum -a 256 ~/Downloads/Recoder-<version>-arm64.dmg
# compare the output to the digest shown on the download page

You can also confirm the signature and notarization yourself:

codesign --verify --deep --strict /Applications/Recoder.app && echo "signature OK"
xcrun stapler validate ~/Downloads/Recoder-<version>-arm64.dmg

Install

  1. 1Open the .dmg.
  2. 2Drag Recoder to your Applications folder.
  3. 3Launch it from Applications. Because the build is notarized, macOS opens it without the “unidentified developer” prompt.

First run — what starts on your machine

When Recoder launches it starts a local control-plane backend on your machine (loopback 127.0.0.1:3100 by default) and supervises it. This backend is the conductor + agent-os + engine host. Nothing is exposed to the network; it binds to loopback only.

On first run, Recoder imports your local environment so it can drive the agents you already have: your git identity for commits it makes on your behalf, which agent CLIs are installed and on your PATH, your GitHub CLI (gh) auth if present, and your shell environment so agents inherit the keys and tools you normally use.