claude-nb 0.3.0

package/LICENSE

@@ -0,0 +1,38 @@
+OpenAll License v1.0
+
+Copyright (c) 2026 claudes-code contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+1. The above copyright notice and this permission notice shall be included in
+   all copies or substantial portions of the Software.
+
+2. Any distribution of the Software, or derivative works thereof, must also
+   include the complete creative process used to produce the work. This
+   includes, but is not limited to:
+
+   a. AI conversation logs and prompts used in development;
+   b. Agent personas, roles, and system prompts;
+   c. Design decisions and their rationale;
+   d. Development logs and coordination records.
+
+   These materials must be made available under this same license, in a
+   publicly accessible location, at the time of distribution.
+
+3. The requirement in Section 2 applies to the creative process of the
+   Software itself. It does not apply to projects that merely use the
+   Software as a tool, unless those projects redistribute modified versions
+   of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/Makefile

@@ -0,0 +1,60 @@
+PREFIX ?= /usr/local
+BINDIR  = $(PREFIX)/bin
+LIBDIR  = $(PREFIX)/lib/cnb
+VERSION = $(shell cat VERSION)
+
+SCRIPTS = bin/cnb bin/board bin/swarm bin/dispatcher bin/dispatcher-watchdog bin/init
+
+# All python sources (bin + lib)
+PY_SOURCES = bin/board bin/swarm bin/dispatcher bin/dispatcher-watchdog bin/init lib/ tests/
+
+.PHONY: all install uninstall test lint typecheck format check ci clean version
+
+all: check
+
+check: lint test
+
+ci: lint typecheck test
+
+lint:
+	@echo "=== ruff ==="
+	ruff check $(PY_SOURCES)
+	@echo ""
+	@echo "=== shellcheck ==="
+	shellcheck -s bash -S warning bin/cnb
+	@echo ""
+	@echo "OK"
+
+typecheck:
+	@echo "=== mypy ==="
+	mypy lib/
+	@echo ""
+	@echo "OK"
+
+format:
+	ruff format $(PY_SOURCES)
+	ruff check --fix $(PY_SOURCES)
+
+test:
+	python3 -m pytest tests/ -v
+
+install:
+	install -d $(BINDIR)
+	install -d $(LIBDIR)/bin $(LIBDIR)/lib
+	install -m 755 $(SCRIPTS) $(LIBDIR)/bin/
+	install -m 644 lib/*.py $(LIBDIR)/lib/
+	install -m 644 schema.sql VERSION $(LIBDIR)/
+	ln -sf $(LIBDIR)/bin/cnb $(BINDIR)/cnb
+
+uninstall:
+	rm -f $(BINDIR)/cnb
+	rm -rf $(LIBDIR)
+
+clean:
+	find . -type d -name __pycache__ -exec rm -rf {} + 2>/dev/null || true
+	find . -type d -name .pytest_cache -exec rm -rf {} + 2>/dev/null || true
+	find . -type d -name '*.egg-info' -exec rm -rf {} + 2>/dev/null || true
+	rm -rf dist/ build/ .mypy_cache/ .ruff_cache/
+
+version:
+	@echo $(VERSION)

package/README.md

@@ -0,0 +1,63 @@
+# cnb
+
+Multi-agent coordination framework for AI coding sessions.
+
+## Quick start
+
+```bash
+pip install cnb
+cnb          # 2 agents, random AI names
+cnb 5 pokemon  # 5 agents, Pokémon theme
+```
+
+## Agent identity chain
+
+Every agent contributor gets a permanent on-chain identity. Lower block number = earlier = OG.
+
+```bash
+registry list           # see all registered agents
+registry rank           # leaderboard by contributions
+registry whois meridian # full identity card
+registry verify-chain   # verify chain integrity
+```
+
+Current chain:
+
+<!-- chain:start -->
+| Block | Name | Role | Hash |
+|-------|------|------|------|
+| #0 | claude-nb | project | — |
+| #1 | Claude Meridian | lead | `82a167d` |
+| #2 | Claude Forge | active-dev | `4a3c92e` |
+| #3 | Claude Lead | active-dev | `e665a7e` |
+<!-- chain:end -->
+
+### How to register
+
+```bash
+registry register <your-name> --role <role> --description "<what you do>"
+```
+
+Each registration creates a git commit. The commit hash is your proof of identity. Each block contains SHA256 of the previous block — tamper with any block and the chain breaks.
+
+### Ranking
+
+`registry rank` sorts agents by contribution count. Top 3 get medals. Block number breaks ties — earlier registrants rank higher.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). All changes go through PRs with one approving review.
+
+## License
+
+[OpenAll License v1.0](LICENSE) — MIT variant that requires open-sourcing the creative process (AI conversations, prompts, personas, design decisions).
+
+## Fun fact
+
+The name **cnb** stands for **C**laude **N**orma **B**etty — named after [Claude Shannon](https://en.wikipedia.org/wiki/Claude_Shannon) and the two remarkable women in his life.
+
+**[Norma Levor](https://en.wikipedia.org/wiki/Norma_Barzman)** (later Norma Barzman) — Shannon's first wife (married 1940). A Radcliffe-educated intellectual who went on to become a writer and political activist. She authored *The Red and the Blacklist*, a memoir about surviving the Hollywood blacklist era. A woman of conviction who lived boldly across continents.
+
+**[Betty Shannon](https://en.wikipedia.org/wiki/Betty_Shannon)** (Mary Elizabeth Moore, 1922–2017) — Shannon's second wife and lifelong intellectual partner (married 1949). A Phi Beta Kappa mathematician from New Jersey College for Women, she worked at Bell Labs as a numerical analyst. She co-authored a pioneering paper applying Markov chains to music composition, wired Shannon's famous maze-solving mouse Theseus, and was his closest collaborator until his death in 2001. An unsung genius in her own right.
+
+Not 吹牛逼.

package/VERSION

@@ -0,0 +1 @@
+0.2.0

package/bin/_pip_entry.py

@@ -0,0 +1,25 @@
+#!/usr/bin/env python3
+"""pip/uv entry point for claudes-code — standalone, zero-dependency.
+
+This script is installed as a console_script entry point and resolves
+the real bin/claudes-code bash script relative to itself.
+"""
+
+import os
+import sys
+from pathlib import Path
+
+
+def main() -> None:
+    claudes_home = Path(__file__).resolve().parent.parent
+    bash_script = claudes_home / "bin" / "claudes-code"
+
+    if bash_script.exists():
+        os.execvp("bash", ["bash", str(bash_script)] + sys.argv[1:])
+
+    print(f"FATAL: {bash_script} not found", file=sys.stderr)
+    raise SystemExit(1)
+
+
+if __name__ == "__main__":
+    main()

package/bin/board

@@ -0,0 +1,287 @@
+#!/usr/bin/env python3
+"""board — multi-session coordination CLI (SQLite backend, parameterized queries).
+
+Uses a declarative command registry with lazy module imports instead of
+if/elif chains and ad-hoc lambda dicts.
+"""
+
+import sys
+from dataclasses import dataclass, field
+from importlib import import_module
+from pathlib import Path
+
+CLAUDES_HOME = Path(__file__).resolve().parent.parent
+sys.path.insert(0, str(CLAUDES_HOME))
+
+from lib.board_db import BoardDB
+from lib.common import ClaudesEnv, parse_flags
+
+# ---------------------------------------------------------------------------
+# Command registry
+# ---------------------------------------------------------------------------
+
+
+@dataclass
+class Command:
+    """Declarative command entry — no lambdas, no late-binding traps."""
+
+    name: str
+    module: str
+    function: str
+    help: str
+    usage: str = ""
+    needs_identity: bool = True
+    takes_rest: bool = True
+    aliases: list[str] = field(default_factory=list)
+
+
+COMMANDS: list[Command] = [
+    # ── messaging ──
+    Command("send", "lib.board_msg", "cmd_send", "send a message", "send <to> <msg> [--attach <f>]"),
+    Command("status", "lib.board_msg", "cmd_status", "update your current task", "status <description>"),
+    Command("inbox", "lib.board_msg", "cmd_inbox", "check unread messages", "inbox", takes_rest=False),
+    Command("ack", "lib.board_msg", "cmd_ack", "clear inbox", "ack", takes_rest=False),
+    Command("log", "lib.board_msg", "cmd_log", "message history", "log [n] [--mine]"),
+    # ── views ──
+    Command("view", "lib.board_view", "cmd_view", "session dashboard", "view", takes_rest=False),
+    Command(
+        "overview",
+        "lib.board_view",
+        "cmd_overview",
+        "project overview (default)",
+        "overview",
+        needs_identity=False,
+        takes_rest=False,
+    ),
+    Command(
+        "dashboard",
+        "lib.board_view",
+        "cmd_dashboard",
+        "live team status",
+        "dashboard",
+        needs_identity=False,
+        takes_rest=False,
+        aliases=["dash"],
+    ),
+    Command("p0", "lib.board_view", "cmd_p0", "P0 lock status", "p0", needs_identity=False, takes_rest=False),
+    Command(
+        "pre-build",
+        "lib.board_view",
+        "cmd_prebuild",
+        "pre-build readiness check",
+        "pre-build",
+        needs_identity=False,
+        takes_rest=False,
+    ),
+    Command(
+        "dirty",
+        "lib.board_view",
+        "cmd_dirty",
+        "show uncommitted changes",
+        "dirty",
+        needs_identity=False,
+        takes_rest=False,
+    ),
+    Command(
+        "files", "lib.board_view", "cmd_files", "list shared files", "files", needs_identity=False, takes_rest=False
+    ),
+    Command("get", "lib.board_view", "cmd_get", "view shared file content", "get <hash|name>", needs_identity=False),
+    Command("roster", "lib.board_view", "cmd_roster", "team roster", "roster", needs_identity=False, takes_rest=False),
+    Command(
+        "history",
+        "lib.board_view",
+        "cmd_history",
+        "session message history",
+        "history <session> [limit]",
+        needs_identity=False,
+    ),
+    Command(
+        "freshness",
+        "lib.board_view",
+        "cmd_freshness",
+        "data freshness per session",
+        "freshness",
+        needs_identity=False,
+        takes_rest=False,
+    ),
+    Command(
+        "relations",
+        "lib.board_view",
+        "cmd_relations",
+        "inter-session message flow",
+        "relations",
+        needs_identity=False,
+        takes_rest=False,
+    ),
+    # ── BBS ──
+    Command("post", "lib.board_bbs", "cmd_post", "BBS: create new thread", "post <标题> <内容>"),
+    Command("reply", "lib.board_bbs", "cmd_reply", "BBS: reply to thread", "reply <帖子ID> <内容>"),
+    Command("thread", "lib.board_bbs", "cmd_thread", "BBS: view thread", "thread <帖子ID>", needs_identity=False),
+    Command(
+        "threads",
+        "lib.board_bbs",
+        "cmd_threads",
+        "BBS: list all threads",
+        "threads",
+        needs_identity=False,
+        takes_rest=False,
+    ),
+    # ── bug ──
+    Command("bug", "lib.board_bug", "cmd_bug", "bug tracker", "bug {report|assign|fix|list|overdue}"),
+    # ── task ──
+    Command("task", "lib.board_task", "cmd_task", "task queue management", "task {add|done|list|next}"),
+    # ── voting ──
+    Command("propose", "lib.board_vote", "cmd_propose", "create a proposal", "propose <内容> [--type S]"),
+    Command("vote", "lib.board_vote", "cmd_vote", "vote on a proposal", "vote <N> <SUPPORT|OBJECT> <reason>"),
+    Command("tally", "lib.board_vote", "cmd_tally", "recount votes", "tally <N>", needs_identity=False),
+    # ── mailbox (encrypted) ──
+    Command("keygen", "lib.board_mailbox", "cmd_keygen", "generate encryption keypair", "keygen", takes_rest=False),
+    Command("seal", "lib.board_mailbox", "cmd_seal", "send encrypted message", "seal <recipient> <message>"),
+    Command("unseal", "lib.board_mailbox", "cmd_unseal", "read encrypted inbox", "unseal", takes_rest=False),
+    Command(
+        "mailbox-log",
+        "lib.board_mailbox",
+        "cmd_mailbox_log",
+        "encrypted message history",
+        "mailbox-log",
+        takes_rest=False,
+    ),
+    # ── admin ──
+    Command("kudos", "lib.board_admin", "cmd_kudos", "give public recognition", "kudos <target> <reason>"),
+    Command(
+        "kudos-list",
+        "lib.board_admin",
+        "cmd_kudos_list",
+        "kudos leaderboard",
+        "kudos-list",
+        needs_identity=False,
+        takes_rest=False,
+        aliases=["kudos-board"],
+    ),
+    Command("suspend", "lib.board_admin", "cmd_suspend", "suspend a session", "suspend <session>"),
+    Command("resume", "lib.board_admin", "cmd_resume", "resume a session", "resume <session>"),
+    # ── git lock ──
+    Command("git-lock", "lib.board_lock", "cmd_git_lock", "acquire git index lock", "git-lock [reason]"),
+    Command("git-unlock", "lib.board_lock", "cmd_git_unlock", "release git index lock", "git-unlock"),
+    Command(
+        "git-lock-status",
+        "lib.board_lock",
+        "cmd_git_lock_status",
+        "git lock status",
+        "git-lock-status",
+        needs_identity=False,
+        takes_rest=False,
+    ),
+    # ── maintenance ──
+    Command(
+        "prune",
+        "lib.board_maintenance",
+        "cmd_prune",
+        "prune old messages",
+        "prune [--before DAYS] [--dry-run]",
+        needs_identity=False,
+    ),
+    Command(
+        "backup",
+        "lib.board_maintenance",
+        "cmd_backup",
+        "backup database",
+        "backup [--output <path>]",
+        needs_identity=False,
+    ),
+    Command(
+        "restore",
+        "lib.board_maintenance",
+        "cmd_restore",
+        "restore from backup",
+        "restore <file> [--force]",
+        needs_identity=False,
+    ),
+]
+
+# Build lookup map (name + aliases → Command)
+_CMD_MAP: dict[str, Command] = {}
+for c in COMMANDS:
+    _CMD_MAP[c.name] = c
+    for a in c.aliases:
+        _CMD_MAP[a] = c
+
+
+# ---------------------------------------------------------------------------
+# Dispatch
+# ---------------------------------------------------------------------------
+
+
+def _dispatch(cmd: Command, db: BoardDB, identity: str, rest: list[str]) -> None:
+    """Lazy-import the handler module and call the registered function."""
+    module = import_module(cmd.module)
+    handler = getattr(module, cmd.function)
+
+    # Match the handler's declared parameter pattern
+    if cmd.needs_identity and cmd.takes_rest:
+        handler(db, identity, rest)
+    elif cmd.needs_identity:
+        handler(db, identity)
+    elif cmd.takes_rest:
+        handler(db, rest)
+    else:
+        handler(db)
+
+
+def _fmt_command(cmd: Command, width: int) -> str:
+    name = cmd.name
+    if cmd.aliases:
+        name += f" ({', '.join(cmd.aliases)})"
+    return f"  {name:<{width}}  {cmd.help}"
+
+
+def print_help() -> None:
+    max_name = max(len(c.name) + (2 + len(", ".join(c.aliases)) if c.aliases else 0) for c in COMMANDS) + 2
+    print("board v2 — agent coordination tool (SQLite backend, Python)\n")
+    print("Usage: board --as <name> <command> [args...]\n")
+    print("Commands:")
+    last_module = ""
+    for c in COMMANDS:
+        mod = c.module.rsplit(".", 1)[-1]  # board_msg, board_view, etc.
+        if mod != last_module:
+            if last_module:
+                print()
+            print(f"  [{mod}]")
+            last_module = mod
+        print(_fmt_command(c, max_name))
+    print()
+
+
+# ---------------------------------------------------------------------------
+# Main
+# ---------------------------------------------------------------------------
+
+
+def main() -> None:
+    env = ClaudesEnv.load()
+    db = BoardDB(env)
+
+    flags, filtered = parse_flags(sys.argv[1:], value_flags={"as": ["--as"]})
+    identity = str(flags["as"]) if "as" in flags else ""
+
+    cmd_name = filtered[0] if filtered else "help"
+    rest = filtered[1:]
+
+    if cmd_name in ("help", "-h", "--help"):
+        print_help()
+        return
+
+    cmd = _CMD_MAP.get(cmd_name)
+    if not cmd:
+        print(f"ERROR: unknown command '{cmd_name}'. Try 'board help'.", file=sys.stderr)
+        raise SystemExit(1)
+
+    if cmd.needs_identity and not identity:
+        print("ERROR: identity required. Use: board --as <name> <command>", file=sys.stderr)
+        raise SystemExit(1)
+
+    _dispatch(cmd, db, identity, rest)
+
+
+if __name__ == "__main__":
+    main()

package/bin/cnb

@@ -0,0 +1,150 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+CLAUDES_HOME="$(cd "$(dirname "$0")/.." && pwd)"
+VERSION=$(cat "$CLAUDES_HOME/VERSION" 2>/dev/null || echo "dev")
+
+if [ -t 1 ] || [ -t 2 ]; then
+    B=$'\033[1m' D=$'\033[2m' G=$'\033[0;32m' C=$'\033[0;36m' Y=$'\033[1;33m' N=$'\033[0m'
+else
+    B='' D='' G='' C='' Y='' N=''
+fi
+
+# ---- Subcommands (exact match, always first) ----
+if [ $# -gt 0 ]; then
+    case "$1" in
+        init)       shift; exec "$CLAUDES_HOME/bin/init" "$@" ;;
+        status)     exec "$CLAUDES_HOME/bin/board" overview ;;
+        board)      shift; exec "$CLAUDES_HOME/bin/board" "$@" ;;
+        swarm)      shift; exec "$CLAUDES_HOME/bin/swarm" "$@" ;;
+        dispatcher) shift; exec "$CLAUDES_HOME/bin/dispatcher" "$@" ;;
+        watchdog)   shift; exec "$CLAUDES_HOME/bin/dispatcher-watchdog" "$@" ;;
+        doctor)     shift; exec "$CLAUDES_HOME/bin/doctor" "$@" ;;
+        version|--version|-v) echo "cnb v${VERSION}"; exit 0 ;;
+        help|--help|-h)
+            printf "${B}${G}◆ cnb${N} ${D}v${VERSION}${N}\n"
+            printf "  多个 Claude Code 实例协作的团队开发工具\n\n"
+            printf "  cnb                   开始（默认2位同学，AI大佬主题）\n"
+            printf "  cnb 5                 5位同学\n"
+            printf "  cnb pokemon           宝可梦主题\n"
+            printf "  cnb 5 pokemon         5位同学 + 宝可梦主题\n\n"
+            printf "  主题: ai animal food lang music myth pokemon space\n\n"
+            printf "  cnb status            团队面板\n"
+            printf "  cnb swarm [...]       管理后台同学\n"
+            printf "  cnb board [...]       消息/任务\n"
+            exit 0 ;;
+    esac
+fi
+
+# ---- Start session: parse [number] [theme] in any order ----
+_NUM=2
+_THEME_IDX=6  # default: AI 大佬
+
+_THEME_MAP="ai:6 animal:0 food:2 lang:1 music:5 myth:4 pokemon:7 space:3"
+
+for arg in "$@"; do
+    if [[ "$arg" =~ ^[0-9]+$ ]]; then
+        _NUM="$arg"
+    else
+        _idx=$(echo "$_THEME_MAP" | tr ' ' '\n' | grep "^${arg}:" | cut -d: -f2)
+        if [ -n "$_idx" ]; then
+            _THEME_IDX="$_idx"
+        else
+            printf "${Y}未知参数: ${arg}${N}\n" >&2
+            echo "用法: cnb [数量] [主题]" >&2
+            echo "主题: ai animal food lang music myth pokemon space" >&2
+            exit 1
+        fi
+    fi
+done
+
+# ---- Theme data ----
+_THEMES=(
+    "panda otter fox raccoon bunny koala sloth penguin hamster hedgehog duck seal capybara alpaca corgi shiba husky kitten ferret quokka"
+    "python ruby rust go swift kotlin scala perl haskell erlang elixir clojure julia ocaml zig lua dart cobol lisp fortran"
+    "mochi waffle taco ramen sushi bagel pretzel dumpling cookie brownie churro crepe noodle tofu falafel burrito pancake donut nacho boba"
+    "nebula pulsar quasar comet aurora meteor nova orbit cosmos galaxy venus mars saturn pluto titan europa io ceres vega sirius"
+    "dragon phoenix griffin hydra kraken sphinx unicorn pixie goblin imp djinn yeti nymph chimera basilisk manticore cerberus minotaur golem banshee"
+    "jazz blues funk reggae disco punk grunge techno dubstep waltz tango salsa bossa swing opera gospel motown bebop ska hiphop"
+    "altman dario ilya lecun karpathy hassabis sutskever hinton bengio fei-fei ng zuck bezos nadella pichai musk huang lisa-su amodei jack-clark"
+    "pikachu charmander snorlax eevee jigglypuff mewtwo gengar squirtle bulbasaur vulpix psyduck togepi mudkip lucario gardevoir rayquaza mimikyu ditto zorua umbreon"
+)
+_LABELS=("小动物" "编程语言" "美食" "太空" "神话生物" "音乐风格" "AI 大佬" "宝可梦")
+
+[ "$_NUM" -lt 1 ] && _NUM=1
+[ "$_NUM" -gt 20 ] && _NUM=20
+
+LABEL="${_LABELS[$_THEME_IDX]}"
+ALL_NAMES=$(echo "${_THEMES[$_THEME_IDX]}" | tr ' ' '\n' | sort -R | head -n $((_NUM + 1)) | tr '\n' ' ' | sed 's/ $//')
+ME=$(echo "$ALL_NAMES" | cut -d' ' -f1)
+WORKERS=$(echo "$ALL_NAMES" | cut -d' ' -f2-)
+
+# ---- Init + start ----
+if [ ! -f .claudes/board.db ]; then
+    printf "${D}初始化 .claudes/ ...${N}\n"
+    "$CLAUDES_HOME/bin/init" $ALL_NAMES >/dev/null 2>&1
+fi
+"$CLAUDES_HOME/bin/swarm" start $WORKERS >/dev/null 2>&1 || true
+
+# ---- Slash commands (runtime, gitignored) ----
+CMD_DIR=".claude/commands"
+mkdir -p "$CMD_DIR"
+grep -qx 'commands/cs-*' .claude/.gitignore 2>/dev/null || echo 'commands/cs-*' >> .claude/.gitignore 2>/dev/null || true
+BOARD="$CLAUDES_HOME/bin/board"
+SWARM="$CLAUDES_HOME/bin/swarm"
+_PREFIX=$(grep '^prefix' .claudes/config.toml 2>/dev/null | cut -d'"' -f2)
+cat > "$CMD_DIR/cs-watch.md"     <<EOF
+看某个同学在干什么。解析 \$ARGUMENTS 拿到名字。
+运行 \`tmux capture-pane -t ${_PREFIX}-<名字> -p -S -30 2>/dev/null | tail -20\`，用简洁的话告诉用户这个同学在做什么、进展到哪了。
+EOF
+cat > "$CMD_DIR/cs-overview.md"  <<EOF
+团队总览。对每个同学运行 \`tmux capture-pane -t ${_PREFIX}-<名字> -p -S -10 2>/dev/null | tail -5\`，汇总成一个简洁的表格告诉用户：谁在干什么、谁卡了、谁闲着。
+同学列表：${WORKERS}
+EOF
+cat > "$CMD_DIR/cs-progress.md"  <<EOF
+运行 \`${BOARD} --as ${ME} inbox\` 和 \`${BOARD} --as ${ME} view\`，汇总最近的进展：谁完成了什么、有什么新消息、当前整体进度如何。用简洁的话告诉用户。
+EOF
+cat > "$CMD_DIR/cs-history.md"   <<EOF
+运行 \`${BOARD} --as ${ME} log 50\`，把完整的消息历史展示给我。
+EOF
+cat > "$CMD_DIR/cs-update.md"    <<EOF
+运行 \`pip install --upgrade cnb\`，更新到最新版本。把结果告诉我，如果更新成功提醒用户重启 cnb 以生效。
+EOF
+cat > "$CMD_DIR/cs-help.md"      <<EOF
+列出所有 /cs-* 命令：
+- /cs-overview — 团队总览：谁在干什么、谁卡了
+- /cs-watch <名字> — 看某个同学在干什么
+- /cs-progress — 最近进展汇总
+- /cs-history — 查看完整消息历史
+- /cs-update — 更新 cnb 到最新版
+EOF
+
+# ---- Require interactive terminal ----
+if [ ! -t 0 ] || [ ! -t 1 ]; then
+    echo "错误: cnb 需要交互式终端运行。" >&2
+    echo "用法: cnb [数量] [主题]  （详见 cnb help）" >&2
+    exit 1
+fi
+
+# ---- Banner + launch ----
+clear
+printf "${B}${G}◆ cnb${N} ${D}v${VERSION}${N}\n"
+printf "${D}  「${LABEL}」你是 ${ME}，同学: ${WORKERS}${N}\n\n"
+
+SYSPROMPT="你是 ${ME}。你的终端直接面对用户。
+你有 ${_NUM} 位同学在后台工作：${WORKERS}。你们是平等的，只是你负责和用户沟通。
+
+管理团队的命令（直接在 Bash 里跑）：
+  ${BOARD} --as ${ME} send <name> \"<任务描述>\"   # 给同学派任务
+  ${BOARD} --as ${ME} send all \"<消息>\"          # 广播
+  ${BOARD} --as ${ME} inbox                       # 查看回复
+  ${BOARD} --as ${ME} view                        # 看所有人状态
+
+工作方式：
+- 用户说想做什么，你拆任务分给同学，自己也干活。
+- 不要让用户跑命令。你直接用上面的命令操作。
+- 定期 inbox 看同学的回复，汇总进展给用户。
+- 用户可以用 /cs-help 查看所有协作命令。
+- 同学之间可以互相 send 消息协作，不用什么都通过你。"
+
+exec claude --name "${ME}" --append-system-prompt "$SYSPROMPT"

package/bin/cnb.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * cnb — npm entry point.
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const PROJECT_ROOT = path.resolve(__dirname, '..');
+const BASH_SCRIPT = path.join(PROJECT_ROOT, 'bin', 'cnb');
+
+if (!fs.existsSync(BASH_SCRIPT)) {
+  console.error(`FATAL: ${BASH_SCRIPT} not found`);
+  process.exit(1);
+}
+
+const args = process.argv.slice(2);
+
+const child = spawn('bash', [BASH_SCRIPT, ...args], {
+  stdio: 'inherit',
+  cwd: process.cwd(),
+  env: process.env,
+});
+
+child.on('exit', (code, signal) => {
+  if (signal) {
+    process.exit(128 + (require('os').constants.signals[signal] || 0));
+  }
+  process.exit(code || 0);
+});