Skip to main content

​
Prerequisites

  • Node.js v20.17.0 or higher
  • npm or pnpm
  • A Claude Pro or ChatGPT Plus subscription (for local inference on Path B)
BossMode’s cockpit runs in your browser. One command seeds the local SQLite brain and opens the workspace.
1

Install and initialize

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

Open BossMode from any terminal

After global install, the everyday command is:
Bare bossmode starts the local daemon if needed and opens the operator TUI. The browser cockpit is still available with:
3

Run the setup wizard (optional)

The wizard walks you through setting business context, adding your first buyer profile, and queuing your first directive.

​
Path B — Cloud workspace

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

Sign up

Go to bossmode.ing/signup and create a free account.
2

Get your token

After signup, your API token is in Settings → API Token. Copy it.
3

Set your environment variable

Or add it to your .env.local:
4

Verify the connection

​
MCP server integration

For Claude Code, Codex CLI, or any MCP-compatible runtime:
Then in your MCP config:

​
Environment variables

​
Verify installation

Expected output:

​
Next

Run your first directive

Issue a directive and watch the consigliere execute.

Write standing orders

Define the rules the consigliere follows when the boss is away.

​
Uninstall

Stop the local daemon and remove the global command:
For a full local wipe first: