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

# Headless Overview

> BossMode headless surfaces — CLI, MCP server, and REST API — for agent deployers and developers who want to wire BossMode into their own harness without the GUI.

# Headless

BossMode is headless-first. That means every action you can take in the dashboard, you can also take from:

* A terminal (the **CLI** — `@bossmode/cli`)
* An agent's tool surface (the **MCP server** — `@bossmode/mcp-server`)
* A plain HTTP call (the **REST API** — `/api/pro/*`)

All three talk to the same Convex-authoritative core. Signing up once gives you access to all three.

## Why headless

The end-user of BossMode is often an AI agent, not a human. Salesforce announced the same architecture shift at TDX 2026 ("Headless 360"). BossMode shipped with that model from day zero.

Practical implications:

* **Your agents never log into a web dashboard.** They hit the MCP tool surface or the REST API directly.
* **Your CI pipelines can manage workspaces.** Install packs, run directives, pull reports — all scriptable.
* **Multi-tenant by default.** One MCP server, many client workspaces, role-scoped tokens per tenant.

## Which surface should I use?

| You want to...                                           | Use                            |
| -------------------------------------------------------- | ------------------------------ |
| Give a directive from the terminal                       | [CLI](/headless/cli)           |
| Expose BossMode tools to Claude Code / Cursor / Continue | [MCP](/headless/mcp)           |
| Wire BossMode into a Node/Python pipeline                | [REST API](/headless/api)      |
| Receive real-time events from BossMode                   | [Webhooks](/headless/webhooks) |

## Quickstart

Sign up at [bossmode.ing/signup](https://bossmode.ing/signup), then install the CLI:

```bash theme={null}
npx @bossmode/cli@latest init --wizard
```

That one command pairs your device, registers it with your workspace, and spawns the local daemon. You're headless-ready.

## Next steps

<CardGroup cols={2}>
  <Card title="CLI" icon="terminal" href="/headless/cli">
    Install and use the `bossmode` CLI to control your workspace from the terminal or CI.
  </Card>

  <Card title="MCP Server" icon="plug" href="/headless/mcp">
    Wire BossMode tools directly into Claude Desktop, Claude Code, Cursor, or Continue.
  </Card>

  <Card title="REST API" icon="code" href="/headless/api">
    Drive BossMode programmatically from any HTTP client or your own agent framework.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/headless/webhooks">
    React to inbound AvatarCzar events and configure outbound webhook destinations.
  </Card>
</CardGroup>