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

# Inbox

> Where Autopilot drafts land for approval. Three renderings: full view, ambient strip, dashboard widget

## What is the inbox?

The inbox is where [Gaia Autopilot](/autopilot/overview) becomes visible. It's where drafts land, the activity feed for what's run, the roster of agents in the app, and the editor for [playbooks](/autopilot/playbooks).

Every Gainable app gets an Autopilot inbox. There's nothing to install. As soon as the autopilot phase of the build runs, it appears in the app.

<Info>
  The split between Copilot and Autopilot mirrors the split between asking and acting. Copilot is the chat panel for "ask me anything." The inbox is the panel for "here's what I did, here's what I want to do, what should I send?"
</Info>

## Three renderings

The inbox shows up in three places, each tuned for a different moment in the user's day.

| Rendering            | Where it lives                                  | Best for                                |
| -------------------- | ----------------------------------------------- | --------------------------------------- |
| **Full view**        | The `/autopilot` route inside the app           | Dedicated review sessions, inbox triage |
| **Ambient strip**    | A pill in the app's chrome (top bar)            | Awareness without context-switching     |
| **Dashboard widget** | A drop-in widget alongside Chart, Kanban, Table | Mixed-use dashboards                    |

A single agent's drafts and activity show up in all three, scoped appropriately.

## Full view

The `/autopilot` route is the main UI. It has four panels:

### Inbox

The list of drafts waiting for review. For each draft:

* The originating playbook
* The objective it's working toward
* The full reasoning chain (which trigger, which records, why this draft)
* The proposed action (the email body, the Slack message, the record update)
* Approve, edit, skip, and "unsubscribe from this class" buttons

### Activity feed

A reverse-chronological log of what's run. Both auto-tier actions and approved/skipped drafts appear here. Each entry links to the corresponding [action log](/autopilot/agent-action-log) row.

### Agent roster

The agents configured in this app. For each agent:

* Its objectives
* Its playbooks
* Approval rate (used for [graduation](/autopilot/risk-tiers))
* Last run time
* Status: active, paused, error

### Playbook editor

The editor for trigger, steps, and guardrails. See [playbooks](/autopilot/playbooks) for the editor details.

## Ambient strip

The ambient strip is a small element in the app's chrome. It shows:

* A count of drafts in the user's inbox
* A pulse when a new draft arrives
* A click target that opens the inbox panel without leaving the current page

The strip is designed to be non-intrusive. It doesn't pop up modals; it doesn't interrupt typing. It tells the user "there's something to look at" and gets out of the way.

## Dashboard widget

You can drop an Autopilot widget onto any dashboard, alongside KPI cards, charts, kanban boards, and tables. The widget can be scoped:

* **Inbox.** This user's pending drafts.
* **Recent activity.** Last N actions, with quick access to detail.
* **Specific objective.** Just the work tied to one objective ("Stalled deals" only).
* **Specific playbook.** Just one playbook's drafts and activity.

```text theme={null}
Add an Autopilot widget to the sales dashboard
showing recent stalled-deal drafts.
```

```text theme={null}
Put an Autopilot inbox widget at the top of the
home page so users see pending drafts on login.
```

## Personal vs app-wide

The inbox is scoped automatically based on the agent's [scope](/autopilot/scopes):

* A **personal-scope** agent's drafts only appear in its owner's inbox.
* An **app-wide** agent's drafts appear in the inbox of whichever user is the configured owner of each draft (e.g. `deal.owner`).

Users never see drafts from other users' personal agents. They never see drafts they aren't the configured owner of.

## What the inbox is not

The inbox is not the [Copilot](/copilots/overview). The Copilot is conversational; the user types, the Copilot answers. The inbox is the proactive surface; agents act, the user reviews.

You can have both on the same page. They serve different moments.

| Copilot                                  | Autopilot inbox                             |
| ---------------------------------------- | ------------------------------------------- |
| User initiates                           | Agent initiates                             |
| Synchronous chat                         | Asynchronous inbox                          |
| Reactive                                 | Proactive                                   |
| Powered by [Copilot](/copilots/overview) | Powered by [Autopilot](/autopilot/overview) |

## Adding the inbox to a page

The full view is always at `/autopilot`. The ambient strip is part of the app chrome and on by default. The widget you add explicitly:

```text theme={null}
Add an Autopilot inbox widget to the deals dashboard.
```

```text theme={null}
Put the Autopilot activity feed on the home page,
limited to the last 10 entries.
```

## Best practices

<AccordionGroup>
  <Accordion title="Surface drafts where users already work">
    A widget on the dashboard a user opens 20 times a day beats a route they have to remember to visit.
  </Accordion>

  <Accordion title="Use the activity feed to build trust">
    Skeptical users approve faster when they can see the agent's history. The activity feed is the single best place to send them.
  </Accordion>

  <Accordion title="Pause, don't delete, when in doubt">
    If a playbook is producing drafts that don't feel right, pause it from the agent roster instead of deleting it. The history stays. You can re-enable with one click.
  </Accordion>

  <Accordion title="Tune the ambient strip count threshold">
    For users who only want to know about high-priority drafts, configure the ambient strip to count only drafts from specific objectives.
  </Accordion>
</AccordionGroup>

## Learn more

<CardGroup cols={2}>
  <Card title="Overview" icon="rocket" href="/autopilot/overview">
    What Gaia Autopilot is
  </Card>

  <Card title="Playbooks" icon="book-open" href="/autopilot/playbooks">
    The editor inside the inbox
  </Card>

  <Card title="Risk tiers" icon="shield-check" href="/autopilot/risk-tiers">
    How approve, edit, skip translates to action
  </Card>

  <Card title="Action log" icon="list" href="/autopilot/agent-action-log">
    The full audit trail
  </Card>

  <Card title="Gaia Copilot" icon="comments" href="/copilots/overview">
    The conversational counterpart
  </Card>
</CardGroup>