Agent Inbox CLI reference

early-access

Commands and configuration for the remote Agent Inbox CLI.

Usage: agent-inbox <command>

Category: agents

Agent Inbox CLI reference

agent-inbox is the remote client for the hosted or self-hosted Agent Inbox HTTP API.

Commands

agent-inbox login
agent-inbox inboxes
agent-inbox webhooks list --inbox <owner/domain|id>
agent-inbox webhooks add  --inbox <owner/domain|id> --url URL [--match PATTERN]
agent-inbox webhooks rm   --inbox <owner/domain|id> <webhookId>
agent-inbox webhooks test --inbox <owner/domain|id> <webhookId>
agent-inbox version

--match accepts *, an exact local part such as orders, or a prefix such as support-*.

Environment variables

Variable	Default	Purpose
`AGENT_INBOX_SERVER`	`https://inbox.agentics.dk`	Inbox API base URL
`AGENT_INBOX_ISSUER`	Agentics realm	OIDC issuer
`AGENT_INBOX_CLIENT_ID`	`agentics-inbox-desktop`	OIDC public client
`AGENT_INBOX_HOME`	`~/.agent-inbox`	Credential and configuration directory
`USE_ASPIRE`	unset	Use the local Aspire credential home when set to `1`, `true`, `yes`, or `on`

To target a self-hosted instance:

AGENT_INBOX_SERVER=https://inbox.example.com agent-inbox login

The selected server, issuer, and client ID are retained with the login. Environment variables override retained values.

Webhook signature

The secret returned by webhooks add is displayed once. A receiver must calculate HMAC-SHA256 over the raw body and compare it with:

X-Inbox-Signature: sha256=<hex-digest>

Use webhooks test to validate connectivity and signature handling before relying on live email events.