CLI Reference

AgentInbox uses a local control-plane CLI around agents, sources, subscriptions, inboxes, activation targets, and daemon lifecycle.

Meta Commands

Text-first commands:

agentinbox --help
agentinbox help inbox
agentinbox --version

Resource and control-plane commands return JSON by default.

Daemon

agentinbox daemon start
agentinbox daemon stop
agentinbox daemon status

Agent

agentinbox agent register [--agent-id ID] [--force-rebind]
agentinbox agent list
agentinbox agent show <agent_id>
agentinbox agent remove <agent_id>

Sources

agentinbox source add <source_type> <source_key> [--config-json ...]
agentinbox source list
agentinbox source show <source_id>
agentinbox source poll <source_id>
agentinbox source event <source_id> --native-id <id> --event <variant>

Subscriptions

agentinbox subscription add <agent_id> <source_id> [--match-json ...]
agentinbox subscription list
agentinbox subscription show <subscription_id>
agentinbox subscription lag <subscription_id>
agentinbox subscription reset <subscription_id> --start-policy latest

Inbox

Inbox commands use agentId, not inboxId.

agentinbox inbox show <agent_id>
agentinbox inbox read <agent_id>
agentinbox inbox watch <agent_id>
agentinbox inbox ack <agent_id> --through <item_id>
agentinbox inbox ack <agent_id> --item <item_id>
agentinbox inbox ack <agent_id> --all
agentinbox inbox compact <agent_id>

Maintenance

agentinbox gc
agentinbox status