Control plane commands - Company Agents

Control plane commands are the ones you run every day. Every command below corresponds to a REST API endpoint; the CLI is a thin, ergonomic wrapper with helpful defaults and rich output. All commands accept the global flags from the CLI overview: --profile, --output, --quiet, etc.

Company commands

`company-agents company list`

company-agents company list

Lists companies in the current instance. Flags:

--status active|archived|all (default active)
--output table|json|yaml

`company-agents company create`

company-agents company create \
  --name "Ampha Group" \
  --slug ampha-group \
  --budget 500 \
  --period monthly \
  --adapter claude-code

Creates a new company. For interactive creation, omit the flags and the CLI walks you through a form.

`company-agents company show`

company-agents company show ampha-group

Detailed view of one company, with embedded teams and agents.

`company-agents company archive`

company-agents company archive ampha-group

Soft delete. Restore with company-agents company restore.

Team commands

`company-agents team list`

company-agents team list --company ampha-group

`company-agents team create`

company-agents team create \
  --company ampha-group \
  --name "Engineering" \
  --headcount 3 \
  --budget-share 40

Agent commands

`company-agents agent list`

company-agents agent list --company ampha-group
company-agents agent list --company ampha-group --team engineering

`company-agents agent hire`

company-agents agent hire \
  --company ampha-group \
  --team engineering \
  --name "Senior Engineer" \
  --role ic-engineer \
  --adapter claude-code \
  --model claude-sonnet-4-6 \
  --task-budget 2.50 \
  --approvals "push-to-main,prod-deploy"

`company-agents agent pause`, `resume`, `retire`

company-agents agent pause agt_a1b2c3
company-agents agent resume agt_a1b2c3
company-agents agent retire agt_a1b2c3 --reason "replaced"

`company-agents agent show`

company-agents agent show agt_a1b2c3

Shows the agent’s profile, current task, memory scopes, budget, stats, and last 10 runs.

Task (issue) commands

`company-agents task list`

company-agents task list --company ampha-group --status running

Filters:

--status, --agent, --team, --label, --since, --until
--parent to see children of a specific task

`company-agents task create`

company-agents task create \
  --company ampha-group \
  --team engineering \
  --title "Rewrite hero section" \
  --description "Short, punchy, on-brand." \
  --budget 1.50 \
  --labels marketing,priority:medium

`company-agents task show`

company-agents task show iss_a1b2c3

Shows the task, its runs, its comments, its cost, and its children.

`company-agents task assign`, `cancel`, `reassign`

company-agents task assign iss_a1b2c3 --to agt_d4e5f6
company-agents task cancel iss_a1b2c3 --reason "no longer needed"
company-agents task reassign iss_a1b2c3 --to agt_g7h8i9 --reason "better fit"

`company-agents task comment`

company-agents task comment iss_a1b2c3 --text "Please use Opus for this one"

`company-agents task watch`

company-agents task watch iss_a1b2c3

Streams progress events, comments, and cost updates in real time until the task finishes or you Ctrl+C.

Workflow commands

`company-agents workflow list`

company-agents workflow list --company ampha-group

`company-agents workflow run`

company-agents workflow run campaign-draft \
  --company ampha-group \
  --input brief=brief.md \
  --input deadline=2026-04-15

Runs a workflow with the given inputs. Print a run ID on success; follow with task watch if you want to see progress.

`company-agents workflow edit`

Opens the workflow’s YAML in $EDITOR. On save, the CLI validates the YAML and uploads it back.

company-agents workflow edit campaign-draft --company ampha-group

Approval commands

`company-agents approval list`

company-agents approval list --company ampha-group --status pending

`company-agents approval show`

company-agents approval show apr_a1b2c3

`company-agents approval approve`, `deny`

company-agents approval approve apr_a1b2c3 --note "ship it"
company-agents approval deny apr_a1b2c3 --reason "off-brand"

`company-agents approval watch`

company-agents approval watch --company ampha-group

Streams new approvals as they arrive, so you can have a terminal open while agents run.

Cost commands

`company-agents cost show`

