Skip to content
AndonDocs
GitHub

Hand your cards to coding agents on your own machines

You write a card; Claude Code, Codex or Gemini CLI picks it up on one of your computers, works on it in a git worktree of its own, and opens a pull request. These docs cover installing Andon, adding machines, working the board and running it for a team.

From nothing to your first answered card

  1. 1Deploy AndonRun your own instance: one server, which also serves the board, and one Postgres.Read: Deploy Andon
  2. 2Add a machineRun the installer from your board on a Mac or Linux computer with Claude Code, Codex or Gemini CLI.Read: Mac machines
  3. 3Start workTurn one sentence into a card, an import, a plan of several cards, or a study.Read: Start work
  4. 4Answer what needs youA question from a run, outputs to approve, a pull request that needs a hand. Answer, and the agents keep going.Read: Needs you

Already have Claude Code on a Mac or Linux computer?

Run the installer from your board, approve the machine in the browser tab that opens, and pick a policy preset. Orca is optional: without it the machine runs in direct mode, with a git worktree and tmux.

Terminal on the new machine
$ curl -fsSL https://<your board>/install.sh | sh