AO: Agent Orchestrator

Documentation

Claude Code

Built-in Terminal UI and structured Chat support for the user's Claude Code installation.

AO resolves the claude executable from your machine and reuses its existing authentication. Install and sign in with Claude Code before refreshing the AO catalog.

ao agent ls --refresh
ao spawn --project my-app --name claude-task --agent claude-code --mode chat

Interfaces

  • Terminal UI: runs the native Claude Code CLI in the session worktree.
  • Chat: uses AO's ACP transport with claude-agent-acp, pointed at your Claude executable.

Claude Code is one of the harnesses that can move between Chat and Terminal UI without changing the AO session or worktree. Idle sessions can switch directly; a busy Chat turn requires an explicit drain or interrupt policy in the desktop UI.

AO installs its supported activity hook during workspace setup. Use ao agent ls --refresh --json for install/auth diagnostics rather than editing a plugin block.