Install and set up Ditto AI
Ditto AI runs on Macs with Apple silicon and macOS 15 or later. Download the .dmg, drag Ditto AI to Applications, and confirm it in System Settings the first time you open it. Setup then asks who reads your recordings, either your own Anthropic, OpenAI or Amazon Bedrock account or Ditto AI with a token, and walks you through the Mac permissions it needs.
What you need
| Mac | Apple silicon (M1 or later) |
|---|---|
| macOS | 15 Sequoia or later |
| AI provider | Your own Anthropic, OpenAI or Amazon Bedrock account, or a Ditto AI token |
| Disk | About 120 MB for the download, plus space for your recordings |
| Optional | Claude Code or Kiro, if you want agents installed there |
No Mac to hand? You can try Ditto AI in your browser with a sample task. Nothing is recorded there and no model is called.
1. Download and open it
- Download Ditto AI from buildagents.pro, open the .dmg, and drag Ditto AI into Applications.
- Open it from Applications. Until Ditto AI’s downloads are notarized by Apple, macOS stops the first open and says it can’t check the app.
- Open System Settings → Privacy & Security, scroll to Security, and click Open Anyway next to the message about Ditto AI. Confirm with your password or Touch ID.
You only do this once. After that, Ditto AI opens like any other app, and Check for Updates in the app keeps it current.
2. Choose who reads your recordings
Ditto uses a model to understand what you recorded. Setup asks which one:
- Your own account: an Anthropic or OpenAI API key, or an AWS profile for Amazon Bedrock. Model calls are billed to that account.
- Ditto AI: enter your Ditto AI token.
Ditto says connected and ready only after a real round trip to that provider, and saves nothing until it does. Keys and tokens are stored in the macOS Keychain. You can change the provider later in Settings.
3. Grant the permissions
macOS asks before any app can see your screen or your clicks. Ditto asks for each permission when it needs it, links straight to the right pane of System Settings, and re-checks as soon as you’ve granted it.
| Permission | Why Ditto needs it |
|---|---|
| Screen & System Audio Recording | To keep frames of what you did |
| Accessibility | To know which control you clicked, what was in focus, and the address in your browser |
| Input Monitoring | To notice clicks while recording, without changing them |
| Microphone | Only if you talk through a task while recording |
| Speech Recognition | To transcribe your narration on the Mac |
| Automation | To read details, such as a page’s address, from apps that don’t expose them otherwise |
Screen Recording takes effect only after the app restarts. Ditto offers to restart itself when you grant it.
4. Record your first task
- Start recording from the menu bar, or press ⌃⌥⌘R. A small panel shows the time and how many frames have been kept.
- Do the task once, start to finish, with real data. Say what changes if you like: “this is the invoice number”.
- Stop from the menu bar, the panel, or the same shortcut.
Ditto then works out the process, finds and checks the tools, and shows you the result to review. For tips on recording, see How to turn a screen recording into an AI agent.
5. Review and run
In the review you’ll see the process, the steps with the evidence for each, the inputs, and every tool with its status. Fix anything that’s wrong, connect any tool that shows input required, then run the agent. Ditto can run it itself, or install it into Claude Code or Kiro with its tool servers attached.
For the first runs, turn on Ask before it creates, sends or changes anything, so every write comes to you as a draft first.
Open an agent someone shared
Agents can be shared as .ditto.json files. Double-click one, AirDrop it to your Mac, or drop it on the Ditto AI window. It goes through the same review as your own recordings, and its permissions are worked out again on your Mac rather than taken from the file.
Where Ditto keeps things
| What | Where |
|---|---|
| Recordings, agents, cache and tool credentials | Application Support → Ditto AI, in your user Library, readable only by you |
| AI provider keys and your Ditto token | The macOS Keychain, under “Ditto AI provider keys” |
| Logs | Logs → Ditto AI, in your user Library |
| Agents installed into Claude Code or Kiro | Where those apps keep their skills and agents |
Troubleshooting
- A permission doesn’t seem to work. Quit Ditto AI completely and open it again. macOS applies some permissions only to a freshly started app.
- A tool shows check failed. The server started but its read-only call didn’t work. The reason is shown next to the tool, often an API that needs turning on, or an expired sign-in.
- A tool shows rate-limited. Your key works; the service is throttling it. Wait a little and check again.
- It found no steps. The recording probably shows one app sitting idle. Record the task again across the apps it really uses.
Uninstall
- Quit Ditto AI. That also stops everything it started.
- Delete Ditto AI from Applications.
- Delete the Ditto AI folders in your user Library, under Application Support, Logs and Caches. This removes your recordings, agents and tool credentials.
- In Keychain Access, delete the Ditto AI provider keys items.
- In System Settings → Privacy & Security, remove Ditto AI from each permission it had.
- Agents you installed into Claude Code or Kiro stay there until you remove them in those apps.