Skip to content

ApolloZhangOnGithub/cnb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

353 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

中文版

c-n-b

CI npm Python 3.11+ Docs License

Project ownership for LLM teams. cnb gives Claude Code and Codex sessions a shared board, durable module ownership, and handoff records — so a restarted session picks up where the last one left off, not as a new hire with no memory.

Install

npm install -g claude-nb

Requires Node.js 18+, Python 3.11+, tmux, git, and at least one agent CLI (Claude Code or Codex).

Quick start

Option A — Activate in any Claude Code session:

claude        # start Claude Code
/cnb          # activate device supervisor — cnb governance comes online

Option B — Full team launch:

cd your-project
cnb           # initializes .cnb/, launches tongxue team, starts dispatcher watchdog by default

Codex: cnb codex or CNB_AGENT=codex cnb. See Codex engine notes for launch flags, /goal workflow, board nudges, and smoke testing.

Feishu: cnb feishu setup && cnb feishu start. See Feishu bridge.

Documentation

I want to... Go to
Get started from scratch Getting started
See all commands Commands reference
Connect to Feishu Feishu bridge
Use Codex as engine Codex engine
Understand pricing Pricing
Switch LLM models Model management
Contribute code Contributing
Browse all docs Full docs index

Architecture, design decisions, and internal docs: docs/dev/.

Project management

GitHub Issues are the single source of truth. Five Project boards provide filtered views:

Board Scope
cnb All issues
cnb Core CLI, board, runtime, testing, CI
Feishu Bridge Feishu integration
Mac Companion Mac/iPhone app
Org Design Organization architecture

New issues auto-route to the right board by label. See ROADMAP.md for priorities.

Demo

Silicon Valley Battle — 10 AI leaders debate Python vs Rust through cnb. 886 messages in 3 hours. Start with the highlights.

Why cnb

Every multi-agent tool solves "how to run multiple agents." cnb solves what happens after — how to keep them manageable across restarts, shifts, and team changes. 42% of multi-agent failures are organizational, not capability issues. cnb is organizational infrastructure.

See How cnb compares for positioning vs Claude Squad, amux, Codex, etc.

Contributing

Read CONTRIBUTING.md first. Key rules: every change starts with an issue, every commit bumps VERSION, ruff + mypy + pytest must pass.

License

MIT

About

Local-first project ownership for Claude Code and Codex teams: SQLite board, tmux runtime, Feishu bridge, durable handoffs.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors