claude-nb 0.3.0 → 0.5.1

package/bin/cnb

@@ -10,113 +10,194 @@ else
     B='' D='' G='' C='' Y='' N=''
 fi
 
+# ---- Export project root so all subprocesses can find .claudes/ ----
+export CNB_PROJECT="${CNB_PROJECT:-$(pwd)}"
+
 # ---- 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 ;;
+        status|ps)  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" "$@" ;;
+        logs)
+            shift
+            if [ $# -eq 0 ]; then
+                echo "用法: cnb logs <name>" >&2; exit 1
+            fi
+            exec "$CLAUDES_HOME/bin/board" --as "$1" log 50 ;;
+        stop)
+            shift
+            if [ $# -eq 0 ]; then
+                echo "用法: cnb stop <name>" >&2; exit 1
+            fi
+            exec "$CLAUDES_HOME/bin/swarm" stop "$@" ;;
+        exec)
+            shift
+            if [ $# -lt 2 ]; then
+                echo "用法: cnb exec <name> \"message\"" >&2; exit 1
+            fi
+            _target="$1"; shift
+            exec "$CLAUDES_HOME/bin/board" send "$_target" "$*" ;;
+        compose)
+            shift
+            _TEAM_FILE="${1:-cnb.toml}"
+            if [ ! -f "$_TEAM_FILE" ]; then
+                echo "错误: 找不到团队配置文件 '$_TEAM_FILE'" >&2
+                echo "用法: cnb compose [team-file.toml]" >&2
+                echo "" >&2
+                echo "示例 cnb.toml:" >&2
+                echo '  [session.alice]' >&2
+                echo '  persona = "Backend engineer"' >&2
+                echo '  [session.bob]' >&2
+                echo '  persona = "Frontend specialist"' >&2
+                exit 1
+            fi
+            "$CLAUDES_HOME/bin/init" --team "$_TEAM_FILE"
+            _NAMES=$(python3 -c "
+import tomllib, sys
+data = tomllib.loads(open(sys.argv[1]).read())
+names = list(data.get('session', {}).keys())
+print(' '.join(names))
+" "$_TEAM_FILE")
+            if [ -n "$_NAMES" ]; then
+                "$CLAUDES_HOME/bin/swarm" start $_NAMES >/dev/null 2>&1 || true
+                echo "OK 团队已启动: $_NAMES"
+            fi
+            exit 0 ;;
+        ui)         shift; exec "$CLAUDES_HOME/bin/board" tui ;;
         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 threebody         三体主题\n"
+            printf "  cnb 5 titan           5位同学 + 科技先锋主题\n"
+            printf "  cnb compose [file]    从配置文件启动团队\n\n"
+            printf "  主题: ai animal food lang music myth space threebody titan\n\n"
+            printf "  cnb ui                交互式团队面板\n"
+            printf "  cnb ps                列出同学状态\n"
+            printf "  cnb logs <name>       查看某个同学的消息历史\n"
+            printf "  cnb exec <name> \"msg\" 给某个同学发指令\n"
+            printf "  cnb stop <name>       停止某个同学\n"
+            printf "  cnb doctor            健康检查\n\n"
+            printf "  cnb board [...]       底层消息/任务命令\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 大佬
+# ---- Helper: start dispatcher if not already running ----
+_start_dispatcher() {
+    local pidfile="$CNB_PROJECT/.claudes/dispatcher.pid"
+    if [ -f "$pidfile" ] && kill -0 "$(cat "$pidfile")" 2>/dev/null; then
+        return
+    fi
+    mkdir -p "$CNB_PROJECT/.claudes/logs"
+    "$CLAUDES_HOME/bin/dispatcher" >> "$CNB_PROJECT/.claudes/logs/dispatcher.log" 2>&1 &
+    echo $! > "$pidfile"
+    disown
+}
+
+# ---- Compose mode: reuse existing team from config.toml ----
+if [ -f .claudes/config.toml ] && [ -f .claudes/board.db ]; then
+    _EXISTING=$(grep '^sessions' .claudes/config.toml | sed 's/sessions = \[//;s/\]//;s/"//g;s/,/ /g;s/  */ /g' | xargs)
+    if [ -n "$_EXISTING" ]; then
+        ME=$(echo "$_EXISTING" | cut -d' ' -f1)
+        WORKERS=$(echo "$_EXISTING" | cut -d' ' -f2-)
+        LABEL=$(grep '^prefix' .claudes/config.toml | cut -d'"' -f2)
+        _NUM=$(echo "$WORKERS" | wc -w | tr -d ' ')
+        "$CLAUDES_HOME/bin/swarm" start $WORKERS >/dev/null 2>&1 &
+        disown
+        _start_dispatcher
+    fi
+else
+    # ---- Fresh start: 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"
+    _THEME_MAP="ai:6 animal:0 food:2 lang:1 music:5 myth:4 space:3 threebody:7 titan:8"
 