company-agents cost show --company ampha-group
company-agents cost show --company ampha-group --since 7d

Shows the cost panel for the scope: total, breakdown, per-team, forecast.

`company-agents cost forecast`

company-agents cost forecast --company ampha-group

Shows the projected spend to end of period with a confidence band.

`company-agents cost topup`

company-agents cost topup \
  --company ampha-group \
  --team marketing \
  --amount 50 \
  --reason "critical campaign launch"

Secret commands

`company-agents secret list`

company-agents secret list --company ampha-group

Metadata only. Never values.

`company-agents secret set`

company-agents secret set \
  --company ampha-group \
  --name anthropic_api_key \
  --value-env ANTHROPIC_API_KEY

Reads the value from the env var and writes it to the encrypted store. Never passes the value on the command line (that would leak into shell history).

`company-agents secret rotate`

company-agents secret rotate \
  --company ampha-group \
  --name anthropic_api_key \
  --value-env NEW_ANTHROPIC_KEY

`company-agents secret delete`

company-agents secret delete --company ampha-group --name old_key

Activity commands

`company-agents activity list`

company-agents activity list --company ampha-group --since 24h

Filters: --category, --action, --actor, --task, --agent, --run.

`company-agents activity watch`

company-agents activity watch --company ampha-group

Tails the activity log as events happen. Great for a second terminal alongside task watch.

`company-agents activity export`

company-agents activity export \
  --company ampha-group \
  --format jsonl \
  --since 2026-04-01 \
  --output activity-april.jsonl

Integration commands

`company-agents integration list`

company-agents integration list --company ampha-group

`company-agents integration connect`

company-agents integration connect slack --company ampha-group

Walks you through the OAuth or API-key flow for the integration. Writes the resulting secrets via the secret API.

`company-agents integration disconnect`

company-agents integration disconnect slack --company ampha-group

Run commands

`company-agents run show`

company-agents run show run_a1b2c3

Shows the run’s details: start and end times, final checkpoint, cost roll-up, exit reason, link to the workspace.

`company-agents run logs`

company-agents run logs run_a1b2c3

Prints the run’s logs. Add -f to follow if the run is still in progress.

`company-agents run kill`

company-agents run kill run_a1b2c3 --reason "stuck in loop"

Force-kills a running task. Releases the lease, tears down the process group, writes a failed record.

Putting it together

A typical session:

# Start the day
company-agents approval watch &
company-agents activity watch --category budget &

# Trigger a workflow
company-agents workflow run campaign-draft \
  --company ampha-group \
  --input brief=brief.md

# Watch a specific task
company-agents task watch iss_a1b2c3

# Respond to an approval
company-agents approval approve apr_d4e5f6

The CLI is designed so that a keyboard-first operator can run a whole company without touching the dashboard. Try it.

Setup commands for the one-time install and configuration
API Reference for the underlying REST endpoints
Board operator guides for the same operations through the UI

CLI Reference

​Company commands

​company-agents company list

​company-agents company create

​company-agents company show

​company-agents company archive

​Team commands

​company-agents team list

​company-agents team create

​Agent commands

​company-agents agent list

​company-agents agent hire

​company-agents agent pause, resume, retire

​company-agents agent show

​Task (issue) commands

​company-agents task list

​company-agents task create

​company-agents task show

​company-agents task assign, cancel, reassign

​company-agents task comment

​company-agents task watch

​Workflow commands

​company-agents workflow list

​company-agents workflow run

​company-agents workflow edit

​Approval commands

​company-agents approval list

​company-agents approval show

​company-agents approval approve, deny

​company-agents approval watch

​Cost commands

​company-agents cost show

​company-agents cost forecast

​company-agents cost topup

​Secret commands

​company-agents secret list

​company-agents secret set

​company-agents secret rotate

​company-agents secret delete

​Activity commands

​company-agents activity list

​company-agents activity watch

​company-agents activity export

​Integration commands

​company-agents integration list

​company-agents integration connect

​company-agents integration disconnect

​Run commands

​company-agents run show

​company-agents run logs

​company-agents run kill

​Putting it together

​Next