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

# Claude Code Plugin

> Run your Outbox agency from the terminal — just talk to Claude

## Outbox CLI for Claude Code

Run your Outbox agency from the terminal. Build agents, ship workflows, audit calls, triage conversations, and pull reports — all by just talking to Claude.

A Claude Code plugin for Outbox agency operators and their teams.

<Card title="View on GitHub" icon="github" href="https://github.com/Outbox-Solutions/outbox-claude-plugin">
  github.com/Outbox-Solutions/outbox-claude-plugin
</Card>

## What you can do

Once installed, just ask in plain English:

> Create a new outbound sales agent for Acme Roofing — friendly, qualifies budget and timeline, books a 15-min discovery call.

> Add 500 contacts with a phone number that haven't been called yet in the Husband Realty account to the AI Reactivation Sequence workflow.

> Show me last week's report for Beta Dental.

> The booking agent on Gamma Plumbing keeps failing on price objections. Pull the last 30 calls and tell me what to fix.

> What conversations need my attention right now?

> Switch me over to Delta Roofing.

Or use slash commands directly when you want a specific, repeatable output format.

### The campaign command

The headline feature: **`/outbox-cli:outbox-campaign`** is an interactive campaign builder. It filters contacts in the active client (tags, custom fields, last-activity date, has-phone, etc.), previews the matches, and enrolls them into a workflow in batches.

Use it for reactivation pushes, follow-up sequences, segment-specific outreach — anything where you'd otherwise be exporting CSVs and importing into the workflow UI.

## Get set up (under 2 minutes)