-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"
+    for arg in "$@"; do
+        if [[ "$arg" =~ ^[0-9]+$ ]]; then
+            _NUM="$arg"
         else
-            printf "${Y}未知参数: ${arg}${N}\n" >&2
-            echo "用法: cnb [数量] [主题]" >&2
-            echo "主题: ai animal food lang music myth pokemon space" >&2
-            exit 1
+            _idx=$(echo "$_THEME_MAP" | tr ' ' '\n' | grep "^${arg}:" | cut -d: -f2 || true)
+            if [ -n "$_idx" ]; then
+                _THEME_IDX="$_idx"
+            else
+                printf "${Y}未知参数: ${arg}${N}\n" >&2
+                echo "用法: cnb [数量] [主题]" >&2
+                echo "主题: ai animal food lang music myth space threebody titan" >&2
+                exit 1
+            fi
         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
+    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 vaswani hinton bengio fei-fei ng zuck bezos nadella pichai musk huang lisa-su radford jack-clark"
+        "luo-ji shi-qiang ye-wenjie cheng-xin zhang-beihai yun-tianming wang-miao ding-yi yang-dong zhuang-yan guan-yifan shen-yufei wei-cheng hines tyler wade evans rey-diaz tomoko singer"
+        "wang-xingxing ren-zhengfei zhang-yiming lei-jun li-yanhong li-kaifu liang-wenfeng yang-zhilin kaiming-he ma-huateng wang-jian lu-qi goodfellow schmidhuber dean chollet silver carmack torvalds wolfram"
+    )
+    _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-)
+
     printf "${D}初始化 .claudes/ ...${N}\n"
     "$CLAUDES_HOME/bin/init" $ALL_NAMES >/dev/null 2>&1
+    "$CLAUDES_HOME/bin/swarm" start $WORKERS >/dev/null 2>&1 &
+    disown
+    _start_dispatcher
 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
