> ## 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.

# Installation

> Download BossMode, run it locally in under three minutes, and upgrade to cloud sync when you're ready.

## Prerequisites

* Node.js v20.17.0 or higher
* npm or pnpm
* A Claude Pro or ChatGPT Plus subscription (for local inference on Path B)

## Path A — Browser (recommended for new users)

BossMode's cockpit runs in your browser. One command seeds the local SQLite brain and opens the workspace.

<Steps>
  <Step title="Install and initialize">
    ```bash theme={null}
    npx @bossmode/cli init
    ```

    This seeds the local SQLite brain, starts the GUI in detached mode, and opens the cockpit in your browser at `localhost:5173/app`.

    No email, token, or cloud dependency required for free local mode.
  </Step>

  <Step title="Open BossMode from any terminal">
    After global install, the everyday command is:

    ```bash theme={null}
    bossmode
    ```

    Bare `bossmode` starts the local daemon if needed and opens the operator TUI. The browser cockpit is still available with:

    ```bash theme={null}
    bossmode start
    ```
  </Step>

  <Step title="Run the setup wizard (optional)">
    ```bash theme={null}
    npx @bossmode/cli init --wizard
    ```

    The wizard walks you through setting business context, adding your first buyer profile, and queuing your first directive.
  </Step>
</Steps>

## Path B — Cloud workspace

Connect to `bossmode.ing/app` for multi-device sync, cloud-backed directives, and the full consigliere brain.

<Steps>
  <Step title="Sign up">
    Go to [bossmode.ing/signup](https://bossmode.ing/signup) and create a free account.
  </Step>

  <Step title="Get your token">
    After signup, your API token is in **Settings → API Token**. Copy it.
  </Step>

  <Step title="Set your environment variable">
    ```bash theme={null}
    export BOSSMODE_API_TOKEN=your_token_here
    ```

    Or add it to your `.env.local`:

    ```
    BOSSMODE_API_TOKEN=your_token_here
    ```
  </Step>

  <Step title="Verify the connection">
    ```bash theme={null}
    curl -sH "x-bossmode-token: $BOSSMODE_API_TOKEN" \
      https://bossmode.ing/api/pro/context | jq
    ```
  </Step>
</Steps>

## MCP server integration

For Claude Code, Codex CLI, or any MCP-compatible runtime:

```bash theme={null}
npm i -g @bossmode/mcp-server
```

Then in your MCP config:

```json theme={null}
{
  "mcpServers": {
    "bossmode": {
      "command": "bossmode-mcp-server",
      "env": {
        "BOSSMODE_API_TOKEN": "your_token_here"
      }
    }
  }
}
```

## Environment variables

| Variable                 | Required        | Description             |
| ------------------------ | --------------- | ----------------------- |
| `BOSSMODE_API_TOKEN`     | Yes (cloud)     | Your operator API token |
| `NEXT_PUBLIC_CONVEX_URL` | Yes (self-host) | Convex deployment URL   |
| `CONVEX_ADMIN_TOKEN`     | Yes (self-host) | Convex admin token      |
| `RESEND_API_KEY`         | Optional        | Email delivery          |

## Verify installation

```bash theme={null}
bossmode status
```

Expected output:

```
✓ BossMode v0.x.x
✓ Local brain: seeded
✓ Provider: claude_code_local
✓ Standing orders: 0 loaded
```

## Next

<CardGroup cols={2}>
  <Card title="Run your first directive" icon="play" href="/first-agent">
    Issue a directive and watch the consigliere execute.
  </Card>

  <Card title="Write standing orders" icon="list-check" href="/standing-orders">
    Define the rules the consigliere follows when the boss is away.
  </Card>
</CardGroup>

## Uninstall

Stop the local daemon and remove the global command:

```bash theme={null}
bossmode stop
npm uninstall -g @bossmode/cli
```

For a full local wipe first:

```bash theme={null}
bossmode reset --full
npm uninstall -g @bossmode/cli
```