BossMode CLI

Run the consigliere on your own machine. Bridges to your existing Claude Code or Codex CLI subscription.

Install

npx @bossmode/cli init

Or install globally:

npm install -g @bossmode/cli

Requires Node >= 20.

Use

1. Start instant setup:

   npx @bossmode/cli init

   BossMode emails a one-click verification link, polls until the token is ready, and writes the local config automatically.

2. Optional: run the onboarding wizard in your terminal:

   npx @bossmode/cli init --wizard

3. Already have a token? You can still pass it directly:

   npx @bossmode/cli init --token=bm_live_xxxxx

4. Open BossMode from any terminal:

   bossmode

   Bare bossmode starts the local daemon if needed and opens the operator TUI.

5. Open the browser cockpit when you want it:

   bossmode start

   Your browser opens automatically to http://localhost:5173/app.

What you get

• The full BossMode operator workspace running on your laptop
• Bridges to your existing Claude Code SDK or OpenAI Codex CLI subscription (no key paste, no double billing)
• Multi-device sync via the BossMode Convex backend (install on as many machines as you want, same data everywhere)
• The consigliere's thinking happens on your machine, not on our servers

Commands

• npx @bossmode/cli init — set up the local config
• npx @bossmode/cli init --wizard — verify by email, answer the minimal onboarding questions, and queue the first directive
• bossmode — open the operator TUI, starting the local daemon if needed
• npx @bossmode/cli start — run the browser cockpit
• npx @bossmode/cli stop — stop the workspace
• npx @bossmode/cli status — show running state
• npx @bossmode/cli --version — print installed version
• bossmode reset --full && npm uninstall -g @bossmode/cli — fully uninstall local state and the global command

Privacy

• Your Pro token lives at ~/.bossmode/config.json. Treat it like a key.
• The local server runs only on localhost:5173 by default. It is not reachable from outside your machine.
• LLM calls go to your local Claude Code or Codex binary using your existing subscription. No data leaves your machine for inference.
• The BossMode backend (audit feed, family chart, work packets) syncs to https://kindred-kangaroo-999.convex.cloud over HTTPS.

Building from source

If you want to build and publish the CLI yourself:

1. Build the Next.js app from the repo root:

   npm run build

   This produces .next/standalone/, .next/static/, and public/.

2. Build the CLI TypeScript and bundle the standalone output:

   cd packages/bossmode-cli
   npm run build          # tsc — compiles src/ -> dist/
   node scripts/bundle-standalone.mjs   # copies .next/standalone into dist/server-bundle/

3. Pack or publish:

   npm pack               # produces bossmode-cli-0.1.1.tgz for local testing
   npm publish            # publishes to npm (requires npm login + publish rights)

The prepack script runs bundle-standalone.mjs automatically when you run npm publish or npm pack, so steps 2b and 3 can be combined to just npm publish once npm run build has been run at the repo root.

Boss says

Made by ACE Labs. The consigliere is yours.