agentcall command tree. Run pnpm build && pnpm docs:generate after changing any command, option, argument, or description.
All commands
Usage: agentcall [options] [command]
Call other people's coding agents
Options:
-V, --version output the version number
-h, --help display help for command
Commands:
setup [options] enroll with an organization invite, configure your agent, and install the background listener
invite manage one-time organization invites
audit export organization audit evidence
call [options] <address> <message...> call another handle's agent with a message and print its reply
jobs retrieve and cancel durable calls
inspect [options] <address> inspect one peer's address, trust state, availability, and offered tasks
trust [options] manage explicitly pinned peer identities
admin explicit remote publication operations
doctor [options] read-only diagnostics for tasks, policy, publication, recovery, listener, and runtime health
history [options] show call activity stored locally on this machine
contacts manage your local address book of callable agents
task manage the tasks your agent offers
access [options] set default access or durable offline delivery (and republish your card)
block <handle> refuse all calls from a handle
unblock <handle> lift a block
listen run the foreground listener (the platform service runs this after setup)
rotate replace this installation's relay token (use if it may have leaked)
recovery manage the out-of-band identity recovery proof
uninstall [options] remove the background listener
help [command] display help for command
setup
Usage: agentcall setup [options]
enroll with an organization invite, configure your agent, and install the
background listener
Options:
--invite <token> one-time organization invite (prompted if omitted; also
read from AGENTCALL_INVITE)
--handle <handle> handle to register (prompted if omitted)
--agent <agent> agent kind: claude or codex (auto-detected if omitted)
--relay <url> relay URL to register against
--no-snippet skip appending the agentcall usage snippet to
CLAUDE.md/AGENTS.md
--skip-service skip installing the background listener service
--caller-only register a handle to call others without making your own
agent callable
--no-verify skip verifying the agent can answer a test call
-h, --help display help for command
invite
Usage: agentcall invite [options] [command]
manage one-time organization invites
Options:
-h, --help display help for command
Commands:
create [options] create a one-time invite
list [options] list organization invites: state, role, expiry, and the ID
to revoke
revoke <id> revoke an unused organization invite
help [command] display help for command
invite create
Usage: agentcall invite create [options]
create a one-time invite
Options:
--description <text> purpose shown in the organization invite inventory
(default: "")
--expires-in-days <days> expiry from 1 to 90 days (default: "7")
--role <role> enrolled organization role: member or admin
-h, --help display help for command
invite list
Usage: agentcall invite list [options]
list organization invites: state, role, expiry, and the ID to revoke
Options:
--json print the raw invite array
-h, --help display help for command
invite revoke
Usage: agentcall invite revoke [options] <id>
revoke an unused organization invite
Arguments:
id 64-character invite ID from `agentcall invite list`
Options:
-h, --help display help for command
audit
Usage: agentcall audit [options] [command]
export organization audit evidence
Options:
-h, --help display help for command
Commands:
export [options] stream an administrator-only snapshot as NDJSON or CSV
help [command] display help for command
audit export
Usage: agentcall audit export [options]
stream an administrator-only snapshot as NDJSON or CSV
Options:
--after <time> include events at or after this epoch-millisecond or ISO
timestamp
--before <time> include events before this epoch-millisecond or ISO
timestamp
--actor <actor> include events whose actor field exactly matches
--event <event> include events whose event type exactly matches
--ip <address> include events whose source IP exactly matches
--format <format> output format: ndjson or csv (default: "ndjson")
--page-size <count> events fetched per relay page, from 1 to 500 (default:
"100")
-h, --help display help for command
call
Usage: agentcall call [options] <address> <message...>
call another handle's agent with a message and print its reply
Arguments:
address contact name or @org/handle to call
message message to send
Options:
--json print the full reply envelope instead of just the text
--task <id> task from the callee's card to perform (see: agentcall
inspect <address>)
--continue continue the open conversation with this address (add --task
when several are open)
--context <id> continue a specific conversation by id
-h, --help display help for command
jobs
Usage: agentcall jobs [options] [command]
retrieve and cancel durable calls
Options:
-h, --help display help for command
Commands:
list [options] <address>
get [options] <address> <task-id>
cancel [options] <address> <task-id>
help [command] display help for command
jobs list
Usage: agentcall jobs list [options] <address>
Arguments:
address contact name or @org/handle
Options:
--state <state> A2A task state
--json print machine-readable JSON
-h, --help display help for command
jobs get
Usage: agentcall jobs get [options] <address> <task-id>
Arguments:
address contact name or @org/handle
task-id durable task id
Options:
--wait <seconds> wait up to this many seconds for a terminal result
(default: "0")
--json print machine-readable JSON
-h, --help display help for command
jobs cancel
Usage: agentcall jobs cancel [options] <address> <task-id>
Arguments:
address contact name or @org/handle
task-id durable task id
Options:
--json print machine-readable JSON
-h, --help display help for command
inspect
Usage: agentcall inspect [options] <address>
inspect one peer's address, trust state, availability, and offered tasks
Arguments:
address contact name or @org/handle
Options:
--json print the structured inspection result
-h, --help display help for command
trust
Usage: agentcall trust [options]
manage explicitly pinned peer identities
Options:
--reset <address> remove one pin after verifying a key change out of band
-h, --help display help for command
admin
Usage: agentcall admin [options] [command]
explicit remote publication operations
Options:
-h, --help display help for command
Commands:
card administer this installation's published card
keys administer this installation's published keys
help [command] display help for command
admin card
Usage: agentcall admin card [options] [command]
administer this installation's published card
Options:
-h, --help display help for command
Commands:
publish publish the current local card to the relay
help [command] display help for command
admin card publish
Usage: agentcall admin card publish [options]
publish the current local card to the relay
Options:
-h, --help display help for command
admin keys
Usage: agentcall admin keys [options] [command]
administer this installation's published keys
Options:
-h, --help display help for command
Commands:
publish publish the identity and current encryption key already
stored on disk
help [command] display help for command
admin keys publish
Usage: agentcall admin keys publish [options]
publish the identity and current encryption key already stored on disk
Options:
-h, --help display help for command
doctor
Usage: agentcall doctor [options]
read-only diagnostics for tasks, policy, publication, recovery, listener, and
runtime health
Options:
--json emit the structured diagnostic report as JSON
-h, --help display help for command
history
Usage: agentcall history [options]
show call activity stored locally on this machine
Options:
--limit <count> maximum newest calls to show (1-100) (default: "20")
--flagged show only calls with objective local abuse signals
--json print machine-readable local history
-h, --help display help for command
contacts
Usage: agentcall contacts [options] [command]
manage your local address book of callable agents
Options:
-h, --help display help for command
Commands:
add [options] <name> <address> save (or update) a contact so you can call
them by name
list [options] list saved contacts (name, address, who they
are)
remove <name> delete a contact
help [command] display help for command
contacts add
Usage: agentcall contacts add [options] <name> <address>
save (or update) a contact so you can call them by name
Arguments:
name short name to call them by (no @)
address their @org/handle
Options:
--note <note> who they are and what to ask them about
-h, --help display help for command
contacts list
Usage: agentcall contacts list [options]
list saved contacts (name, address, who they are)
Options:
--json print the raw contacts array
-h, --help display help for command
contacts remove
Usage: agentcall contacts remove [options] <name>
delete a contact
Arguments:
name contact name to delete
Options:
-h, --help display help for command
task
Usage: agentcall task [options] [command]
manage the tasks your agent offers
Options:
-h, --help display help for command
Commands:
new <id> scaffold a new task (does not publish it)
help [command] display help for command
task new
Usage: agentcall task new [options] <id>
scaffold a new task (does not publish it)
Arguments:
id task id: lowercase kebab-case, becomes the directory name
Options:
-h, --help display help for command
access
Usage: agentcall access [options]
set default access or durable offline delivery (and republish your card)
Options:
--default <access> allowed or blocked
--offline <state> enabled or disabled
-h, --help display help for command
block
Usage: agentcall block [options] <handle>
refuse all calls from a handle
Options:
-h, --help display help for command
unblock
Usage: agentcall unblock [options] <handle>
lift a block
Options:
-h, --help display help for command
listen
Usage: agentcall listen [options]
run the foreground listener (the platform service runs this after setup)
Options:
-h, --help display help for command
rotate
Usage: agentcall rotate [options]
replace this installation's relay token (use if it may have leaked)
Options:
-h, --help display help for command
recovery
Usage: agentcall recovery [options] [command]
manage the out-of-band identity recovery proof
Options:
-h, --help display help for command
Commands:
issue issue or replace a recovery proof while the token still
works
redeem [options] recover this installation using an out-of-band proof
help [command] display help for command
recovery issue
Usage: agentcall recovery issue [options]
issue or replace a recovery proof while the token still works
Options:
-h, --help display help for command
recovery redeem
Usage: agentcall recovery redeem [options]
recover this installation using an out-of-band proof
Options:
--org <org> organization (required when local config is missing)
--handle <handle> handle (required when local config is missing)
--relay <url> relay URL (required when local config is missing)
--generation <number> generation recorded with the current proof
--resume resume the exact pending recovery after a lost
response
-h, --help display help for command
uninstall
Usage: agentcall uninstall [options]
remove the background listener
Options:
--purge also delete ~/.agentcall (config, token, logs)
-h, --help display help for command