Skip to content

Getting Started

Everything you need to go from download to running app.

Install

Homebrew:

brew install bittavern/tap/arbitr

Or download the zip:

  1. Download the latest release.
  2. Open the downloaded zip.
  3. Drag Arbitr into your Applications folder.
  4. Launch it.

Requirements

  • macOS 26 or later
  • At least one coding agent CLI, installed and signed in

Arbitr runs the agents; it does not include one. Install Claude Code, Codex or Cursor the way each one’s own documentation says, and sign in with its own command, before you start. See Agents.

First steps

  1. Add an agent. Open Settings with ⌘, and pick Agents. Arbitr lists what it found on your Mac; press Add next to the one you want.
  2. Add a project. Press ⇧⌘O and choose a folder. This is where the agent will work.
  3. Start a conversation. Press ⇧⌘N, type what you want done, and press Return. The agent edits files in that folder as it goes.
  4. Read what changed. Press ⇧⌘G for the Git panel when the prompt ends. Nothing is committed for you, so this is where you decide what to keep.

Then read Projects and conversations — in particular, what happens when you run two agents on the same folder — and Security and privacy, which explains what an agent is allowed to do on your Mac.

Agents