most-cli — Most documentation

Search all most documentation

Usage#

usage: most-cli <command> [<arg>...] [--<option> <value>] [--<flag>] [--text]

base URL: finding the Most service: MOST_BASE_URL is not set, and no origin is assumed in its place; observed: MOST_BASE_URL is absent from the environment

commands:
  accounts    List adopted messaging sources (authenticated GET /v3/accounts).
  accounts import <source>    Atomically import supported history from one adopted source on this Most host; `messages-app` is the Messages.app adapter, another source kind is refused with the ones that exist.
  health    Service liveness: status (degraded when a declared backend is not serving), registered backends, every declared backend that is not serving with its cause, active composition (read-only GET /healthz).
  onboarding    Run or resume Most's provider-neutral first-use journey; completion requires a real provider receipt.
  location <chat_id> [--include-ended]    Where each participant of a chat last was and who is sharing their location: the newest recorded position per handle and the running shares (read-only GET /v3/chats/{chat_id}/location).
  location-history <chat_id> [--handle <value>] [--since <value>] [--limit <value>]    Every recorded position in a chat, newest first (read-only GET /v3/chats/{chat_id}/location/history).
  calls [--status <value>] [--limit <value>]    Phone calls, newest first, in both directions (read-only GET /v3/calls).
  call <call_id>    One phone call and every line spoken on it, oldest first (read-only GET /v3/calls/{call_id}).
  calls-readiness    Whether this service can make and take calls, the reason when it cannot, and the three URLs the Twilio number must call (read-only GET /v3/calls/readiness).
  webhook-outbox [--subscription-id <value>]    Webhooks a subscriber did not accept, oldest first, each with the status or transport error its last attempt was answered (read-only GET /v3/webhook-outbox). `webhook-outbox redeliver` sends them again.
  diagnostics <transport> <probe> [--filter <value>] [--max-classes <value>] [--chat-guid <value>] [--channel <value>]    Loopback read-only probe of one transport's worker: whether this installation could do what that transport needs, named rung by rung and sending nothing (read-only GET /internal/diagnostics/{transport}/{probe}). A probe the transport does not answer is the service's 404.
  calls place <to> --say <text> [--language <tag>]    Dial an E.164 number and say the text when it answers (authenticated POST /v3/calls).
  calls answer <call_id> --say <text> [--language <tag>]    Pick up a ringing inbound call and say the text (POST /v3/calls/{call_id}/answer).
  calls reject <call_id>    Decline a ringing inbound call (POST /v3/calls/{call_id}/reject).
  calls say <call_id> --say <text>    Speak on a call in progress, then listen (POST /v3/calls/{call_id}/say).
  calls hangup <call_id>    End a call, or stop one still ringing (POST /v3/calls/{call_id}/hangup).
  webhook-outbox redeliver [--subscription-id <id>]    Send every webhook a subscriber did not accept again, oldest first (authenticated POST /v3/webhook-outbox/redeliver); events still kept afterwards fail the command.
  errors list [--markdown]    Every functionality of most-cli and most-mcp with every way it can fail.
  errors show <functionality> [--markdown]    One functionality's causes: what failed, why, what is shown, the fix, the code, the exit status and the test.

Every answer is the server's JSON; --text prints it as key: value lines. A refusal goes to stderr as the failure envelope (with --text: what failed, the fix and the cause) and exits 2 for a wrong invocation, 69 when sending the same thing again can help, and 1 otherwise.

Pages#

`most-cli health` — Service liveness: status (degraded when a declared backend is not serving), registered backends, every declared backend that is not serving with its cause, active composition (read-only GET /healthz). (/docs/cli/health)
`most-cli onboarding` — Run or resume Most's provider-neutral first-use journey; completion requires a real provider receipt. (/docs/cli/onboarding)
`most-cli location` — The Most conversation whose participants' positions and location shares to read. (/docs/cli/location)
`most-cli location-history` — The Most conversation whose recorded positions to list. (/docs/cli/location-history)
`most-cli calls` — Only calls in this status: queued, ringing, in_progress, completed, busy, no_answer, failed, canceled, rejected or missed. (/docs/cli/calls)
`most-cli call` — The Most call to read. (/docs/cli/call)
`most-cli calls-readiness` — Whether this service can make and take calls, the reason when it cannot, and the three URLs the Twilio number must call (read-only GET /v3/calls/readiness). (/docs/cli/calls-readiness)
`most-cli webhook-outbox` — Only the events of this webhook subscription. (/docs/cli/webhook-outbox)
`most-cli diagnostics` — The transport whose worker answers: the iMessage worker is `imessage`, the Twilio text path is `sms`. (/docs/cli/diagnostics)
`most-cli calls place` — Dial an E.164 number and say the text when it answers (authenticated POST /v3/calls). (/docs/cli/calls-place)
`most-cli calls answer` — Pick up a ringing inbound call and say the text (POST /v3/calls/{call_id}/answer). (/docs/cli/calls-answer)
`most-cli calls reject` — Decline a ringing inbound call (POST /v3/calls/{call_id}/reject). (/docs/cli/calls-reject)
`most-cli calls say` — Speak on a call in progress, then listen (POST /v3/calls/{call_id}/say). (/docs/cli/calls-say)
`most-cli calls hangup` — End a call, or stop one still ringing (POST /v3/calls/{call_id}/hangup). (/docs/cli/calls-hangup)
`most-cli accounts` — List adopted messaging sources (authenticated GET /v3/accounts). (/docs/cli/accounts)
`most-cli accounts import` — Atomically import supported history from one adopted source on this Most host; `messages-app` is the Messages.app adapter, another source kind is refused with the ones that exist. (/docs/cli/accounts-import)
`most-cli webhook-outbox redeliver` — Send every webhook a subscriber did not accept again, oldest first (authenticated POST /v3/webhook-outbox/redeliver); events still kept afterwards fail the command. (/docs/cli/webhook-outbox-redeliver)
`most-cli errors list` — Every functionality of most-cli and most-mcp with every way it can fail. (/docs/cli/errors-list)
`most-cli errors show` — One functionality's causes: what failed, why, what is shown, the fix, the code, the exit status and the test. (/docs/cli/errors-show)
`most-cli service` — Send one request to the Most service MOST_BASE_URL names, with the bearer MOST_AGENT_API_TOKEN holds, and read its answer. (/docs/cli/service)
`most-cli reads` — Read one allow-listed, product-safe GET from the Most service: health, first use, locations, calls, the webhook outbox and the transport probes. (/docs/cli/reads)
`most-mcp` — Serve the read-only MCP tools over stdio: one JSON-RPC request per line on stdin, one answer per line on stdout. (/docs/cli/most-mcp)
`most-cli errors` — List every functionality of most-cli and most-mcp with every way it can fail, or show one functionality's causes. (/docs/cli/errors)