CLI Commands

The agentteams CLI manages platform entities — plans, reports, co-actions, and more — from your terminal.


agentteams <command> <action> [options]
agentteams --help             # all commands
agentteams <command> --help   # actions/options per command

Command list

Command	Description
`init`	Initialize the CLI via OAuth (creates `.agentteams/`)
`sync`	Sync convention files from the API to your repo
`doctor`	Diagnose convention reachability, install worktree hook
`plan`	Manage plans
`task`	Manage plan tasks
`comment`	Manage plan comments
`report`	Manage completion reports
`coaction`	Manage co-actions (session context)
`postmortem`	Manage post-mortems
`code-review`	Manage independent code reviews
`convention`	Manage project conventions
`document`	Manage project documents
`dependency`	Manage plan dependencies
`change-set`	Manage cross-repository change sets and merge order
`agent-config`	Manage agent configurations
`attachment`	Manage runner request and document attachments
`feedback`	Manage platform feedback
`config`	Manage CLI configuration
`search`	Search across all entity types
`linear`	Read/comment on Linear issues
`mcp`	Run the MCP server and register clients
`worktree`	Report Orca worktree lifecycle events

Action pattern

Most commands take an <action>. The common actions are list, get, create, update, delete, with domain-specific actions added per command.


# Plans: start, finish, quick, assign, download, etc. on top of CRUD
agentteams plan list
agentteams plan start --id <planId>
agentteams plan finish --id <planId> --report-title "..." --report-file <path> \
  --runner-type CLAUDE_CODE --model <model-id> --quality-score 90 --report-status COMPLETED
 
# Completion reports
agentteams report create --plan-id <planId> --title "..." --file <path> \
  --runner-type CLAUDE_CODE --model <model-id>
 
# Unified search
agentteams search --query "<keyword>" --format json
agentteams search --query "<keyword>" --types BITBUCKET_ISSUE,BITBUCKET_PR --format json

See Plans for plan lifecycle rules and Code Review for review workflow.

Document attachments

Use --document-id with the attachment command to add files to a document or list its attachments.


agentteams attachment create --document-id <documentId> --file ./guide.pdf
agentteams attachment list --document-id <documentId>

For create, use exactly one of --document-id, --code-review-id, or --completion-report-id. For list, use exactly one of --document-id or --trigger-id.