[QUICKSTART]
Four steps.
Three minutes.
Run bossmode init. BossMode seeds the local brain, starts the GUI, and opens the workspace on your machine. Upgrade later when you want cloud sync and the full brain.
[TWO WAYS TO RUN BOSSMODE]
BossMode runs in your browser, your dock, or your dev server. Pick the boundary you want.
Path A — Browser
Download BossMode locally and open the cockpit on localhost. Free mode lives on your machine.
Path B — Local machine
One command. Your machine. Your Claude Pro or ChatGPT Plus subscription does the inference.
[STEP 01]
Download BossMode. Open localhost.
Run `npx @acelabs/bossmode-cli init`. BossMode seeds the local SQLite brain, starts the GUI in detached mode, and opens the cockpit in your browser.
npx @acelabs/bossmode-cli init
No email, token, or cloud dependency required for free local mode.
[STEP 02]
Pick your integration.
BossMode runs in the workspace, through MCP, or through your local CLI bridge. Three paths. Pick one. They all end at the same product.
Native command center in the browser. Token in, live family online in under a minute.
Drop a Model Context Protocol server into any MCP-compatible runtime.
Already installed for Claude Code users.
[STEP 03]
Leave standing orders.
Standing orders are the rules the consigliere follows when the boss is away. Without them, autonomous moves stop at review. With them, delegated work stays bounded by policy.
curl -sX POST https://bossmode.ing/api/pro/standing-orders \
-H "x-bossmode-token: $BOSSMODE_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"order": "When inbound revenue from Stripe exceeds $5,000 in 24h, escalate to me before any pricing change.",
"priority": "high",
"scope": ["pricing_move", "offer_move"],
"requiresApproval": true
}'The consigliere reads these on every brief.
[STEP 04]
Call get-context. Walk away.
The one call that returns everything the consigliere needs: signals, packets, standing orders, approvals, transport status, receipts, metrics, recent moves, Guardian state, and buyer context.
curl -sH "x-bossmode-token: $BOSSMODE_API_TOKEN" \
https://bossmode.ing/api/pro/context | jq
# Response shape:
{
"generatedAt": "2026-04-07T09:00:00Z",
"sessionId": "ses_••••••",
"operator": { "handle": "you", "tier": "pro" },
"signals": [ /* scored, ranked */ ],
"workPackets": [ /* capo queue */ ],
"standingOrders": [ /* your rules */ ],
"metrics": { "revenue24h": 0, "signalsScored": 1247 },
"auditFeed": [ /* every move logged */ ],
"guardian": { "mode": "guardrailed", "pending": 2 },
"buyerContext": { /* buyer profiles, voice, target list */ }
}Walk away. Come back to a weekly Family Report with receipts.
[PATH B — LOCAL CLI]
Run it on your machine.
For power users who want BossMode thinking on their own machine using their existing Claude Pro or ChatGPT Plus subscription. One command. No key paste. No separate billing.
[STEP 01] Install and init
npx @acelabs/bossmode-cli init npx @acelabs/bossmode-cli init --wizard
The CLI sends the same verification email, polls until the token is ready, and auto-detects Claude Code or Codex CLI on your machine.
[STEP 02] Start the server
npx @acelabs/bossmode-cli start
Spins up localhost:5173/app and opens your browser automatically.
[STEP 03] Same data, everywhere
The local CLI hits the same Convex backend as bossmode.ing/app. Multi-device sync is automatic. A directive issued on your laptop shows up on your desktop in under 5 seconds.
Your Claude Pro or ChatGPT Plus handles inference. Zero extra billing.
[SHIPS IN THE BOX]
You don’t build the consigliere. You install it.
Pre-loaded Operational Playbooks
CEO brief, four capo roles, scoring rubrics, and an escalation ladder. The consigliere ships knowing the rules.
Buyer Context
Up to 10 buyer profiles and brand voice calibration. The consigliere reads the buyer model before every move.
Guardian Preflight + Kill Switch
Every action cleared before it runs. Full audit trail always. Reversible work gets receipts and rollback semantics.
Seven Business Engines
Audience, traffic, offer, launch, conversion, retention, outcome. Only confident moves go forward.
Daily Family Report
Every week: outcomes logged, moves made, packets closed, signals scored. One report. Nothing buried.
[NEXT]
Where operators go after step four.
Local install first. Paid upgrade when you want the full brain.
Free local cockpit. Paid unlocks sync, directives, and narrated reports.