# CLI Reference

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

## Meta Commands

Text-first commands:

```bash
agentinbox --help
agentinbox help inbox
agentinbox --version
```

Resource and control-plane commands return JSON by default.

## Daemon

```bash
agentinbox daemon start
agentinbox daemon stop
agentinbox daemon status
```

## Agent

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

## Sources

```bash
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

```bash
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`.

```bash
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

```bash
agentinbox gc
agentinbox status
```