<Steps>
  <Step title="Open a terminal">
    On Mac, open **Terminal** (it's already installed) or download
    [Warp](https://www.warp.dev) for a nicer experience. On Windows, install
    [Warp](https://www.warp.dev) or use WSL.
  </Step>

  <Step title="Install Claude Code">
    If you don't have it yet, follow the install steps at
    [claude.com/claude-code](https://claude.com/claude-code). Then launch it
    by typing `claude` in your terminal.
  </Step>

  <Step title="Run these three commands inside Claude Code">
    ```
    /plugin marketplace add Outbox-Solutions/outbox-claude-plugin
    /plugin install outbox-cli@outbox
    /outbox-cli:outbox-setup
    ```

    The setup command walks you through signing in with your Outbox email and
    password, picking which client to start in (if you're an agency
    operator), and gives you a 30-second tour of the most useful commands.

    That's it — you're ready to go.
  </Step>
</Steps>

## Slash commands

All commands are namespaced under `/outbox-cli:` so they won't collide with Claude Code built-ins or other plugins.

### Auth + context

| Command                                | What it does                                                |
| -------------------------------------- | ----------------------------------------------------------- |
| `/outbox-cli:outbox-setup`             | First-run guided setup — sign in, pick a client, quick tour |
| `/outbox-cli:outbox-sign-in`           | Sign in with email + password                               |
| `/outbox-cli:outbox-sign-out`          | Sign out of Outbox                                          |
| `/outbox-cli:outbox-whoami`            | Show current context — active client, agency                |
| `/outbox-cli:outbox-clients`           | List every client your account can access                   |
| `/outbox-cli:outbox-use-client <name>` | Switch the active client                                    |

### Agents

| Command                                     | What it does                                                 |
| ------------------------------------------- | ------------------------------------------------------------ |
| `/outbox-cli:outbox-agents`                 | List agents in the active client                             |
| `/outbox-cli:outbox-agent <id>`             | View a single agent — config, prompt, tools, recent activity |
| `/outbox-cli:outbox-create-agent`           | Interactive new-agent scaffold                               |
| `/outbox-cli:outbox-edit-agent <id>`        | Interactive prompt/config edit                               |
| `/outbox-cli:outbox-attach-tool <agent-id>` | Attach tools from the platform library                       |
| `/outbox-cli:outbox-clone-agent <id>`       | Pull an agent's config to local files for editing            |
| `/outbox-cli:outbox-push-agent`             | Push local edits back to Outbox                              |

### Workflows + campaigns

| Command                                 | What it does                                     |
| --------------------------------------- | ------------------------------------------------ |
| `/outbox-cli:outbox-workflows`          | List workflows                                   |
| `/outbox-cli:outbox-workflow <id>`      | View a workflow — structure + recent enrollments |
| `/outbox-cli:outbox-create-workflow`    | Interactive new-workflow scaffold                |
| `/outbox-cli:outbox-edit-workflow <id>` | Interactive workflow edit                        |
| `/outbox-cli:outbox-campaign`           | Filter contacts and enroll them into a workflow  |

### Logs + debugging

| Command                                        | What it does                                      |
| ---------------------------------------------- | ------------------------------------------------- |
| `/outbox-cli:outbox-calls`                     | Recent voice calls (filter by agent, period)      |
| `/outbox-cli:outbox-call <id>`                 | Single call: full transcript, tool calls, summary |
| `/outbox-cli:outbox-chats`                     | Recent chats (filter by agent, period)            |
| `/outbox-cli:outbox-chat <id>`                 | Single chat: full message history                 |
| `/outbox-cli:outbox-conversations [search]`    | Search messages across the active client          |
| `/outbox-cli:outbox-enrollments [workflow-id]` | Workflow enrollment history + execution log       |
| `/outbox-cli:outbox-tool-runs`                 | Recent tool executions                            |

### Resources

| Command                      | What it does       |
| ---------------------------- | ------------------ |
| `/outbox-cli:outbox-senders` | List email senders |
| `/outbox-cli:outbox-phones`  | List phone numbers |

## Skills (auto-trigger)

Claude triggers these automatically when you describe what you want — no need to remember a command name.

| Skill                  | Triggers on                                                                  |
| ---------------------- | ---------------------------------------------------------------------------- |
| `optimize-agent`       | "improve this agent", "calls keep failing", "audit performance"              |
| `build-report`         | "give me a weekly report", "how did we do this month", "summarize last week" |
| `triage-conversations` | "what needs my attention", "any unread", "anything stuck"                    |

## For agency operators

If your account is an agency account, signing in gives you access to every client company under your agency. Switch between them at any time:

```
/outbox-cli:outbox-use-client acme
```

The selection persists across Claude Code restarts and is keyed to your sign-in (so two teammates in the same agency don't step on each other's active client).

### Recommended workflow

Keep a folder per client on your machine:

```
~/clients/
  acme/
  beta-dental/
  gamma-plumbing/
```

`cd` into a client's folder before launching Claude Code, then run `/outbox-cli:outbox-use-client` once to set the context. After that, the client stays active for that session.

## Built-in docs lookup

The plugin also wires Claude Code into the official Outbox docs. Ask any "how do I…" or "what does X mean" question and Claude searches the docs automatically.

> what's the difference between an agency key and a company key?

> how do I set up a voice mailbox?

> what does "concurrent call limit" mean?

## Troubleshooting

<AccordionGroup>
  <Accordion title="&#x22;You're not signed in&#x22; after signing in" icon="key">
    Run `/reload-plugins` inside Claude Code. The plugin needs a quick reload
    to pick up your fresh sign-in.
  </Accordion>

  <Accordion title="&#x22;Plugin not found in any marketplace&#x22;" icon="circle-question">
    Make sure you're using the qualified install command:

    ```
    /plugin install outbox-cli@outbox
    ```

    Not just `/plugin install outbox-cli`.
  </Accordion>

  <Accordion title="Slash commands aren't appearing" icon="list">
    Run `/reload-plugins` once, then type `/outbox-cli:` and you'll see the
    full list in the autocomplete picker.
  </Accordion>

  <Accordion title="&#x22;Token is invalid&#x22; or you keep getting signed out" icon="rotate">
    Your session expired or was revoked. Just run
    `/outbox-cli:outbox-sign-in` again to sign back in.
  </Accordion>

  <Accordion title="Something else broken?" icon="life-ring">
    Open an issue on the [plugin
    repo](https://github.com/Outbox-Solutions/outbox-claude-plugin/issues) or
    ask your Outbox contact.
  </Accordion>
</AccordionGroup>

## Related

* [MCP Server](/mcp-server) — connect any MCP-compatible client (Claude Desktop, Cursor, etc.)
* [JavaScript SDK](/javascript-sdk) — call the Outbox API from Node and the browser