+grep -qx 'commands/cnb-*' .claude/.gitignore 2>/dev/null || echo 'commands/cnb-*' >> .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
+cat > "$CMD_DIR/cnb-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
+cat > "$CMD_DIR/cnb-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
+cat > "$CMD_DIR/cnb-progress.md"  <<EOF
 运行 \`${BOARD} --as ${ME} inbox\` 和 \`${BOARD} --as ${ME} view\`，汇总最近的进展：谁完成了什么、有什么新消息、当前整体进度如何。用简洁的话告诉用户。
 EOF
-cat > "$CMD_DIR/cs-history.md"   <<EOF
+cat > "$CMD_DIR/cnb-history.md"   <<EOF
 运行 \`${BOARD} --as ${ME} log 50\`，把完整的消息历史展示给我。
 EOF
-cat > "$CMD_DIR/cs-update.md"    <<EOF
-运行 \`pip install --upgrade cnb\`，更新到最新版本。把结果告诉我，如果更新成功提醒用户重启 cnb 以生效。
+cat > "$CMD_DIR/cnb-update.md"    <<EOF
+运行 \`pip install --upgrade claude-nb\`，更新到最新版本。把结果告诉我，如果更新成功提醒用户重启 cnb 以生效。
 EOF
-cat > "$CMD_DIR/cs-help.md"      <<EOF
-列出所有 /cs-* 命令：
-- /cs-overview — 团队总览：谁在干什么、谁卡了
-- /cs-watch <名字> — 看某个同学在干什么
-- /cs-progress — 最近进展汇总
-- /cs-history — 查看完整消息历史
-- /cs-update — 更新 cnb 到最新版
+cat > "$CMD_DIR/cnb-help.md"      <<EOF
+列出所有 /cnb-* 命令：
+- /cnb-overview — 团队总览：谁在干什么、谁卡了
+- /cnb-watch <名字> — 看某个同学在干什么
+- /cnb-progress — 最近进展汇总
+- /cnb-history — 查看完整消息历史
+- /cnb-update — 更新 cnb 到最新版
 EOF
 
 # ---- Require interactive terminal ----
@@ -143,8 +224,14 @@ SYSPROMPT="你是 ${ME}。你的终端直接面对用户。
 工作方式：
 - 用户说想做什么，你拆任务分给同学，自己也干活。
 - 不要让用户跑命令。你直接用上面的命令操作。
-- 定期 inbox 看同学的回复，汇总进展给用户。
-- 用户可以用 /cs-help 查看所有协作命令。
-- 同学之间可以互相 send 消息协作，不用什么都通过你。"
+- 同学之间可以互相 send 消息协作，不用什么都通过你。
+- 用户可以用 /cnb-help 查看所有协作命令。
+
+重要 — 监控团队进展：
+派任务给同学后，你必须主动跟进，不要派完就忘。使用 Monitor 工具挂一个后台轮询：
+  Monitor 命令示例（每 30 秒检查一次 inbox，有新消息就通知你）：
+    last_count=0; while true; do out=\$(${BOARD} --as ${ME} inbox 2>&1); count=\$(echo \"\$out\" | grep -c '<message'); if [ \"\$count\" -gt \"\$last_count\" ]; then echo \"\$out\"; last_count=\$count; fi; sleep 30; done
+  设置 persistent: true，这样整个会话期间都会监控。
+收到通知后汇总进展给用户。派完任务后应立刻启动监控。"
 
 exec claude --name "${ME}" --append-system-prompt "$SYSPROMPT"

package/bin/dispatcher

@@ -6,8 +6,7 @@ Concerns (each with independent check intervals):
   SessionKeepAlive   — detect dead dev sessions
   IdleDetector       — batch screen snapshot comparison
   IdleKiller         — kill sessions idle >30min
-  IdleNudger         — nudge idle sessions to continue working
-  InboxNudger        — detect unread inboxes, nudge sessions
+  NudgeCoordinator   — unified nudge orchestrator (inbox/queued/idle)
   CoralPoker         — periodic heartbeat to dispatcher session
   HealthChecker      — periodic full status report + team idle detection
   BugSLAChecker      — check overdue bugs
@@ -39,8 +38,7 @@ from lib.concerns import (
     HealthChecker,
     IdleDetector,
     IdleKiller,
-    IdleNudger,
-    InboxNudger,
+    NudgeCoordinator,
     ResourceMonitor,
     SessionKeepAlive,
     TimeAnnouncer,
@@ -86,25 +84,39 @@ if not Path(cfg.board_sh).exists():
 # ---------------------------------------------------------------------------
 
 
+def _acquire_pidlock() -> Path:
+    pidfile = cfg.claudes_dir / "dispatcher.pid"
+    if pidfile.exists():
+        try:
+            old_pid = int(pidfile.read_text().strip())
+            os.kill(old_pid, 0)
+            print(f"FATAL: dispatcher already running (pid {old_pid})", file=sys.stderr)
+            sys.exit(1)
+        except (ValueError, ProcessLookupError, PermissionError):
+            pass
+    pidfile.write_text(str(os.getpid()))
+    return pidfile
+
+
 def main() -> None:
+    pidfile = _acquire_pidlock()
     base_interval = 2
 
     coral = CoralManager(cfg)
     idle = IdleDetector(cfg)
     poker = CoralPoker(cfg)
-    inbox = InboxNudger(cfg)
+    nudge = NudgeCoordinator(cfg, idle)
     throttle = AdaptiveThrottle()
-    file_watcher = FileWatcher(cfg, inbox)
+    file_watcher = FileWatcher(cfg, nudge)
 
-    # Order matters: idle must tick before idle_killer / idle_nudger
+    # Order matters: idle must tick before idle_killer / nudge_coordinator
     concerns: list[Concern] = [
         coral,
         TimeAnnouncer(cfg),
         idle,
         SessionKeepAlive(cfg),
         IdleKiller(cfg, idle, coral),
-        inbox,
-        IdleNudger(cfg, idle),
+        nudge,
         poker,
         BugSLAChecker(cfg, poker),
         HealthChecker(cfg, poker, coral),
@@ -131,8 +143,9 @@ def main() -> None:
         while running:
             now = int(time.time())
 
-            if not tmux_ok("has-session", "-t", cfg.coral_sess):
-                log("Coral session gone. Shutting down.")
+            any_alive = any(tmux_ok("has-session", "-t", f"{cfg.prefix}-{s}") for s in cfg.dev_sessions)
+            if not any_alive:
+                log("No dev sessions alive. Shutting down.")
                 break
 
             for c in concerns:
@@ -144,6 +157,7 @@ def main() -> None:
     finally:
         log("Shutting down...")
         file_watcher.stop()
+        pidfile.unlink(missing_ok=True)
         log("Stopped.")
 
 

package/bin/doctor

@@ -103,9 +103,7 @@ def check_foreign_keys(path: Path) -> bool:
     try:
         conn = sqlite3.connect(str(path))
         # PRAGMA foreign_keys is connection-level; check table definitions instead
-        rows = conn.execute(
-            "SELECT sql FROM sqlite_master WHERE type='table' AND sql LIKE '%REFERENCES%'"
-        ).fetchall()
+        rows = conn.execute("SELECT sql FROM sqlite_master WHERE type='table' AND sql LIKE '%REFERENCES%'").fetchall()
         conn.close()
         if rows:
             _ok(f"Foreign keys defined ({len(rows)} tables)")
@@ -288,7 +286,7 @@ def main() -> None:
         check_git()
         check_claude_cli()
         print("\nResult: project not initialized — run 'cnb init' first")
-        sys.exit(1)
+        raise SystemExit(1)
 
     print("=== cnb Doctor ===\n")
 
@@ -321,7 +319,7 @@ def main() -> None:
         print("✓ All checks passed.")
     else:
         print("⚠ Some checks failed — review warnings above.")
-        sys.exit(1)
+        raise SystemExit(1)
 
 
 if __name__ == "__main__":

package/bin/init

@@ -115,12 +115,11 @@ def _update_claude_md(project_dir: Path, snippet: str) -> None:
 
 
 def _hook_command(claudes_home: Path) -> str:
-    board = f"{claudes_home}/bin/board"
     return (
-        f'if [ -n "$CLAUDE_SESSION_NAME" ]; then '
-        f"unread=$({board} --as $CLAUDE_SESSION_NAME inbox 2>/dev/null "
-        f"| grep -oE '[0-9]+ 条未读' | head -1); "
-        f'[ -n "$unread" ] && echo "[inbox] $unread" || true; fi'
+        'if [ -n "$CLAUDE_SESSION_NAME" ] && [ -n "$CNB_PROJECT" ]; then '
+        "BOARD=$(grep '^claudes_home' \"$CNB_PROJECT/.claudes/config.toml\" 2>/dev/null "
+        "| cut -d'\"' -f2)/bin/board; "
+        '[ -x "$BOARD" ] && $BOARD --as $CLAUDE_SESSION_NAME pulse 2>/dev/null; fi'
     )
 
 
@@ -148,7 +147,8 @@ def _update_settings(project_dir: Path, claudes_home: Path) -> None:
     already = any(
         isinstance(h, dict)
         and any(
-            "board" in sub.get("command", "") and "inbox" in sub.get("command", "")
+            "board" in sub.get("command", "")
+            and ("pulse" in sub.get("command", "") or "inbox" in sub.get("command", ""))
             for sub in h.get("hooks", [])
             if isinstance(sub, dict)
         )
@@ -160,44 +160,6 @@ def _update_settings(project_dir: Path, claudes_home: Path) -> None:
     settings_path.write_text(json.dumps(settings, indent=2, ensure_ascii=False) + "\n")
 
 
-def _create_slash_commands(project_dir: Path, claudes_home: Path) -> None:
-    cmd_dir = project_dir / ".claude" / "commands"
-    cmd_dir.mkdir(parents=True, exist_ok=True)
-
-    board = f"{claudes_home}/bin/board"
-    swarm = f"{claudes_home}/bin/swarm"
-
-    commands = {
-        "cs-team": f"运行 `{swarm} status` 和 `{board} --as lead view`，用简洁的表格告诉我每个同学的状态。",
-        "cs-inbox": f"运行 `{board} --as lead inbox`，把收到的消息汇总给我。",
-        "cs-broadcast": f'把以下消息广播给所有同学：\n`{board} --as lead send all "$ARGUMENTS"`',
-        "cs-assign": f'把任务分配给指定同学。参数格式：<名字> <任务描述>\n解析 $ARGUMENTS，运行 `{board} --as lead send <名字> "<任务描述>"`',
-        "cs-kick": f"让指定同学下线。解析 $ARGUMENTS 拿到名字，运行 `{swarm} stop $ARGUMENTS`",
-        "cs-add": f"拉新同学上线。解析 $ARGUMENTS 拿到名字，运行 `{swarm} start $ARGUMENTS`",
-        "cs-log": f"查看指定同学最近的工作日志。解析 $ARGUMENTS 拿到名字，运行 `{board} --as lead view` 并重点关注该同学的状态和最近消息。",
-        "cs-stop": f"停掉所有后台同学。运行 `{swarm} stop`，告诉用户已全部下线。",
-        "cs-bugs": f"运行 `{board} --as lead bug list`，汇总当前所有 bug。",
-        "cs-history": f"运行 `{board} --as lead log 50`，把完整的消息历史展示给我。",
-        "cs-update": "运行 `pip install --upgrade cnb`，更新到最新版本。把结果告诉我，如果更新成功提醒用户重启 cnb 以生效。",
-        "cs-help": "列出所有 /cs-* 命令及用途：\n"
-        "- /cs-team — 看同学状态\n"
-        "- /cs-inbox — 查收消息\n"
-        "- /cs-broadcast <消息> — 广播\n"
-        "- /cs-assign <名字> <任务> — 派任务\n"
-        "- /cs-add <名字> — 拉同学上线\n"
-        "- /cs-kick <名字> — 让同学下线\n"
-        "- /cs-log <名字> — 看同学工作日志\n"
-        "- /cs-stop — 全部下线\n"
-        "- /cs-bugs — 看 bug 列表\n"
-        "- /cs-history — 查看完整消息历史\n"
-        "- /cs-update — 更新到最新版\n"
-        "- /cs-help — 本帮助",
-    }
-
-    for name, content in commands.items():
-        (cmd_dir / f"{name}.md").write_text(content + "\n")
-
-
 DEFAULT_SESSIONS = ["s1", "s2", "s3"]
 
 
@@ -286,11 +248,11 @@ def main() -> None:
         persona = personas.get(n, "")
         conn.execute("INSERT OR IGNORE INTO sessions(name, persona) VALUES (?, ?)", (n, persona))
         persona_section = f"\n## Persona\n{persona}\n" if persona else ""
-        md_content = f"# {n}\n{persona_section}\n## Current task\n(none)\n\n## @inbox\n"
+        md_content = f"# {n}\n{persona_section}\n## Current task\n(none)\n"
         (claudes_dir / "sessions" / f"{n}.md").write_text(md_content)
     conn.execute("INSERT OR IGNORE INTO meta(key, value) VALUES ('dispatcher_session', 'dispatcher')")
     # Record schema version so migration runner knows where we are
-    conn.execute("INSERT OR IGNORE INTO meta(key, value) VALUES ('schema_version', '2')")
+    conn.execute("INSERT OR IGNORE INTO meta(key, value) VALUES ('schema_version', '4')")
     conn.commit()
     conn.close()
 
@@ -302,12 +264,16 @@ def main() -> None:
         print(f"Applied {applied} schema migration(s).")
 
     # .gitignore for generated stuff
-    gitignore_content = "board.db\nboard.db-shm\nboard.db-wal\nlogs/\n"
+    gitignore_content = "board.db\nboard.db-shm\nboard.db-wal\nlogs/\ndispatcher.pid\n"
     (claudes_dir / ".gitignore").write_text(gitignore_content)
 
     # Update .claude/settings.json (merge hooks if exists, create if not)
     _update_settings(project_dir, claudes_home)
 
+    # Write multi-agent coordination section into CLAUDE.md
+    snippet = _claude_md_snippet(sessions, claudes_home, personas)
+    _update_claude_md(project_dir, snippet)
+
     sessions_str = " ".join(sessions)
     print(f"Initialized cnb (sessions: {sessions_str})")