Set up with your coding agent
Ask Claude Code, Codex, or another coding agent to register your project and start its orchestrator.
After you install the desktop app, a coding agent can do the rest of the setup. Two steps stay with you: signing in to the agent, and signing in to GitHub with gh auth login.
Ask an agent inside Orchestrator
- Click + next to Projects, choose On this computer, then Start a standalone agent.
- Send a request like this one:
Set up Orchestrator for my repository at /path/to/repo: register it as a project, start its orchestrator, and tell me where to click next.Agents that Orchestrator starts already have the ao command on their PATH and a guide to it.
If the page says No agent is ready, install and sign in to one under Settings → Harness first.
Ask an agent outside Orchestrator
An agent in your own terminal needs the bundled CLI, which a new install does not add to your PATH. See Run the CLI. Give the agent this page, or these steps:
ao statusreports the daemon ready, andao doctorprints noFAILlines.ao agent ls --refreshshows the agent you want asinstalledandauthorized.ao project add --path <absolute-path> --worker-agent <agent> --orchestrator-agent <agent>registers the repository. A repository with no remote also needsao project set-config <project-id> --default-branch <branch>before sessions can start.ao spawn --project <project-id> --kind orchestrator --name "<name>"starts the project's orchestrator, as the app does when you add a project there.- Open the project in the app. New task starts a worker, and Orchestrator opens the project's main agent.
What stays with you
- Signing in to a coding agent, under Settings → Harness or in the agent's own CLI.
- Signing in to GitHub with
gh auth login, for pull requests and CI. - Choosing the repository, when more than one is plausible.