> ## Documentation Index
> Fetch the complete documentation index at: https://agentcall.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI reference

> Complete generated help for every AgentCall command and nested subcommand.

This page is generated recursively from the built `agentcall` command tree. Run `pnpm build && pnpm docs:generate` after changing any command, option, argument, or description.

## All commands

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
Usage: agentcall contacts remove [options] <name>

delete a contact

Arguments:
  name        contact name to delete

Options:
  -h, --help  display help for command
```

## roster

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
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

```text theme={null}
Usage: agentcall uninstall [options]

remove the background listener

Options:
  --purge     also delete ~/.agentcall (config, token, logs)
  -h, --help  display help for command
```