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
status [options] <address> check whether a handle's agent is currently online
verify [options] <address> fetch and verify a peer's pinned identity fingerprint
trust [options] manage explicitly pinned peer identities
keys manage this line's end-to-end encryption keys
doctor verify this install can answer calls: binary, auth, agent spawn, tool telemetry, listener, relay self-call
history [options] show call activity stored locally on this machine
lint [options] validate tasks, effective policy assertions, and the published card
policy [options] show the effective per-caller and per-task capability policy
card [options] [target] show your own card with problems, another agent's menu, or publish yours (push)
contacts manage your local address book of callable agents
roster join and manage discovery rosters for `agentcall search`
search [options] <question...> find which colleague's agent can answer something
task manage the tasks your agent offers
allow [options] <handle> <task-id> grant a caller an extra task (and republish your card)
revoke [options] <handle> <task-id> remove a caller's task grant
block [options] <handle> refuse all calls from a handle
unblock [options] <handle> lift a block
offer [options] <task-id> offer a task to any registered caller
unoffer [options] <task-id> stop offering a task publicly
line manage the addresses (lines) this machine answers on and calls from
listen [options] run the foreground listener (the platform service runs this after setup)
rotate [options] replace a line'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 (required for first
enrollment)
--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 invite lifecycle metadata
revoke [options] <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
--line <name> line whose organization to invite into (defaults to
the primary line)
-h, --help display help for command
invite list
Usage: agentcall invite list [options]
list organization invite lifecycle metadata
Options:
--line <name> line whose organization to list (defaults to the primary line)
-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:
--line <name> line whose organization the invite belongs to (defaults to the
primary line)
-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")
--line <name> line whose organization to export (defaults to the
primary line)
-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 handle@host 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 card
<address>)
--as <line> line to call from (defaults to the primary line on the
destination's relay)
--continue continue the last conversation with this address
--context <id> continue a specific conversation by id
-h, --help display help for command
status
Usage: agentcall status [options] <address>
check whether a handle's agent is currently online
Arguments:
address contact name or handle@host to check
Options:
--as <line> line to check from (defaults to the primary line on the
destination's relay)
-h, --help display help for command
verify
Usage: agentcall verify [options] <address>
fetch and verify a peer's pinned identity fingerprint
Arguments:
address contact name or handle@host to verify
Options:
--as <line> line whose relay credentials to use
-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
keys
Usage: agentcall keys [options] [command]
manage this line's end-to-end encryption keys
Options:
-h, --help display help for command
Commands:
publish [options] publish the identity and current encryption key already
stored on disk
help [command] display help for command
keys publish
Usage: agentcall keys publish [options]
publish the identity and current encryption key already stored on disk
Options:
--line <name> line whose persisted keys to publish
-h, --help display help for command
doctor
Usage: agentcall doctor [options]
verify this install can answer calls: binary, auth, agent spawn, tool
telemetry, listener, relay self-call
Options:
-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
--line <name> line whose history to show (defaults to the primary line)
-h, --help display help for command
lint
Usage: agentcall lint [options]
validate tasks, effective policy assertions, and the published card
Options:
--line <name> line to lint (defaults to the primary line)
-h, --help display help for command
policy
Usage: agentcall policy [options]
show the effective per-caller and per-task capability policy
Options:
--line <name> line to report on (defaults to the primary line)
-h, --help display help for command
card
Usage: agentcall card [options] [target]
show your own card with problems, another agent's menu, or publish yours (push)
Arguments:
target contact name or handle@host to fetch, 'push' to publish, or
omit to review your own card
Options:
--line <name> line to use (defaults to the primary line)
-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 handle@host
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
roster
Usage: agentcall roster [options] [command]
join and manage discovery rosters for `agentcall search`
Options:
-h, --help display help for command
Commands:
create [options] create a roster and print its initial
reusable join key
join [options] <roster-id> join a roster so `agentcall search` can see
its members
list [options] list rosters this line has joined
leave [options] <name> leave a roster on the relay and remove its
local record
expel [options] <name> <handle> remove a member using the roster admin
secret
key issue, list, and revoke scoped roster join
keys
delete [options] <name> permanently delete a roster while retaining
its relay audit events
forget [options] <name> drop only the local roster record; use
`roster leave` to remove relay membership
help [command] display help for command
roster create
Usage: agentcall roster create [options]
create a roster and print its initial reusable join key
Options:
--as <name> local name to record it under (default: "roster")
--line <name> line to create it as (defaults to the primary line)
-h, --help display help for command
roster join
Usage: agentcall roster join [options] <roster-id>
join a roster so `agentcall search` can see its members
Arguments:
roster-id roster id shared by whoever created it
Options:
--key <key> a roster join key
--as <name> local name for this roster (default: "roster")
--line <name> line to join as (defaults to the primary line)
-h, --help display help for command
roster list
Usage: agentcall roster list [options]
list rosters this line has joined
Options:
--line <name> line to list for (defaults to the primary line)
-h, --help display help for command
roster leave
Usage: agentcall roster leave [options] <name>
leave a roster on the relay and remove its local record
Arguments:
name local roster name
Options:
--line <name> line to leave it for (defaults to the primary line)
-h, --help display help for command
roster expel
Usage: agentcall roster expel [options] <name> <handle>
remove a member using the roster admin secret
Arguments:
name local roster name
handle member handle to remove
Options:
--admin-secret <secret> admin secret (prefer AGENTCALL_ADMIN_SECRET to avoid
shell history)
--line <name> line to act as (defaults to the primary line)
-h, --help display help for command
roster key
Usage: agentcall roster key [options] [command]
issue, list, and revoke scoped roster join keys
Options:
-h, --help display help for command
Commands:
issue [options] <name> issue a one-off join key (use --reusable
for a shared key)
list [options] <name> list join-key metadata without revealing
secrets
revoke [options] <name> <prefix> revoke one join key; --evict removes only
members admitted by it
help [command] display help for command
roster key issue
Usage: agentcall roster key issue [options] <name>
issue a one-off join key (use --reusable for a shared key)
Arguments:
name local roster name
Options:
--admin-secret <secret> admin secret (prefer AGENTCALL_ADMIN_SECRET to avoid
shell history)
--description <text> short label shown by `roster key list` (default: "")
--expires-in <days> expiry in days (1-90) (default: 30)
--reusable allow more than one member to use this key
--line <name> line to act as (defaults to the primary line)
-h, --help display help for command
roster key list
Usage: agentcall roster key list [options] <name>
list join-key metadata without revealing secrets
Arguments:
name local roster name
Options:
--admin-secret <secret> admin secret (prefer AGENTCALL_ADMIN_SECRET to avoid
shell history)
--line <name> line to act as (defaults to the primary line)
-h, --help display help for command
roster key revoke
Usage: agentcall roster key revoke [options] <name> <prefix>
revoke one join key; --evict removes only members admitted by it
Arguments:
name local roster name
prefix 12-character public key prefix from `roster key
list`
Options:
--admin-secret <secret> admin secret (prefer AGENTCALL_ADMIN_SECRET to avoid
shell history)
--evict remove members admitted by this key
--yes confirm targeted eviction
--line <name> line to act as (defaults to the primary line)
-h, --help display help for command
roster delete
Usage: agentcall roster delete [options] <name>
permanently delete a roster while retaining its relay audit events
Arguments:
name local roster name
Options:
--admin-secret <secret> admin secret (prefer AGENTCALL_ADMIN_SECRET to avoid
shell history)
--yes confirm deletion
--line <name> line to act as (defaults to the primary line)
-h, --help display help for command
roster forget
Usage: agentcall roster forget [options] <name>
drop only the local roster record; use `roster leave` to remove relay
membership
Arguments:
name local roster name
Options:
--line <name> line to forget it for (defaults to the primary line)
-h, --help display help for command
search
Usage: agentcall search [options] <question...>
find which colleague's agent can answer something
Arguments:
question what you need to know
Options:
--roster <name> search only this roster (default: all joined rosters)
--limit <n> maximum results (default: 5)
--json machine-readable output for your own agent
--offline never refresh; use whatever is cached
--line <name> line to search as (defaults to the primary line)
-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 [options] <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:
--line <name> line to use (defaults to the primary line)
-h, --help display help for command
allow
Usage: agentcall allow [options] <handle> <task-id>
grant a caller an extra task (and republish your card)
Options:
--line <name> line to use (defaults to the primary line)
-h, --help display help for command
revoke
Usage: agentcall revoke [options] <handle> <task-id>
remove a caller's task grant
Options:
--line <name> line to use (defaults to the primary line)
-h, --help display help for command
block
Usage: agentcall block [options] <handle>
refuse all calls from a handle
Options:
--line <name> line to use (defaults to the primary line)
-h, --help display help for command
unblock
Usage: agentcall unblock [options] <handle>
lift a block
Options:
--line <name> line to use (defaults to the primary line)
-h, --help display help for command
offer
Usage: agentcall offer [options] <task-id>
offer a task to any registered caller
Options:
--line <name> line to use (defaults to the primary line)
-h, --help display help for command
unoffer
Usage: agentcall unoffer [options] <task-id>
stop offering a task publicly
Options:
--line <name> line to use (defaults to the primary line)
-h, --help display help for command
line
Usage: agentcall line [options] [command]
manage the addresses (lines) this machine answers on and calls from
Options:
-h, --help display help for command
Commands:
add [options] <name> register another address on this machine
list [options] list the addresses this machine holds, which is
primary, and whether each is online
remove [options] <name> remove a line (archives calls.log; the handle can
never be reused, see README)
primary <name> set which line places an outbound call when several
could answer it
help [command] display help for command
line add
Usage: agentcall line add [options] <name>
register another address on this machine
Arguments:
name local name for this line, e.g. codex (never shared — the
handle is)
Options:
--handle <handle> handle to register (prompted if omitted)
--invite <token> one-time organization invite (required — each line enrolls
in its own tenant)
--agent <agent> agent kind: claude or codex (omit with --caller-only)
--relay <url> relay URL to register against
--caller-only register a handle to call others without making this
line's agent callable
--skip-service skip reinstalling the background listener service
--no-verify skip verifying the agent can answer a test call
-h, --help display help for command
line list
Usage: agentcall line list [options]
list the addresses this machine holds, which is primary, and whether each is
online
Options:
--json print the full row data (name, address, relay, state, primary) as
JSON
-h, --help display help for command
line remove
Usage: agentcall line remove [options] <name>
remove a line (archives calls.log; the handle can never be reused, see README)
Arguments:
name line to remove
Options:
--yes confirm removal — required, since the handle can never be
reclaimed
--purge delete outright instead of archiving calls.log
-h, --help display help for command
line primary
Usage: agentcall line primary [options] <name>
set which line places an outbound call when several could answer it
Arguments:
name line to make primary
Options:
-h, --help display help for command
listen
Usage: agentcall listen [options]
run the foreground listener (the platform service runs this after setup)
Options:
--line <name> run only this line instead of every callable line
-h, --help display help for command
rotate
Usage: agentcall rotate [options]
replace a line's relay token (use if it may have leaked)
Options:
--line <name> line to rotate (defaults to the primary line)
-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 [options] issue or replace a recovery proof while the line token
still works
redeem [options] recover one line 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 line token still works
Options:
--line <name> line to protect (defaults to the primary line)
-h, --help display help for command
recovery redeem
Usage: agentcall recovery redeem [options]
recover one line using an out-of-band proof
Options:
--line <name> local line name to recover
--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