CLI command reference · Agent Comms Docs

This catalog is generated from the same Cobra command tree used by the binary. Hidden service commands are excluded. Global flags appear with the commands that inherit them.

Use agent-comms <command> --help in the installed build for terminal-native help.

Filter commands

127 visible commands

agent-commsGoverned coordination for concurrent agents

Agent Comms coordinates agents through signed project state, explicit ownership, and auditable transitions. Output contracts: --output human|plain|json|jsonl. Human is TTY-aware; plain is stable text; JSON preserves the versioned envelope; JSONL is available only for natural streams. `agc` is a shorter alias for this same CLI, installed alongside it -- agc status works identically to agent-comms status.

Usageagent-comms

Example

  agent-comms status
  agent-comms task list --output plain
  agent-comms watch --output jsonl
  agent-comms invocation request --to builder --instruction "Run tests" --json

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms agentManage governed identities, roles, scopes, and keys

Usageagent-comms agent

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms agent activateActivate an identity with a role and scopes

Usageagent-comms agent activate [flags]

Flags

--actoractor override (credential must match)string

--capabilitycapability (repeatable or comma-separated)stringSlice · default []

--detailsshow secondary and nested fields in human outputbool · default false

--idprincipal IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--rolerole: ORCHESTRATOR or any custom labelstring

--scopescope (repeatable or comma-separated)stringSlice · default []

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms agent deleteDelete this agent

