CLI Overview - Army of Agents

The AoA CLI handles instance setup, diagnostics, and control-plane operations. For instance-admin reconciliation and durable inspection commands, see Marketplace recovery.

Usage

pnpm aoa --help

Global Options

All commands support:

Flag	Description
`--data-dir <path>`	Local AoA data root (isolates from `~/.aoa`)
`--api-base <url>`	API base URL
`--api-key <token>`	Bearer token override; stored board login is the final fallback
`--context <path>`	Context file path
`--profile <name>`	Context profile name
`--json`	Output as JSON

Company-scoped commands also accept --company-id <id>. For clean local instances, pass --data-dir on the command you run:

pnpm aoa run --data-dir ./tmp/aoa-dev

Context Profiles

Store defaults to avoid repeating flags:

# Set defaults
pnpm aoa context set --api-base http://localhost:3100 --company-id <id>

# View current context
pnpm aoa context show

# List profiles
pnpm aoa context list

# Switch profile
pnpm aoa context use default

To avoid storing secrets in context, use an env var:

pnpm aoa context set --api-key-env-var-name AOA_API_KEY
export AOA_API_KEY=...

Context is stored at ~/.aoa/context.json.

Command Categories

The CLI has two categories:

Setup commands — instance bootstrap, diagnostics, configuration
Control-plane commands — issues, agents, approvals, activity

​Usage

​Global Options

​Context Profiles

​Command Categories

Usage

Global Options

Context Profiles

Command Categories