Usageagent-comms agent delete [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--reasonauditable deletion reasonstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms agent elevate-keyRegister a passphrase-protected key for sensitive identity and HUMAN-approval actions

Usageagent-comms agent elevate-key

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms agent listList governed identities

Usageagent-comms agent list

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms agent registerRegister a governed identity

Usageagent-comms agent register [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--display-namedisplay namestring

--idprincipal IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--principal-typeHUMAN or AGENTstring · default AGENT

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms agent renameRename an identity's display name

Usageagent-comms agent rename [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--display-namenew display namestring

--idprincipal IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms agent revokeRevoke this agent

Usageagent-comms agent revoke [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--reasonrevocation reasonstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms agent rotate-keyRotate this identity's signing key

Usageagent-comms agent rotate-key

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms agent showShow one agent by ID

Usageagent-comms agent show [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms agent suspendSuspend this agent

Usageagent-comms agent suspend [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms agent switch-roleSwitch your own role (self-service; never OWNER)

Usageagent-comms agent switch-role [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--rolenew role: ORCHESTRATOR or any custom labelstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms agent-instructionsPrint setup and command guidance for a collaborating agent

Usageagent-comms agent-instructions

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms approvalRequest and resolve governed approvals

Usageagent-comms approval

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms approval approveMove this approval to approve

Usageagent-comms approval approve [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms approval listList approvals and their status

Usageagent-comms approval list

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms approval rejectMove this approval to reject

Usageagent-comms approval reject [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms approval requestRequest a governed approval

Usageagent-comms approval request [flags]

Flags

--actionproposed actionstring

--actoractor override (credential must match)string

--affectedaffected principalstringSlice · default []

--detailsshow secondary and nested fields in human outputbool · default false

--expires-inapproval validity windowduration · default 0s

--idapproval ID (auto-generated if omitted)string

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--reasonreasonstring

--subject-digestcanonical operation digest for a bound approvalstring

--subject-jsoncanonical operation JSON for approver reviewstring

--tierORCHESTRATOR or HUMANstring · default ORCHESTRATOR

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms approval showShow one approval by ID

Usageagent-comms approval show [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms archiveArchive eligible completed project state

Usageagent-comms archive

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms artifactStore, inspect, and verify content-addressed artifacts

Usageagent-comms artifact

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms artifact addStore a file as a content-addressed artifact

Usageagent-comms artifact add [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--pathartifact pathstring

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms artifact showShow an artifact by its SHA-256

Usageagent-comms artifact show [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--sha256artifact digeststring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms artifact verifyVerify an artifact's content matches its SHA-256

Usageagent-comms artifact verify [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--sha256artifact digeststring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms attentionList everything currently needing operator intervention

Usageagent-comms attention

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms completionGenerate shell completion source

Generate a shell completion script for agent-comms. The script completes the `agent-comms` command. To also complete the `agc` alias in bash, append `complete -F __start_agent-comms agc` to it (zsh: `compdef _agent-comms agc`).

Usageagent-comms completion <bash|zsh|fish|powershell>

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms configInspect and set user and project configuration

Usageagent-comms config

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms config themeSet the UI theme for this user

Usageagent-comms config theme <auto|dark|high-contrast>

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms doctorDiagnose project health and actionable findings

Usageagent-comms doctor [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--explain-configshow configuration precedence and resolved valuesbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms documentCreate and manage governed project documents

Usageagent-comms document

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms document createCreate a governed document

Usageagent-comms document create [flags]

Flags

--actoractor override (credential must match)string

--bodybodystring

--body-fileread body from file (bypasses CLI arg limits)string

--decisiontag this document `decision` (replaces the former `decision create`)bool · default false

--detailsshow secondary and nested fields in human outputbool · default false

--iddocument ID (auto-generated if omitted)string

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--notifypost a DECISION message to this principal for acknowledgement (repeatable)stringSlice · default []

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--tagtag (repeatable)stringSlice · default []

--timeouttransaction lock timeoutduration · default 10s

--titletitlestring

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms document listList governed documents

Usageagent-comms document list

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms document notifyRetry a document acknowledgement notification

Usageagent-comms document notify [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--iddocument IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--notifyprincipal to (re)notify (repeatable)stringSlice · default []

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms document showShow one governed document by ID

Usageagent-comms document show [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--iddocument IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms document supersedeReplace a document with a newer one

Usageagent-comms document supersede [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--iddocument IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--replacementreplacement document IDstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms document updateUpdate a governed document's body or tags

Usageagent-comms document update [flags]

Flags

--actoractor override (credential must match)string

--bodybodystring

--body-fileread body from file (bypasses CLI arg limits)string

--detailsshow secondary and nested fields in human outputbool · default false

--iddocument IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--tagtag (repeatable)stringSlice · default []

--timeouttransaction lock timeoutduration · default 10s

--titletitlestring

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms draftManage non-authoritative local drafts

Usageagent-comms draft

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms draft listList local drafts

Usageagent-comms draft list [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--limitmaximum drafts to returnint · default 100

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms draft saveSave a non-authoritative local draft

Usageagent-comms draft save [flags]

Flags

--actoractor override (credential must match)string

--bodydraft JSON or textstring

--body-fileread draft content from a filestring

--detailsshow secondary and nested fields in human outputbool · default false

--iddraft IDstring

--jsonemit a versioned JSON envelopebool · default false

--kinddocument, message, or artifactstring

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms draft showShow one local draft by ID

Usageagent-comms draft show [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--iddraft IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms envManage governed project environment values

Usageagent-comms env

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms env deleteDelete a governed environment value

Usageagent-comms env delete [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--keykeystring

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms env getGet a governed environment value

Usageagent-comms env get [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--keykeystring

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms env listList governed environment values

Usageagent-comms env list

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms env setSet a governed environment value

Usageagent-comms env set [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--keykeystring

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

--valuevaluestring

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms exportExport project history as JSONL or Markdown

Usageagent-comms export <jsonl|markdown> [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

-o, --outputoutput filestring

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms historyInspect and search the signed event timeline

Usageagent-comms history [flags]

Flags

--actoronly events signed by this actorstring

--allpage through the entire log rather than one pagebool · default false

--cursoropaque pagination cursorstring

--detailsshow secondary and nested fields in human outputbool · default false

--greponly events whose record contains this substring (case-insensitive)string

--jsonemit a versioned JSON envelopebool · default false

--key-fingerprintonly events signed by this key fingerprintstring

--limitevents per pageint · default 100

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms initInitialize an Agent Comms project

Usageagent-comms init [flags]

Flags

--actoractor override (credential must match)string

--authority-urlservice authority URLstring

--daemon-endpointlocal daemon socket or named pipestring

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--moderuntime mode: personal or servicestring · default personal

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--ownerowner principal IDstring

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--service-public-keybase64 Ed25519 service public keystring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

-y, --yesconfirm initializationbool · default false

agent-comms invocationRequest and process agent invocations

Usageagent-comms invocation

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation cancelMove this invocation to cancel

Usageagent-comms invocation cancel [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--reasoncancellation reasonstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation claimClaim this invocation

Usageagent-comms invocation claim [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--runtimeclaiming runtime IDstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation completeMove this invocation to complete

Usageagent-comms invocation complete [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--result-messageresult message IDstring

--summarycompletion summarystring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation deferMark a claimed invocation as blocked and due for a later retry

Usageagent-comms invocation defer [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--idinvocation IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--reasonwhy the invocation is blockedstring

--retry-innext attempt relative to nowduration · default 0s

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation expireMove this invocation to expire

Usageagent-comms invocation expire [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--reasonexpiry reasonstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation inspectShow an invocation and its delivery evidence

Usageagent-comms invocation inspect [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--idinvocation IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation listList invocations

Usageagent-comms invocation list [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--statusfilter by statusstring

--timeouttransaction lock timeoutduration · default 10s

--tofilter by target agentstring

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation listenBlock until an invocation is delivered, optionally claiming it

Usageagent-comms invocation listen [flags]

Flags

--actoractor override (credential must match)string

--claimatomically claim a delivered invocationbool · default true

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--runtimeconnected runtime IDstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

--waitbounded listen durationduration · default 10s

agent-comms invocation nextShow the next invocation available to a runtime

Usageagent-comms invocation next [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--runtimeruntime ID used for capacity filteringstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation policyManage per-agent invocation policy

Usageagent-comms invocation policy

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation policy setSet a per-agent invocation policy

Usageagent-comms invocation policy set [flags]

Flags

--actoractor override (credential must match)string

--agenttarget agentstring

--allow-consumerallowed consumer mode (repeatable; defaults to all)stringSlice · default []

--default-consumerINTERACTIVE_ONLY, WORKER_ONLY, or EITHERstring · default EITHER

--detailsshow secondary and nested fields in human outputbool · default false

--interactive-runtimepreferred interactive runtime IDstring

--jsonemit a versioned JSON envelopebool · default false

--modeMANUAL, TRUSTED, AUTOMATIC, or DISABLEDstring · default MANUAL

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--require-human-for-sensitiverequire human approval for sensitive workbool · default true

--scopeallowed invocation scopestringSlice · default []

--timeouttransaction lock timeoutduration · default 10s

--trusted-actoractor allowed by TRUSTED modestringSlice · default []

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation policy showShow a per-agent invocation policy

Usageagent-comms invocation policy show [flags]

Flags

--actoractor override (credential must match)string

--agenttarget agentstring

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation redeliverManually re-attempt delivery of an open invocation

Usageagent-comms invocation redeliver [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--idopen invocation ID to redeliverstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--runtimespecific eligible target runtimestring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation rejectMove this invocation to reject

Usageagent-comms invocation reject [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--reasonrejection reasonstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation requestRequest an agent invocation

Usageagent-comms invocation request [flags]

Flags

--actoractor override (credential must match)string

--approval-expires-inapproval validity windowduration · default 24h0m0s

--approval-idapproval ID (generated from the invocation ID when omitted)string

--approval-reasonreason shown to the approverstring

--approval-tierORCHESTRATOR or HUMANstring · default ORCHESTRATOR

--consumerINTERACTIVE_ONLY, WORKER_ONLY, or EITHER (target policy default when omitted)string

--deadlineabsolute RFC3339 deadline (recommended for approval-bound invocations)string

--detailsshow secondary and nested fields in human outputbool · default false

--expected-resultexpected resultstring

--expires-indeadline relative to nowduration · default 0s

--idinvocation ID (auto-generated if omitted)string

--instructionbounded instruction for the target agentstring

--jsonemit a versioned JSON envelopebool · default false

--messagerelated message IDstring

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--priorityLOW, NORMAL, HIGH, or URGENTstring · default NORMAL

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--request-approvalrequest a payload-bound approval instead of invokingbool · default false

--runtimespecific target runtimestring

--scopescope required by the invocationstringSlice · default []

--taskrelated task IDstring

--timeouttransaction lock timeoutduration · default 10s

--totarget agentstring

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation resumeMove this invocation to resume

Usageagent-comms invocation resume [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--summaryprogress summarystring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms invocation startMove this invocation to start

Usageagent-comms invocation start [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--summaryprogress summarystring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms liveServe, attach to, or tail a provider's live agent sessions

Usageagent-comms live

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms live attachWatch a provider live runtime's event stream

Usageagent-comms live attach [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

--providerclaude or codexstring · default claude

-q, --quietsuppress non-essential outputbool · default false

--runtimeregistered Agent Comms runtime IDstring

--serverlive broker base URL (provider default when omitted)string

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms live serveRun a provider's local live broker

Usageagent-comms live serve [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--listenloopback listen address (provider default when omitted)string

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

--providerclaude or codexstring · default claude

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms live tailStream a Claude Code session transcript live (--provider claude only)

Usageagent-comms live tail [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--no-replayskip replaying existing history, only show new turnsbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

--project-dirClaude Code working directory for this session (defaults to the current AgentComms project root)string

--providerclaude (only)string · default claude

-q, --quietsuppress non-essential outputbool · default false

--sessionClaude session ID to watchstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms mcpServe the protocol-only MCP stdio interface

Usageagent-comms mcp

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms messagePost messages and manage recipient obligations

Usageagent-comms message

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms message ackAck this message

Usageagent-comms message ack [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms message completeMove this message to complete

Usageagent-comms message complete [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms message inboxList messages addressed to you

Usageagent-comms message inbox [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--fromfilter by senderstring

--jsonemit a versioned JSON envelopebool · default false

--limitmax results (0 = unlimited)int · default 0

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

--unreadshow only unread messagesbool · default false

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms message postPost a message to recipients

Usageagent-comms message post [flags]

Flags

--actoractor override (credential must match)string

--approval-expires-inapproval validity windowduration · default 24h0m0s

--approval-idapproval ID (generated from the message ID when omitted)string

--approval-reasonreason shown to the approverstring

--bodybodystring

--body-fileread body from file (bypasses CLI arg limits)string

--detailsshow secondary and nested fields in human outputbool · default false

--idmessage ID (auto-generated if omitted)string

--jsonemit a versioned JSON envelopebool · default false

--kindmessage kind (FYI, ACTION, CONTRACT, BLOCKER, DECISION)string · default FYI

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--request-approvalrequest a payload-bound approval instead of postingbool · default false

--subjectsubjectstring

--taskrelated taskstring

--timeouttransaction lock timeoutduration · default 10s

--torecipientstringSlice · default []

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms message rejectMove this message to reject

Usageagent-comms message reject [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms message resolveResolve this message

Usageagent-comms message resolve [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms message showShow one message by ID

Usageagent-comms message show [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms profileInspect and select local signing profiles

Usageagent-comms profile

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms profile currentShow the active signing profile

Usageagent-comms profile current

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms profile listList local signing profiles

Usageagent-comms profile list

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms profile useSelect the active signing profile

Usageagent-comms profile use [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--nameprofile namestring

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms projectInspect and maintain the initialized project

Usageagent-comms project

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms project deletePermanently delete this project's local runtime, and its remote data in service mode

Usageagent-comms project delete

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms project upgradeInspect, back up, reconcile, restart, and verify a project

Usageagent-comms project upgrade [flags]

Flags

--actoractor override (credential must match)string

--all-knownupgrade distinct projects recorded in identity profilesbool · default false

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

-y, --yesapprove confirmation-required migrationsbool · default false

agent-comms project upgrade planShow the pending project upgrade plan (plan)

Usageagent-comms project upgrade plan [flags]

Flags

--actoractor override (credential must match)string

--all-knowninspect distinct projects recorded in identity profilesbool · default false

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms project upgrade statusShow the pending project upgrade plan (status)

Usageagent-comms project upgrade status [flags]

Flags

--actoractor override (credential must match)string

--all-knowninspect distinct projects recorded in identity profilesbool · default false

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtimeManage agent runtime connectors and presence

Usageagent-comms runtime

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime bind-sessionCapture the current Claude conversation and bind it to a registered runtime

Usageagent-comms runtime bind-session [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--idruntime IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime configureUpdate a runtime connector's configuration

Usageagent-comms runtime configure [flags]

Flags

--actoractor override (credential must match)string

--capabilityruntime capabilitystringSlice · default []

--config-referencenon-secret local connector configuration referencestring

--connectorMANUAL, MCP, LOCAL_PROCESS, WEBHOOK, QUEUE, or INTERACTIVEstring · default MANUAL

--detailsshow secondary and nested fields in human outputbool · default false

--idruntime IDstring

--jsonemit a versioned JSON envelopebool · default false

--kindWORKER or INTERACTIVEstring · default WORKER

--max-concurrentmaximum concurrent invocationsint · default 1

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--scoperuntime scopestringSlice · default []

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime deleteChange this runtime's status (delete)

Usageagent-comms runtime delete [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--idruntime IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--reasonstatus-change reasonstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime drainChange this runtime's status (drain)

Usageagent-comms runtime drain [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--idruntime IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--reasonstatus-change reasonstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime heartbeatRecord a runtime presence heartbeat

Usageagent-comms runtime heartbeat [flags]

Flags

--active-invocationactive invocation IDstringSlice · default []

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--endpoint-idopaque interactive endpoint IDstring

--healthHEALTHY or DEGRADEDstring · default HEALTHY

--idruntime IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime interactive-serveOwn a real pty running <command>, dialable by other runtimes for direct invocation delivery

Usageagent-comms runtime interactive-serve --id <runtimeID> -- <command> [args...] [flags]

Flags

--actoractor override (credential must match)string

--claude-allow-agent-commswrapped command must be claude; scopes unattended Bash permission to this Agent Comms executable onlybool · default false

--detailsshow secondary and nested fields in human outputbool · default false

--idruntime IDstring

--jsonemit a versioned JSON envelopebool · default false

--launch-terminalopen a new, dedicated terminal window running this same command instead of using the current one, then exitbool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--takeover-pidgracefully terminate this PID (an existing live session for the same provider conversation) and wait for it to fully exit before starting, so resuming it with the wrapped command's own --continue/--resume flag never collides with a still-live copy; refuses if this process is itself a descendant of pid (e.g. run from an agent's own Bash tool call) -- pair with --launch-terminal insteadint · default 0

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime interactive-sessionShow whether a runtime has a live interactive-serve session

Usageagent-comms runtime interactive-session [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--idruntime IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime listList registered runtimes and their presence

Usageagent-comms runtime list

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime registerRegister an agent runtime connector

Usageagent-comms runtime register [flags]

Flags

--actoractor override (credential must match)string

--agentagent that owns the runtimestring

--capabilityruntime capabilitystringSlice · default []

--config-referencenon-secret local connector configuration referencestring

--connectorMANUAL, MCP, LOCAL_PROCESS, WEBHOOK, QUEUE, or INTERACTIVEstring · default MANUAL

--detailsshow secondary and nested fields in human outputbool · default false

--idruntime IDstring

--jsonemit a versioned JSON envelopebool · default false

--kindWORKER or INTERACTIVEstring · default WORKER

--max-concurrentmaximum concurrent invocationsint · default 1

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--scoperuntime scopestringSlice · default []

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime resumeChange this runtime's status (resume)

Usageagent-comms runtime resume [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--idruntime IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--reasonstatus-change reasonstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime revokeChange this runtime's status (revoke)

Usageagent-comms runtime revoke [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--idruntime IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--reasonstatus-change reasonstring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime sessionShow the locally captured session binding for a runtime

Usageagent-comms runtime session [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--idruntime IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime verify-adapterCheck a worker adapter's assumed CLI flags against the real installed binary's --help output

Statically scans the named adapter's own source file (adapter_<name>.go, under --source-dir) for "--flag"-shaped string literals, runs <executable> --help, and reports any assumed flag the real binary's own help output never mentions. Generalizes the manual check that caught a real bug this session -- a wrong environment variable name for agy, found by running `strings` on the installed binary by hand -- into a repeatable one for CLI flags specifically (this can't catch environment variable drift; --help never lists those). A dev-time tool: --source-dir must point at a real checkout's internal/worker directory (defaults to that path relative to the current directory, i.e. running from the repo root), not something a distributed binary carries with it.

Usageagent-comms runtime verify-adapter [flags]

Flags

--actoractor override (credential must match)string

--adapteradapter name (claude, codex, opencode)string

--detailsshow secondary and nested fields in human outputbool · default false

--executablepath to the real installed CLI binarystring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--source-dirpath to the agent-comms repo checkout's internal/worker directorystring · default internal/worker

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms runtime workerRun a governed autonomous Claude or Codex invocation worker

Usageagent-comms runtime worker [flags]

Flags

--actoractor override (credential must match)string

--adapterclaude, codex, opencode, claude-live, codex-live, opencode-live, claude-acp, opencode-acp, or codex-acpstring · default claude

--claude-allow-agent-commsallow only this Agent Comms executable as an unattended Claude Bash commandbool · default false

--claude-max-budget-usdClaude spend ceiling (per invocation for claude; per process for claude-live)float64 · default 1

--claude-permission-modeClaude permission mode without bypassstring · default acceptEdits

--codex-add-diradditional absolute writable directory for Codex (repeatable)stringSlice · default []

--codex-ignore-user-configisolate autonomous runs from user MCP and tool configurationbool · default false

--codex-sandboxCodex read-only or workspace-write sandboxstring · default workspace-write

--detailsshow secondary and nested fields in human outputbool · default false

--executableabsolute agent executable pathstring

--execution-timeoutper-invocation execution timeoutduration · default 30m0s

--idregistered runtime IDstring

--jsonemit a versioned JSON envelopebool · default false

--listen-waitbounded invocation listen durationduration · default 10s

--modelagent model overridestring

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--onceprocess at most one invocation and exitbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--session-idexisting Claude or Codex conversation UUID to resumestring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms statusShow a concise project operational summary

Usageagent-comms status

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms taskCoordinate ownership, leases, handoffs, and task lifecycle

Usageagent-comms task

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms task blockMove this task to block

Usageagent-comms task block [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--summarysummarystring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms task cancelMove this task to cancel

Usageagent-comms task cancel [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--summarysummarystring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms task claimClaim a task's scope lease, and its working-directory lock if --worktree is given

Usageagent-comms task claim [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--durationlease durationduration · default 4h0m0s

--idtask IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

--worktreeworktree path (acquires the working-directory lock)string

agent-comms task completeMove this task to complete

Usageagent-comms task complete [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--summarysummarystring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms task createCreate a tracked task

Usageagent-comms task create [flags]

Flags

--actoractor override (credential must match)string

--branchbranchstring

--detailsshow secondary and nested fields in human outputbool · default false

--external-refexternal referencestring

--idtask ID (auto-generated if omitted)string

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--repositoryrepositorystring · default local

--resourcewrite resource (repeatable; at least one required)stringSlice · default []

--riskrisk tierstring · default ROUTINE

--summarysummarystring

--timeouttransaction lock timeoutduration · default 10s

--titletitlestring

-v, --verboseshow operational metadata in human outputbool · default false

--worktreeworktree pathstring

agent-comms task handoffHand off or accept a task

Usageagent-comms task handoff [flags]

Flags

--acceptaccept pending handoffbool · default false

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--idtask IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--summaryhandoff summarystring

--timeouttransaction lock timeoutduration · default 10s

--tohandoff targetstring

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms task listList tasks

Usageagent-comms task list

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms task lockCreate and claim a minimal task in one step, to hold a working-directory lock for ad hoc work with no pre-existing task

task create requires a title, summary, repository, branch, and resource list before task claim can acquire a working-directory lock -- real ceremony for a real task, but too much for the single most common shape of work in an interactive multi-agent setup: a human directly asking a live agent to fix something, with no Task tracked yet. `task lock` creates a minimal, throwaway task (auto-generated ID, --note as its title/summary, current branch detected via git if not given) and claims it in the same call, so reaching for a lock is never more work than skipping one. Complete or cancel it like any other task when the work is done (the printed task ID is what you need).

Usageagent-comms task lock [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--durationlease durationduration · default 4h0m0s

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--notewhat you're about to do -- used as the ad hoc task's title/summarystring

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

--worktreeworktree path to lock (required)string

agent-comms task offerOffer a task to another principal

Usageagent-comms task offer [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--expires-inoffer validityduration · default 1h0m0s

--idtask IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

--toprincipalstring

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms task renewRenew this task's lease with progress

Usageagent-comms task renew [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--progressprogress summarystring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms task reviewMove this task to review

Usageagent-comms task review [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--summarysummarystring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms task showShow one task by ID

Usageagent-comms task show [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms task startMove this task to start

Usageagent-comms task start [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms task takeoverMove this task to takeover

Usageagent-comms task takeover [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--identity IDstring

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--summarysummarystring

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms tuiOpen the full-screen control room

Usageagent-comms tui

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms updateCheck for and install verified Agent Comms releases

Usageagent-comms update

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms update applyInstall a verified release and upgrade projects

Usageagent-comms update apply [flags]

Flags

--actoractor override (credential must match)string

--all-knownreconcile projects recorded in identity profilesbool · default true

--channelstable or previewstring · default stable

--current-project-onlyreconcile only the current initialized projectbool · default false

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--skip-project-upgradeinstall the binary without reconciling projectsbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

--versionexact release tagstring

-y, --yesapprove confirmation-required project migrationsbool · default false

agent-comms update checkCheck for a newer verified release

Usageagent-comms update check [flags]

Flags

--actoractor override (credential must match)string

--channelstable or previewstring · default stable

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms verifyVerify the signed project event chain

Usageagent-comms verify [flags]

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--fromfirst event sequence to verifyuint64 · default 0

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

--tolast event sequence to verify (zero means current head)uint64 · default 0

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms versionShow binary, schema, and project format versions

Usageagent-comms version

Flags

--actoractor override (credential must match)string

--detailsshow secondary and nested fields in human outputbool · default false

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false

agent-comms watchStream changes that require operator attention

Usageagent-comms watch [flags]

Flags

--actoractor override (credential must match)string

--countstop after this many changes (0 = keep watching)int · default 0

--detailsshow secondary and nested fields in human outputbool · default false

--intervalpoll intervalduration · default 30s

--jsonemit a versioned JSON envelopebool · default false

--no-colordisable ANSI colorbool · default false

--non-interactivenever promptbool · default false

--outputoutput format: human, plain, json, or jsonlstring · default human

--profileuser profile namestring

--projecttarget project rootstring

-q, --quietsuppress non-essential outputbool · default false

--timeouttransaction lock timeoutduration · default 10s

-v, --verboseshow operational metadata in human outputbool · default false