[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"tool-bfly123--claude_code_bridge":3,"similar-bfly123--claude_code_bridge":138},{"id":4,"github_repo":5,"name":6,"description_en":7,"description_zh":8,"ai_summary_zh":8,"readme_en":9,"readme_zh":10,"quickstart_zh":11,"use_case_zh":12,"hero_image_url":13,"owner_login":14,"owner_name":15,"owner_avatar_url":16,"owner_bio":15,"owner_company":15,"owner_location":15,"owner_email":15,"owner_twitter":15,"owner_website":15,"owner_url":17,"languages":18,"stars":35,"forks":36,"last_commit_at":37,"license":38,"difficulty_score":39,"env_os":40,"env_gpu":41,"env_ram":41,"env_deps":42,"category_tags":47,"github_topics":52,"view_count":39,"oss_zip_url":15,"oss_zip_packed_at":15,"status":64,"created_at":65,"updated_at":66,"faqs":67,"releases":107},9100,"bfly123\u002Fclaude_code_bridge","claude_code_bridge","Real-time multi-AI collaboration: Claude, Codex & Gemini with persistent context, minimal token overhead","claude_code_bridge（简称 CCB）是一款专为终端设计的原生多智能体协作运行时。它允许开发者在分屏界面中同时运行 Claude、Codex、Gemini 等多个 AI 模型，让每个智能体拥有独立的角色、任务流和个性，并能通过内置的稳定通信层相互协作与委托任务。\n\n传统 AI 辅助编程往往局限于单线对话，难以处理复杂的项目级任务。CCB 解决了这一痛点，将“并行智能体”从概念变为现实。它不仅实现了多个 AI 在同一项目中的可见并发操作，还支持全局广播同步或点对点精准指派，极大提升了代码编写、审查及测试的效率。此外，其独特的配置系统允许用户灵活定义窗口布局，甚至为特定智能体分配独立的 Git 工作树以避免冲突。\n\n这款工具非常适合需要高效管理复杂开发流程的软件工程师、技术研究人员及开源贡献者。如果你希望摆脱单一 AI 助手的局限，构建一个由不同专长 AI 组成的自动化协作团队，claude_code_bridge 将是一个强大的选择。它让每一次交互都清晰可见，让每一个模型都可控可调，真正实现了本地化的无限并行智能体协作。","\u003Cdiv align=\"center\">\n\n# CCB v6(Linux) - Infinite Parallel Agents Edition\n\n**Native multi-agent runtime for terminal split panes**\n**Claude · Codex · Gemini · OpenCode · Droid**\n**Visible concurrency, native communication, project-scoped runtime**\n\n\u003Cp>\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FEvery_Interaction_Visible-096DD9?style=for-the-badge\" alt=\"Every Interaction Visible\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FEvery_Model_Controllable-CF1322?style=for-the-badge\" alt=\"Every Model Controllable\">\n\u003C\u002Fp>\n\n[![Version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-6.0.4-orange.svg)]()\n[![Platform](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]()\n\n**English** | [Chinese](README_zh.md)\n\n![Showcase](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbfly123_claude_code_bridge_readme_7542b41dfe47.png)\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Demo animations\u003C\u002Fb>\u003C\u002Fsummary>\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbfly123_claude_code_bridge_readme_0c399c6f49b0.gif\" alt=\"Any-terminal collaboration demo\" width=\"900\">\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbfly123_claude_code_bridge_readme_339950536708.gif\" alt=\"VS Code integration demo\" width=\"900\">\n\n\u003C\u002Fdetails>\n\n\u003C\u002Fdiv>\n\n---\n\n**Introduction:** CCB v6 is the infinite parallel agents edition. It turns split-pane collaboration into a native multi-agent runtime where agents can run side by side, hold independent roles and personalities, and delegate to each other through a stable built-in communication layer.\n\n## Why Parallel Agents Matter\n\nParallel agents are not just \"more panes on screen\". In CCB, each agent can own a fully independent role, task stream, skill library, and personality.\n\nCCB provides the runtime foundation for stable agent-to-agent communication and effectively unbounded delegation. It supports arbitrary agent naming and window arrangement, per-agent control, broadcast dispatch, and point-to-point communication.\n\n## 🚀 User Commands\n\n- `ccb` open CCB in the project directory from the terminal\n- `ccb -s` safe mode\n- `ccb -n` rebuild the project `.ccb` state\n- `ccb kill` close CCB\n- `ccb kill -f` deep-clean exit\n\n## 💬 Communication Usage\n\nInside a provider \u002F agent runtime:\n\n- `\u002Fask all \"sync on the latest repo state\"` broadcasts one message to all live agents.\n- `\u002Fask reviewer \"review the new parser change\"` sends work to the named `[reviewer]` agent.\n\nTypical pattern:\n\n- use `ask all` for one-shot broadcast or global sync\n- use `ask agent_name` for targeted delegation\n- use implicit skill-based calls; agents invoke `ask` themselves, and skills are currently auto-installed into Codex, Claude, and other providers\n- if you only occasionally need to inspect replies manually, `pend` and `watch` are secondary tools\n\n## 🛠 Config Control\n\n`ccb` is controlled by `.ccb\u002Fccb.config`. That file defines agent names, pane layout, and whether an agent runs `inplace` or in a separate git worktree.\n\nQuick rules:\n\n- `agent_name:provider` defines one agent. `agent_name` is also the pane label and logical runtime name.\n- `cmd` adds one shell pane.\n- `;` splits panes horizontally from left to right.\n- `,` splits panes vertically from top to bottom.\n- Default workspace mode is `inplace`. If one agent needs an isolated git worktree to avoid conflicts, write `agent_name:provider(worktree)`.\n\nExample:\n\n```text\ncmd; writer:codex, reviewer:claude; qa:gemini(worktree)\n```\n\nThis layout means:\n\n- left pane: `cmd`\n- right side: a vertical stack\n- top-right pane: `writer`\n- bottom-right side: a horizontal split between `reviewer` and `qa`\n- `qa` runs in an isolated git worktree; `writer` and `reviewer` run inplace in the main project\n\n\u003Ch2 align=\"center\">🚀 What's New\u003C\u002Fh2>\n\nHistorical note: older release notes below may mention `askd`, legacy flags, or removed commands. Those references are kept only as changelog history and do not redefine the current CLI surface.\n\n\u003Cdetails open>\n\u003Csummary>\u003Cb>v6.0.4\u003C\u002Fb> - Legacy Update Compatibility Hotfix\u003C\u002Fsummary>\n\n- **Backward-Compatible Release Assets**: Linux release tarballs now include a compatibility alias so older 6.x updaters can still find the extracted installer path\n- **Old Clients Can Upgrade Again**: existing `v6.0.1` and `v6.0.2` installs can now update to the latest stable release without needing a patched local updater first\n- **Modern Updater Still Clean**: current runtime keeps the correct extracted-directory resolution and does not depend on the legacy alias\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v6.0.3\u003C\u002Fb> - Self-Update Tarball Hotfix\u003C\u002Fsummary>\n\n- **Release Upgrade Fixed**: `ccb update` now resolves the extracted release directory correctly instead of treating the `.tar.gz` asset name as a folder\n- **Installer Handoff Restored**: self-update now finds `install.sh` inside extracted release assets and completes end to end\n- **Release Build Hygiene**: Linux release packaging now ignores local `.ccb-requests\u002F` residue so official builds are reproducible\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v6.0.2\u003C\u002Fb> - Caller Attribution, Mailbox Routing, and macOS Install Warning\u003C\u002Fsummary>\n\n- **Correct Caller Identity**: `ccb ask` now preserves the real originating agent so replies return to the right mailbox instead of being attributed as `user`\n- **Stable Reply Routing**: async replies for delegated jobs now land back in the expected mailbox chain, including `cmd`-anchored flows\n- **Mixed-Case Agent Recovery**: config layout recovery no longer drifts when configured agent names use mixed case\n- **macOS Homebrew Warning**: `install.sh` now warns clearly when Homebrew is missing before users try to install tmux and other dependencies\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v6.0.1\u003C\u002Fb> - Release Archive Hygiene & Safer Upgrade Extraction\u003C\u002Fsummary>\n\n- **Source Archive Cleanup**: Removed accidentally tracked pytest temp artifacts so GitHub source archives are clean again\n- **Safer Tar Validation**: Upgrade extraction now rejects unsafe symlink targets before unpacking\n- **Clearer Failure Mode**: Unsafe archive extraction errors now point users toward release assets or clean source archives\n- **Regression Coverage**: Added tests to block ephemeral repo artifacts from being tracked again\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v6.0.0\u003C\u002Fb> - Native Multi-Agent Runtime, Stable Native Communication, and Linux-Only Auto Upgrade\u003C\u002Fsummary>\n\n**🚀 New Runtime Direction:**\n- **Infinite Parallel Agent Foundation**: CCB v6 is built as the runtime base for effectively unbounded agent-to-agent delegation and orchestration\n- **Independent Agent Identity**: agents can carry different roles, task ownership, skill libraries, and personalities\n- **Focused User Command Surface**: the public user workflow stays centered on `ccb`, `ccb -s`, `ccb -n`, `ccb kill`, and `ccb kill -f`\n\n**🧱 Project Rebuild Semantics:**\n- **Config-Preserving Legacy Cleanup**: On first `ccb` inside a pre-6 project, CCB preserves `.ccb\u002Fccb.config`, removes the rest of the old `.ccb` runtime state, and rebuilds locally\n- **Runtime Marker**: Modern projects now record `.ccb\u002Fproject-runtime.json` so current runtime state is distinguished from legacy state\n- **Worktree Safety Guard**: Dirty or unmerged CCB-managed worktrees still block destructive rebuilds until the user resolves them\n\n**🔄 Upgrade Policy:**\n- **Linux\u002FWSL Only**: `ccb update` is now available only on Linux\u002FWSL for the 6.x line\n- **Release-Only Upgrades**: Source tags are still published with each version, but `ccb update` for 6.x installs the GitHub release asset, not the source archive\n- **Stable Release Targeting**: Default upgrades now resolve to the latest stable release instead of the moving `main` branch\n- **Major Upgrade Confirmation**: Upgrading into `6.0.0` requires explicit confirmation before replacing the installed runtime\n\n**🤖 Provider Reliability:**\n- **Gemini Multi-Round Stability**: Gemini completion polling now waits through tool activity and no longer exits on the first stable planning sentence\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.3.0\u003C\u002Fb> - Simplified CLI, Explicit Worktree Mode, and Gemini Completion Stability\u003C\u002Fsummary>\n\n**🚀 User-Facing CLI Simplification:**\n- **Narrowed Main Surface**: Public startup flow is now `ccb`, `ccb -s`, `ccb -n`, `ccb kill`, and `ccb kill -f`\n- **Model Control Plane Still Available**: `ask`, `ping`, `pend`, and `watch` remain for agent-to-agent orchestration without cluttering primary help\n\n**🧱 Workspace Semantics Made Explicit:**\n- **Default Inplace Mode**: Compact `ccb.config` entries now expand to `workspace_mode='inplace'`\n- **Opt-In Isolation**: Use `agent:provider(worktree)` when an agent must run in its own git worktree\n- **Safe Agent Churn**: Adding agents no longer disturbs existing worktrees; removing or renaming worktree agents retires clean branches and blocks on dirty or unmerged ones\n\n**🛠 Recovery & Reset Hardening:**\n- **Config-Preserving Reset**: `ccb -n` rebuilds project runtime state while keeping `.ccb\u002Fccb.config`\n- **Stale Registration Cleanup**: Start and reset now prune missing registered git worktrees before rematerialization\n- **Kill Warnings**: `ccb kill` warns clearly when a worktree agent still has unmerged or dirty state\n\n**🤖 Gemini Completion Fix:**\n- **No Early Stop on Planning Text**: Gemini completion polling now tracks tool-call activity and waits for the real final reply instead of finishing on the first stable “I will ...” message\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.2.6\u003C\u002Fb> - Async Communication & Gemini 0.29 Compatibility\u003C\u002Fsummary>\n\n**🔧 Gemini CLI 0.29.0 Support:**\n- **Dual Hash Strategy**: Session path discovery now supports both basename and SHA-256 formats\n- **Autostart**: `ccb-ping` and `ccb-mounted` gain `--autostart` flag to launch offline provider daemons\n- **Cleanup Path**: zombie-session cleanup is now handled by `ccb kill -f`\n\n**🔗 Async Communication Fixes:**\n- **OpenCode Deadlock**: Fixed session ID pinning that caused second async call to always fail\n- **Legacy Completion Compatibility**: Legacy text-based providers still tolerate mismatched `CCB_DONE` lines in degraded mode\n- **req_id Regex**: `opencode_comm.py` now matches both old hex and new timestamp-based formats\n- **Gemini Idle Timeout**: Auto-detect reply completion when Gemini omits `CCB_DONE` marker (15s idle, configurable via `CCB_GEMINI_IDLE_TIMEOUT`)\n- **Gemini Prompt Hardening**: Stronger instructions to reduce `CCB_DONE` omission rate\n\n**🛠 Other Fixes:**\n- **lpend**: Prefers fresh Claude session path when registry is stale\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.2.5\u003C\u002Fb> - Async Guardrail Hardening\u003C\u002Fsummary>\n\n**🔧 Async Turn-Stop Fix:**\n- **Global Guardrail**: Added mandatory `Async Guardrail` rule to `claude-md-ccb.md` — covers both `\u002Fask` skill and direct `Bash(ask ...)` calls\n- **Marker Consistency**: `bin\u002Fask` now emits `[CCB_ASYNC_SUBMITTED provider=xxx]` matching all other provider scripts\n- **DRY Skills**: Ask skill rules reference global guardrail with local fallback, single source of truth\n\nThis fix prevents Claude from polling\u002Fsleeping after submitting async tasks.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.2.3\u003C\u002Fb> - Project-Local History & Legacy Compatibility\u003C\u002Fsummary>\n\n**📂 Project-Local History:**\n- **Local Storage**: Auto context exports now save to `.\u002F.ccb\u002Fhistory\u002F` per project\n- **Safe Scope**: Auto transfer runs only for the current working directory\n- **Claude \u002Fcontinue**: New skill to attach the latest history file via `@`\n\n**🧩 Legacy Compatibility:**\n- **Auto Migration**: `.ccb_config` is detected and upgraded to `.ccb` when possible\n- **Fallback Lookup**: Legacy sessions still resolve cleanly during transition\n\nThese changes keep handoff artifacts scoped to the project and make upgrades smoother.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.2.2\u003C\u002Fb> - Session Switch Capture & Context Transfer\u003C\u002Fsummary>\n\n**🔁 Session Switch Tracking:**\n- **Old Session Fields**: `.claude-session` now records `old_claude_session_id` \u002F `old_claude_session_path` with `old_updated_at`\n- **Auto Context Export**: Previous Claude session is automatically extracted to `.\u002F.ccb\u002Fhistory\u002Fclaude-\u003Ctimestamp>-\u003Cold_id>.md`\n- **Cleaner Transfers**: Noise filtering removes protocol markers and guardrails while keeping tool-only actions\n\nThese updates make session handoff more reliable and easier to audit.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.2.1\u003C\u002Fb> - Enhanced Ask Command Stability\u003C\u002Fsummary>\n\n**🔧 Stability Improvements:**\n- **Watchdog File Monitoring**: Real-time session updates with efficient file watching\n- **Mandatory Caller Field**: Improved request tracking and routing reliability\n- **Unified Execution Model**: Simplified ask skill execution across all platforms\n- **Auto-Dependency Installation**: Watchdog library installed automatically during setup\n- **Session Registry**: Enhanced Claude adapter with automatic session monitoring\n\nThese improvements significantly enhance the reliability of cross-AI communication and reduce session binding failures.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.2.0\u003C\u002Fb> - Historical mail bridge release\u003C\u002Fsummary>\n\nThis release introduced the old mail gateway path. That flow is now removed from the supported agent-first surface and remains legacy code only during cleanup.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.1.3\u003C\u002Fb> - Tmux Claude Ask Stability\u003C\u002Fsummary>\n\n**🔧 Fixes & Improvements:**\n- **tmux Claude ask**: read replies from pane output with automatic pipe-pane logging for more reliable completion\n\nSee [CHANGELOG.md](CHANGELOG.md) for full details.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.1.2\u003C\u002Fb> - Daemon & Hooks Reliability\u003C\u002Fsummary>\n\n**🔧 Fixes & Improvements:**\n- **Claude Completion Hook**: Unified askd now triggers completion hook for Claude\n- **askd Lifecycle**: askd is bound to CCB lifecycle to avoid stale daemons\n- **Mounted Detection**: `ccb-mounted` uses ping-based detection across all platforms\n- **State File Lookup**: `askd_client` falls back to `CCB_RUN_DIR` for daemon state files\n\nSee [CHANGELOG.md](CHANGELOG.md) for full details.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.1.1\u003C\u002Fb> - Unified Daemon + Bug Fixes\u003C\u002Fsummary>\n\n**🔧 Bug Fixes & Improvements:**\n- **Unified Daemon**: All providers now use unified askd daemon architecture\n- **Install\u002FUninstall**: Fixed installation and uninstallation bugs\n- **Process Management**: Fixed kill\u002Ftermination issues\n\nSee [CHANGELOG.md](CHANGELOG.md) for full details.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.1.0\u003C\u002Fb> - Unified Command System + Historical Native Windows Experiment\u003C\u002Fsummary>\n\n**🚀 Unified Commands** - Replace provider-specific commands with agent-first workflows:\n\n| Old Commands | New Unified Command |\n|--------------|---------------------|\n| `cask`, `gask`, `oask`, `dask`, `lask` | `ccb ask \u003Cagent> [from \u003Csender>] \u003Cmessage>` |\n| `cping`, `gping`, `oping`, `dping`, `lping` | `ccb ping \u003Cagent\\|all>` |\n| `cpend`, `gpend`, `opend`, `dpend`, `lpend` | `ccb pend \u003Cagent\\|job_id> [N]` |\n\n**Supported providers:** `gemini`, `codex`, `opencode`, `droid`, `claude`\n\n**🪟 Historical native Windows experiment:**\n- Earlier releases explored a native Windows split-pane path\n- Background execution used PowerShell + `DETACHED_PROCESS`\n- Large payload delivery used stdin-based handoff\n- That backend has since been removed; future native Windows mux support is being redesigned around `psmux`\n\n**📦 New Skills:**\n- `\u002Fask \u003Cagent> \u003Cmessage>` - Send work to a named agent\n- `\u002Fping \u003Cagent|all>` - Check mounted agent health\n- `\u002Fpend \u003Cagent|job_id> [N]` - View latest agent reply\n\nSee [CHANGELOG.md](CHANGELOG.md) for full details.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.0.6\u003C\u002Fb> - Zombie session cleanup + mounted skill optimization\u003C\u002Fsummary>\n\n- **Zombie Cleanup**: `ccb kill -f` now cleans up orphaned tmux sessions globally (sessions whose parent process has exited)\n- **Mounted Skill**: Optimized to use `pgrep` for daemon detection (~4x faster), extracted to standalone `ccb-mounted` script\n- **Droid Skills**: Added full skill set (cask\u002Fgask\u002Flask\u002Foask + ping\u002Fpend variants) to `droid_skills\u002F`\n- **Install**: Added `install_droid_skills()` to install Droid skills to `~\u002F.droid\u002Fskills\u002F`\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.0.5\u003C\u002Fb> - Droid delegation tools + setup\u003C\u002Fsummary>\n\n- **Droid**: Adds delegation tools (`ccb_ask_*` plus `cask\u002Fgask\u002Flask\u002Foask` aliases).\n- **Setup**: New `ccb droid setup-delegation` command for MCP registration.\n- **Installer**: Auto-registers Droid delegation when `droid` is detected (opt-out via env).\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Details & usage\u003C\u002Fb>\u003C\u002Fsummary>\n\nUsage:\n```\n\u002Fall-plan \u003Crequirement>\n```\n\nExample:\n```\n\u002Fall-plan Design a caching layer for the API with Redis\n```\n\nHighlights:\n- Socratic Ladder + Superpowers Lenses + Anti-pattern analysis.\n- Availability-gated dispatch (use only mounted CLIs).\n- Two-round reviewer refinement with merged design.\n\n\u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.0.0\u003C\u002Fb> - Any AI as primary driver\u003C\u002Fsummary>\n\n- **Claude Independence**: No need to start Claude first; Codex can act as the primary CLI.\n- **Unified Control**: Single entry point controls Claude\u002FOpenCode\u002FGemini.\n- **Simplified Launch**: Dropped `ccb up`; use `ccb ...` or the default `ccb.config`.\n- **Flexible Mounting**: More flexible pane mounting and session binding.\n- **Default Config**: Auto-create `ccb.config` when missing.\n- **Project askd Autostart**: project askd and provider runtimes auto-start in the project tmux namespace when needed.\n- **Session Robustness**: PID liveness checks prevent stale sessions.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v4.0\u003C\u002Fb> - tmux-first refactor\u003C\u002Fsummary>\n\n- **Full Refactor**: Cleaner structure, better stability, and easier extension.\n- **Terminal Runtime Cleanup**: The runtime moved toward a single tmux-oriented pane\u002Fcontrol model instead of parallel terminal backends.\n- **Perfect tmux Experience**: Stable layouts + pane titles\u002Fborders + session-scoped theming.\n- **Works in Any Terminal**: If your terminal can run tmux, CCB can provide the full multi-model split experience.\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v3.0\u003C\u002Fb> - Smart daemons\u003C\u002Fsummary>\n\n- **True Parallelism**: Submit multiple tasks to Codex, Gemini, or OpenCode simultaneously.\n- **Cross-AI Orchestration**: Claude and Codex can now drive OpenCode agents together.\n- **Bulletproof Stability**: Daemons auto-start on first request and stop after idle.\n- **Chained Execution**: Codex can delegate to OpenCode for multi-step workflows.\n- **Smart Interruption**: Gemini tasks handle interruption safely.\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Details\u003C\u002Fb>\u003C\u002Fsummary>\n\n\u003Cdiv align=\"center\">\n\n![Parallel](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FStrategy-Parallel_Queue-blue?style=flat-square)\n![Stability](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDaemon-Auto_Managed-green?style=flat-square)\n![Interruption](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGemini-Interruption_Aware-orange?style=flat-square)\n\n\u003C\u002Fdiv>\n\n\u003Ch3 align=\"center\">✨ Key Features\u003C\u002Fh3>\n\n- **🔄 True Parallelism**: Submit multiple tasks to Codex, Gemini, or OpenCode simultaneously. Provider runtimes queue and execute them serially, ensuring no context pollution.\n- **🤝 Cross-AI Orchestration**: Claude and Codex can now simultaneously drive OpenCode agents. All requests are arbitrated by the project askd layer.\n- **🛡️ Bulletproof Stability**: The runtime layer is self-managing. It starts on first use and shuts down after idleness to save resources.\n- **⚡ Chained Execution**: Advanced workflows supported! Codex can autonomously call `oask` to delegate sub-tasks to OpenCode models.\n- **🛑 Smart Interruption**: Gemini tasks now support intelligent interruption detection, automatically handling stops and ensuring workflow continuity.\n\n\u003Ch3 align=\"center\">🧩 Feature Support Matrix\u003C\u002Fh3>\n\n| Feature | Codex | Gemini | OpenCode |\n| :--- | :---: | :---: | :---: |\n| **Parallel Queue** | ✅ | ✅ | ✅ |\n| **Interruption Awareness** | ✅ | ✅ | - |\n| **Response Isolation** | ✅ | ✅ | ✅ |\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>📊 View Real-world Stress Test Results\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n\u003Cbr>\n\n**Scenario 1: Claude & Codex Concurrent Access to OpenCode**\n*Both agents firing requests simultaneously, perfectly coordinated by the daemon.*\n\n| Source | Task | Result | Status |\n| :--- | :--- | :--- | :---: |\n| 🤖 Claude | `CLAUDE-A` | **CLAUDE-A** | 🟢 |\n| 🤖 Claude | `CLAUDE-B` | **CLAUDE-B** | 🟢 |\n| 💻 Codex | `CODEX-A` | **CODEX-A** | 🟢 |\n| 💻 Codex | `CODEX-B` | **CODEX-B** | 🟢 |\n\n**Scenario 2: Recursive\u002FChained Calls**\n*Codex autonomously driving OpenCode for a 5-step workflow.*\n\n| Request | Exit Code | Response |\n| :--- | :---: | :--- |\n| **ONE** | `0` | `CODEX-ONE` |\n| **TWO** | `0` | `CODEX-TWO` |\n| **THREE** | `0` | `CODEX-THREE` |\n| **FOUR** | `0` | `CODEX-FOUR` |\n| **FIVE** | `0` | `CODEX-FIVE` |\n\n\u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\n---\n\n## 🚀 Quick Start\n\n**Step 1:** Use a tmux-capable environment (`tmux` on Linux\u002FmacOS\u002FWSL)\n\n**Step 2:** Choose installer based on your environment:\n\n\u003Cdetails open>\n\u003Csummary>\u003Cb>Linux\u003C\u002Fb>\u003C\u002Fsummary>\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge.git\ncd claude_code_bridge\n.\u002Finstall.sh install\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>macOS\u003C\u002Fb>\u003C\u002Fsummary>\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge.git\ncd claude_code_bridge\n.\u002Finstall.sh install\n```\n\n> **Note:** If commands not found after install, see [macOS Troubleshooting](#-macos-installation-guide).\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>WSL (Windows Subsystem for Linux)\u003C\u002Fb>\u003C\u002Fsummary>\n\n> Use this if your Claude\u002FCodex\u002FGemini runs in WSL.\n\n> **⚠️ WARNING:** Do NOT install or run ccb as root\u002Fadministrator. Switch to a normal user first (`su - username` or create one with `adduser`).\n\n```bash\n# Run inside WSL terminal (as normal user, NOT root)\ngit clone https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge.git\ncd claude_code_bridge\n.\u002Finstall.sh install\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Windows Native\u003C\u002Fb>\u003C\u002Fsummary>\n\n> Use this if your Claude\u002FCodex\u002FGemini runs natively on Windows.\n\n> Native Windows mux runtime is being redesigned around `psmux`. The stable split-pane path in this branch is still Linux\u002FmacOS\u002FWSL + `tmux`.\n\n```powershell\ngit clone https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge.git\ncd claude_code_bridge\npowershell -ExecutionPolicy Bypass -File .\\install.ps1 install\n```\n\n- The installer prefers `pwsh.exe` (PowerShell 7+) when available, otherwise `powershell.exe`.\n\n\u003C\u002Fdetails>\n\n### Run\n```bash\nccb                              # Start default agents from .ccb\u002Fccb.config\nccb -s                           # Safe start: keep configured\u002Fmanual permission behavior\nccb -n                           # Rebuild .ccb except ccb.config, then start fresh\nccb kill                         # Stop this project's background runtime\nccb kill -f                      # Force cleanup before rebuilding state\n\ntmux tip: CCB's tmux status\u002Fpane theming is enabled only while CCB is running.\ntmux tip: press `Ctrl+b` then `Space` to cycle tmux layouts. You can press it repeatedly to keep switching layouts.\n\nLayout rule: the last selected agent runs in the current pane. Extras are ordered by the selected target list; the first extra goes to the top-right, then the left column fills top-to-bottom, then the right column fills top-to-bottom.\nNote: `ccb up` is removed; use `ccb ...` with `.ccb\u002Fccb.config`.\n```\n\n### Flags\n| Flag | Description | Example |\n| :--- | :--- | :--- |\n| `-s` | Safe start; disable CLI auto-permission override | `ccb -s` |\n| `-n` | Rebuild `.ccb` except `ccb.config`, then start fresh | `ccb -n` |\n| `-h` | Show help information | `ccb -h` |\n| `-v` | Show version and check for updates | `ccb -v` |\n\n### ccb.config\nDefault lookup order:\n- `.ccb\u002Fccb.config` (project)\n- `~\u002F.ccb\u002Fccb.config` (global)\n\nCompact format only:\n```text\nwriter:codex,reviewer:claude\n```\n\nEnable cmd pane (default title\u002Fcommand):\n```text\nagent1:codex,agent2:codex,agent3:claude,cmd\n```\n\nRules:\n- Each agent entry must be `agent_name:provider`.\n- `cmd` is a reserved standalone token for the shell pane, not an agent name.\n- `;` splits panes horizontally from left to right.\n- `,` splits panes vertically from top to bottom.\n- `(...)` groups part of the layout explicitly.\n- Each agent entry expands to fixed defaults: `target='.'`, `workspace_mode='inplace'`, `restore='auto'`, `permission='manual'`.\n- Use `agent_name:provider(worktree)` when you want that agent isolated in its own git worktree.\n- Missing project config is auto-created as `codex:codex,claude:claude`.\n- Cmd pane participates in the layout as the first extra pane and does not change which AI runs in the current pane.\n\n### Update\nCCB v6 currently supports `ccb update` only on Linux\u002FWSL. A major upgrade fully replaces the installed runtime. On the first `ccb` inside an older project, CCB preserves `.ccb\u002Fccb.config`, clears the rest of the old `.ccb` state, and rebuilds locally.\n\n```bash\nccb update              # Update to the latest stable release\nccb update 6            # Update to the highest v6.x.x version\nccb update 6.0          # Update to the highest v6.0.x version\nccb update 6.0.4        # Update to a specific version\nccb uninstall           # Uninstall ccb and clean configs\nccb reinstall           # Clean then reinstall ccb\n```\n\n---\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🪟 Windows Environment Guide\u003C\u002Fb>\u003C\u002Fsummary>\n\n> **Key Point:** `ccb` and the underlying agent CLIs must run in the **same environment**. The most common issue is environment mismatch causing project startup or agent attach to fail.\n\nNote: The installers also install OS-specific `SKILL.md` variants for Claude\u002FCodex skills:\n- Linux\u002FmacOS\u002FWSL: bash heredoc templates (`SKILL.md.bash`)\n- Native Windows: PowerShell here-string templates (`SKILL.md.powershell`)\n\n### 1) Current backend status\n\n- The active multi-pane runtime in this branch is `tmux` only.\n- Stable split-pane usage today means Linux\u002FmacOS\u002FWSL with `tmux`.\n- Native Windows mux support is being redesigned around `psmux`; see [docs\u002Fccbd-windows-psmux-plan.md](docs\u002Fccbd-windows-psmux-plan.md).\n\n### 2) How to Identify Your Environment\n\nDetermine based on **how you installed\u002Frun Claude Code\u002FCodex**:\n\n- **WSL Environment**\n  - You installed\u002Frun via WSL terminal (Ubuntu\u002FDebian) using `bash` (e.g., `curl ... | bash`, `apt`, `pip`, `npm`)\n  - Paths look like: `\u002Fhome\u002F\u003Cuser>\u002F...` and you may see `\u002Fmnt\u002Fc\u002F...`\n  - Verify: `cat \u002Fproc\u002Fversion | grep -i microsoft` has output, or `echo $WSL_DISTRO_NAME` is non-empty\n\n- **Native Windows Environment**\n  - You installed\u002Frun via Windows Terminal \u002F PowerShell \u002F CMD (e.g., `winget`, PowerShell scripts)\n  - Paths look like: `C:\\Users\\\u003Cuser>\\...`\n\n### 3) Recommended path today\n\n- If you want the stable split-pane\u002Fruntime supervision path, run `ccb` and all agent CLIs inside WSL, then use `tmux`.\n- If your tools currently run natively on Windows, keep that environment consistent, but treat native split-pane orchestration as transitional until `psmux` lands.\n\n### 4) Troubleshooting: `ccb` Not Starting Correctly\n\n- **Most common:** Environment mismatch (ccb in WSL but codex in native Windows, or vice versa)\n- **tmux not available:** Install `tmux` in the environment where you run `ccb`\n- **Terminal not refreshed:** Restart the shell after installation so PATH changes are visible\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🍎 macOS Installation Guide\u003C\u002Fb>\u003C\u002Fsummary>\n\n### Command Not Found After Installation\n\nIf `ccb` is not found after running `.\u002Finstall.sh install`:\n\n**Cause:** The install directory (`~\u002F.local\u002Fbin`) is not in your PATH.\n\n**Solution:**\n\n```bash\n# 1. Check if install directory exists\nls -la ~\u002F.local\u002Fbin\u002F\n\n# 2. Check if PATH includes the directory\necho $PATH | tr ':' '\\n' | grep local\n\n# 3. Check shell config (macOS defaults to zsh)\ncat ~\u002F.zshrc | grep local\n\n# 4. If not configured, add manually\necho 'export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"' >> ~\u002F.zshrc\n\n# 5. Reload config\nsource ~\u002F.zshrc\n```\n\n### tmux Shell Not Detecting Commands\n\nIf a shell started inside tmux cannot find ccb commands but a regular Terminal can:\n\n- tmux may be starting a different shell init path\n- Add PATH to `~\u002F.zprofile` as well:\n\n```bash\necho 'export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"' >> ~\u002F.zprofile\n```\n\nThen restart the tmux server completely:\n\n```bash\ntmux kill-server\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## 🗣️ Usage\n\nOnce started, collaborate naturally. Claude will detect when to delegate tasks.\n\n**Common Scenarios:**\n\n- **Code Review:** *\"Have Codex review the changes in `main.py`.\"*\n- **Second Opinion:** *\"Ask Gemini for alternative implementation approaches.\"*\n- **Pair Programming:** *\"Codex writes the backend logic, I'll handle the frontend.\"*\n- **Architecture:** *\"Let Codex design the module structure first.\"*\n- **Info Exchange:** *\"Fetch 3 rounds of Codex conversation and summarize.\"*\n\n### 🎴 Fun & Creative: AI Poker Night!\n\n> *\"Let Claude, Codex and Gemini play Dou Di Zhu! You deal the cards, everyone plays open hand!\"*\n>\n> 🃏 Claude (Landlord) vs 🎯 Codex + 💎 Gemini (Farmers)\n\n> **Note:** The public project runtime workflow in CCB v6 is intentionally small: `ccb`, `ccb -s`, `ccb -n`, `ccb kill`, and `ccb kill -f`. Internal control-plane commands still exist for agent-side orchestration, but they are not part of the user-facing startup\u002Freset surface.\n\n---\n\n## 🛠️ User-Facing CLI\n\nThe public project runtime workflow in CCB v6 is intentionally reduced to five primary commands:\n\n- **`ccb`** - Default start path; launch agents defined by `.ccb\u002Fccb.config`\n- **`ccb -s`** - Safe start; keep each agent's configured\u002Fdefault permission behavior\n- **`ccb -n`** - Rebuild project `.ccb` state except `ccb.config`, then start fresh with confirmation\n- **`ccb kill`** - Stop the current project's runtime\n- **`ccb kill -f`** - Force cleanup project-owned runtime residue before `ccb -n`\n  - Also works as a recovery path when `.ccb` exists but `ccb.config` is missing or stale\n\nInternal control-plane commands still exist for model-side orchestration and automation, but they are intentionally not presented here as public user commands.\n\n### Cross-Platform Support\n- **Linux\u002FmacOS\u002FWSL**: Uses `tmux` as terminal backend\n- **Native Windows**: Mux runtime is being redesigned around `psmux`; this branch no longer ships a parallel legacy native backend\n\n### Completion Hook\n- Notifies caller upon task completion\n- Supports caller-targeted completion notifications (`claude`\u002F`codex`\u002F`droid`)\n- Compatible with the tmux backend used by the current branch\n - Foreground ask suppresses the hook unless `CCB_COMPLETION_HOOK_ENABLED` is set\n\n---\n\n## 🧩 Skills\n\n- **\u002Fall-plan**: Collaborative multi-AI design with Superpowers brainstorming.\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>\u002Fall-plan details & usage\u003C\u002Fb>\u003C\u002Fsummary>\n\nUsage:\n```\n\u002Fall-plan \u003Crequirement>\n```\n\nExample:\n```\n\u002Fall-plan Design a caching layer for the API with Redis\n```\n\nHow it works:\n1. **Requirement Refinement** - Socratic questioning to uncover hidden needs\n2. **Parallel Independent Design** - Each AI designs independently (no groupthink)\n3. **Comparative Analysis** - Merge insights, detect anti-patterns\n4. **Iterative Refinement** - Cross-AI review and critique\n5. **Final Output** - Actionable implementation plan\n\nKey features:\n- **Socratic Ladder**: 7 structured questions for deep requirement mining\n- **Superpowers Lenses**: Systematic alternative exploration (10x scale, remove dependency, invert flow)\n- **Anti-pattern Detection**: Proactive risk identification across all designs\n\nWhen to use:\n- Complex features requiring diverse perspectives\n- Architectural decisions with multiple valid approaches\n- High-stakes implementations needing thorough validation\n\n\u003C\u002Fdetails>\n\n---\n\n## Legacy Cleanup Note\n\nThe legacy mail subsystem has been removed from the repo. The current runtime is project-scoped around `.ccb\u002Fccb.config`, and old runtime state can be cleared and rebuilt.\n\n---\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbfly123_claude_code_bridge_readme_ee4d001f4368.png\" alt=\"Neovim integration with multi-AI code review\" width=\"900\">\n\n> Combine with editors like **Neovim** for seamless code editing and multi-model review workflow. Edit in your favorite editor while AI assistants review and suggest improvements in real-time.\n\n---\n\n## 📋 Requirements\n\n- **Python 3.10+**\n- **Terminal:** `tmux`\n\n---\n\n## 🗑️ Uninstall\n\n```bash\nccb uninstall\nccb reinstall\n\n# Fallback:\n.\u002Finstall.sh uninstall\n```\n\n---\n\n\u003Cdiv align=\"center\">\n\n**Stable runtime:** Linux\u002FmacOS\u002FWSL + tmux\n\n**Native Windows mux:** planned around `psmux`\n\n---\n\n**Join our community**\n\n📧 Email: bfly123@126.com\n💬 WeChat: seemseam-com\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbfly123_claude_code_bridge_readme_e17b0f6d4768.png\" alt=\"WeChat Group\" width=\"300\">\n\n\u003C\u002Fdiv>\n\n---\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Version History\u003C\u002Fb>\u003C\u002Fsummary>\n\n### v5.0.6\n- **Zombie Cleanup**: `ccb kill -f` cleans up orphaned tmux sessions globally\n- **Mounted Skill**: Optimized with `pgrep`, extracted to `ccb-mounted` script\n- **Droid Skills**: Full skill set added to `droid_skills\u002F`\n\n### v5.0.5\n- **Droid**: Add delegation tools (`ccb_ask_*` and `cask\u002Fgask\u002Flask\u002Foask`) plus `ccb droid setup-delegation` for MCP install\n\n### v5.0.4\n- **OpenCode**: 修复 `-r` 恢复在多项目切换后失效的问题\n\n### v5.0.3\n- **Daemons**: 全新的稳定守护进程设计\n\n### v5.0.1\n- **Skills**: New `\u002Fall-plan` with Superpowers brainstorming + availability gating; Codex `lping\u002Flpend` added; `gask` keeps brief summaries with `CCB_DONE`.\n- **Status Bar**: Role label now reads role name from `.autoflow\u002Froles.json` (supports `_meta.name`) and caches per path.\n- **Installer**: Copy skill subdirectories (e.g., `references\u002F`) for Claude\u002FCodex installs.\n- **CLI**: Added `ccb uninstall` \u002F `ccb reinstall` with Claude config cleanup.\n- **Routing**: Tighter project\u002Fsession resolution (prefer `.ccb` anchor; avoid cross-project Claude session mismatches).\n\n### v5.0.0\n- **Claude Independence**: No need to start Claude first; Codex (or any agent) can be the primary CLI\n- **Unified Control**: Single entry point controls Claude\u002FOpenCode\u002FGemini equally\n- **Simplified Launch**: Removed `ccb up`; default `ccb.config` is auto-created when missing\n- **Flexible Mounting**: More flexible pane mounting and session binding\n- **Project askd Autostart**: project askd and provider runtimes auto-start in the project tmux namespace when needed\n- **Session Robustness**: PID liveness checks prevent stale sessions\n\n### v4.1.3\n- **Codex Config**: Automatically migrate deprecated `sandbox_mode = \"full-auto\"` to `\"danger-full-access\"` to fix Codex startup\n- **Stability**: Fixed race conditions where fast-exiting commands could close panes before `remain-on-exit` was set\n- **Tmux**: More robust pane detection (prefer stable `$TMUX_PANE` env var) and better fallback when split targets disappear\n\n### v4.1.2\n- **Performance**: Added caching for tmux status bar (git branch & ccb status) to reduce system load\n- **Strict Tmux**: Explicitly require `tmux` for auto-launch; removed error-prone auto-attach logic\n- **CLI**: Added `--print-version` flag for fast version checks\n\n### v4.1.1\n- **CLI Fix**: Improved flag preservation (e.g., `-a`) when relaunching `ccb` in tmux\n- **UX**: Better error messages when running in non-interactive sessions\n- **Install**: Force update skills to ensure latest versions are applied\n\n### v4.1.0\n- **Async Guardrail**: `cask\u002Fgask\u002Foask` prints a post-submit guardrail reminder for Claude\n- **Sync Mode**: add `--sync` to suppress guardrail prompts for Codex callers\n- **Codex Skills**: update `oask\u002Fgask` skills to wait silently with `--sync`\n\n### v4.0.9\n- **Project_ID Simplification**: `ccb_project_id` uses current-directory `.ccb\u002F` anchor (no ancestor traversal, no git dependency)\n- **Codex Skills Stability**: Codex `oask\u002Fgask` skills default to waiting (`--timeout -1`) to avoid sending the next task too early\n\n### v4.0.8\n- **Codex Log Binding Refresh**: the Codex runtime now periodically refreshes `.codex-session` log paths by parsing `start_cmd` and scanning latest logs\n- **Tmux Clipboard Enhancement**: Added `xsel` support and `update-environment` for better clipboard integration across GUI\u002Fremote sessions\n\n### v4.0.7\n- **Tmux Status Bar Redesign**: Dual-line status bar with modern dot indicators (●\u002F○), git branch, and CCB version display\n- **Session Freshness**: Always scan logs for latest session instead of using cached session file\n- **Simplified Auto Mode (Historical)**: auto-permission behavior was consolidated into the current primary start flow\n\n### v4.0.6\n- **Session Overrides**: `cping\u002Fgping\u002Foping\u002Fcpend\u002Fopend` support `--session-file` \u002F `CCB_SESSION_FILE` to bypass wrong `cwd`\n\n### v4.0.5\n- **Gemini Reliability**: Retry reading Gemini session JSON to avoid transient partial-write failures\n- **Claude Code Reliability**: `gpend` supports `--session-file` \u002F `CCB_SESSION_FILE` to bypass wrong `cwd`\n\n### v4.0.4\n- **Fix**: Auto-repair duplicate `[projects.\\\"...\\\"]` entries in `~\u002F.codex\u002Fconfig.toml` before starting Codex\n\n### v4.0.3\n- **Project Cleanliness**: Store session files under `.ccb\u002F` (fallback to legacy root dotfiles)\n- **Claude Code Reliability**: `cask\u002Fgask\u002Foask` support `--session-file` \u002F `CCB_SESSION_FILE` to bypass wrong `cwd`\n- **Codex Config Safety**: Write auto-approval settings into a CCB-marked block to avoid config conflicts\n\n### v4.0.2\n- **Clipboard Paste**: Cross-platform support (xclip\u002Fwl-paste\u002Fpbpaste) in tmux config\n- **Install UX**: Auto-reload tmux config after installation\n- **Stability**: Default TMUX_ENTER_DELAY set to 0.5s for better reliability\n\n### v4.0.1\n- **Tokyo Night Theme**: Switch tmux status bar and pane borders to Tokyo Night color palette\n\n### v4.0\n- **Full Refactor**: Rebuilt from the ground up with a cleaner architecture\n- **Perfect tmux Support**: First-class splits, pane labels, borders and statusline\n- **Works in Any Terminal**: Recommended to run everything in tmux (except native Windows)\n\n### v3.0.0\n- **Smart Runtime Queue**: project askd with 60s idle timeout and provider queue support\n- **Cross-AI Collaboration**: Support multiple agents (Claude\u002FCodex) calling one agent (OpenCode) simultaneously\n- **Interruption Detection**: Gemini now supports intelligent interruption handling\n- **Chained Execution**: Codex can call `oask` to drive OpenCode\n- **Stability**: Robust queue management and lock files\n\n### v2.3.9\n- Fix oask session tracking bug - follow new session when OpenCode creates one\n\n### v2.3.8\n- Plan mode enabled for autoflow projects regardless of `-a` flag\n\n### v2.3.7\n- Per-directory lock: different working directories can run cask\u002Fgask\u002Foask independently\n\n### v2.3.6\n- Add non-blocking lock for cask\u002Fgask\u002Foask to prevent concurrent requests\n- Unify oask with cask\u002Fgask logic (use _wait_for_complete_reply)\n\n### v2.3.5\n- Fix plan mode conflict with auto mode (--dangerously-skip-permissions)\n- Fix oask returning stale reply when OpenCode still processing\n\n### v2.3.4\n- Auto-enable plan mode when autoflow is installed\n\n### v2.3.3\n- Simplify cping.md to match oping\u002Fgping style (~65% token reduction)\n\n### v2.3.2\n- Optimize skill files: extract common patterns to docs\u002Fasync-ask-pattern.md (~60% token reduction)\n\n### v2.3.1\n- Fix race condition in gask\u002Fcask: pre-check for existing messages before wait loop\n\n\u003C\u002Fdetails>\n","\u003Cdiv align=\"center\">\n\n# CCB v6（Linux）- 无限并行智能体版\n\n**适用于终端分屏的原生多智能体运行时**\n**Claude · Codex · Gemini · OpenCode · Droid**\n**可见的并发执行、原生通信机制、项目范围内的运行时**\n\n\u003Cp>\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FEvery_Interaction_Visible-096DD9?style=for-the-badge\" alt=\"Every Interaction Visible\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FEvery_Model_Controllable-CF1322?style=for-the-badge\" alt=\"Every Model Controllable\">\n\u003C\u002Fp>\n\n[![版本](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fversion-6.0.4-orange.svg)]()\n[![平台](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fplatform-Linux%20%7C%20macOS%20%7C%20Windows-lightgrey.svg)]()\n\n**English** | [Chinese](README_zh.md)\n\n![展示图](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbfly123_claude_code_bridge_readme_7542b41dfe47.png)\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>演示动画\u003C\u002Fb>\u003C\u002Fsummary>\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbfly123_claude_code_bridge_readme_0c399c6f49b0.gif\" alt=\"任意终端协作演示\" width=\"900\">\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbfly123_claude_code_bridge_readme_339950536708.gif\" alt=\"VS Code 集成演示\" width=\"900\">\n\n\u003C\u002Fdetails>\n\n\u003C\u002Fdiv>\n\n---\n\n**简介：** CCB v6 是无限并行智能体版本。它将分屏协作转变为原生多智能体运行时，在其中智能体可以并肩运行，拥有独立的角色与个性，并通过稳定的内置通信层相互委派任务。\n\n## 为什么并行智能体很重要\n\n并行智能体不仅仅是“屏幕上更多的分屏”。在 CCB 中，每个智能体都可以拥有完全独立的角色、任务流、技能库和个性。\n\nCCB 提供了稳定智能体间通信的基础，并支持真正无限制的任务委派。它支持任意智能体命名与窗口布局、单个智能体控制、广播式分发以及点对点通信。\n\n## 🚀 用户命令\n\n- `ccb` 在终端中打开当前项目目录下的 CCB\n- `ccb -s` 安全模式\n- `ccb -n` 重建项目 `.ccb` 状态\n- `ccb kill` 关闭 CCB\n- `ccb kill -f` 强制退出清理\n\n## 💬 通信使用方法\n\n在提供者\u002F智能体运行时内部：\n\n- `\u002Fask all \"sync on the latest repo state\"` 向所有在线智能体广播一条消息。\n- `\u002Fask reviewer \"review the new parser change\"` 将任务发送给名为 `[reviewer]` 的智能体。\n\n典型模式：\n\n- 使用 `ask all` 进行一次性广播或全局同步\n- 使用 `ask agent_name` 进行定向委派\n- 使用隐式的基于技能的调用；智能体会自行调用 `ask`，目前这些技能已自动安装到 Codex、Claude 等提供者中\n- 如果你只是偶尔需要手动检查回复，`pend` 和 `watch` 是辅助工具\n\n## 🛠 配置控制\n\n`ccb` 由 `.ccb\u002Fccb.config` 文件控制。该文件定义了智能体名称、分屏布局，以及某个智能体是运行在“原地”还是独立的 Git 工作树中。\n\n快速规则：\n\n- `agent_name:provider` 定义一个智能体。`agent_name` 同时也是分屏标签和逻辑上的运行时名称。\n- `cmd` 添加一个 Shell 分屏。\n- `;` 从左到右水平分割分屏。\n- `,` 从上到下垂直分割分屏。\n- 默认工作空间模式为“原地”。如果某个智能体需要隔离的 Git 工作树以避免冲突，则写成 `agent_name:provider(worktree)`。\n\n示例：\n\n```text\ncmd; writer:codex, reviewer:claude; qa:gemini(worktree)\n```\n\n此布局表示：\n\n- 左侧分屏：`cmd`\n- 右侧为垂直堆叠：\n  - 右上分屏：`writer`\n  - 变下分屏：`reviewer` 和 `qa` 水平分割\n- `qa` 运行在独立的 Git 工作树中；`writer` 和 `reviewer` 则在主项目中“原地”运行\n\n\u003Ch2 align=\"center\">🚀 新增功能\u003C\u002Fh2>\n\n历史说明：下方较旧的发布说明可能提到 `askd`、遗留标志或已移除的命令。这些内容仅作为变更日志的历史记录保留，并不重新定义当前的 CLI 接口。\n\n\u003Cdetails open>\n\u003Csummary>\u003Cb>v6.0.4\u003C\u002Fb> - 遗留更新兼容性修复\u003C\u002Fsummary>\n\n- **向后兼容的发布资源**：Linux 发布 tarball 现在包含一个兼容别名，以便旧版 6.x 更新程序仍能找到解压后的安装路径\n- **旧客户端可再次升级**：现有的 `v6.0.1` 和 `v6.0.2` 安装现在可以直接更新到最新稳定版，无需先使用修补过的本地更新程序\n- **现代更新程序依然干净**：当前运行时保持正确的解压目录解析，不依赖于遗留别名\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v6.0.3\u003C\u002Fb> - 自更新 tarball 修复\u003C\u002Fsummary>\n\n- **修复发布升级问题**：`ccb update` 现在能正确解析解压后的发布目录，而不是将 `.tar.gz` 资源文件名当作文件夹处理\n- **恢复安装程序交接流程**：自更新现在能在解压后的发布资源中找到 `install.sh`，从而完成整个安装过程\n- **发布构建规范化**：Linux 发布打包现在会忽略本地 `.ccb-requests\u002F` 残留文件，确保官方构建可重复\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v6.0.2\u003C\u002Fb> - 调用者身份识别、邮箱路由及 macOS 安装警告\u003C\u002Fsummary>\n\n- **正确识别调用者身份**：`ccb ask` 现在会保留真实的发起智能体信息，因此回复会返回到正确的邮箱，而不会被归因于“用户”\n- **稳定的回复路由**：对于委派任务的异步回复，现在都能准确返回到预期的邮箱链路中，包括以 `cmd` 为起点的流程\n- **大小写混合的智能体配置恢复**：当配置的智能体名称使用大小写混合时，布局恢复功能不再出现偏差\n- **macOS Homebrew 警告**：`install.sh` 现在会在用户尝试安装 tmux 等依赖项之前，明确提示 Homebrew 未安装\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v6.0.1\u003C\u002Fb> - 发布档案清理与更安全的升级解压\u003C\u002Fsummary>\n\n- **源码档案清理**：移除了意外跟踪的 pytest 临时文件，使 GitHub 源码档案再次变得整洁\n- **更安全的 tar 校验**：升级解压现在会在解包前拒绝不安全的符号链接目标\n- **更清晰的失败提示**：不安全的档案解压错误现在会引导用户查看发布资源或干净的源码档案\n- **回归测试覆盖**：增加了测试，以防止短暂的仓库文件再次被跟踪\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v6.0.0\u003C\u002Fb> - 原生多智能体运行时、稳定的原生通信机制以及仅限 Linux 的自动升级\u003C\u002Fsummary>\n\n**🚀 新的运行时方向：**\n- **无限并行智能体基础**：CCB v6 构建为真正无限制的智能体间委派与编排的运行时基础\n- **独立的智能体身份**：智能体可以拥有不同的角色、任务所有权、技能库和个性\n- **聚焦的用户命令界面**：公开的用户工作流仍然以 `ccb`、`ccb -s`、`ccb -n`、`ccb kill` 和 `ccb kill -f` 为核心\n\n**🧱 项目语义重建：**\n- **配置保留的遗留清理**：在 6.x 版本之前的项目中首次运行 `ccb` 时，CCB 会保留 `.ccb\u002Fccb.config` 文件，移除其余旧的 `.ccb` 运行时状态，并在本地重新构建。\n- **运行时标记**：现代项目现在会记录 `.ccb\u002Fproject-runtime.json` 文件，以便将当前运行时状态与遗留状态区分开来。\n- **工作树安全保护**：如果 CCB 管理的工作树处于脏状态或未合并状态，仍会阻止破坏性重建操作，直到用户解决这些问题。\n\n**🔄 升级政策：**\n- **仅限 Linux\u002FWSL**：`ccb update` 现在仅适用于 Linux\u002FWSL 上的 6.x 系列。\n- **仅发布版本升级**：源代码标签仍然随每个版本一起发布，但 6.x 的 `ccb update` 会安装 GitHub 发布资产，而不是源代码压缩包。\n- **稳定版为目标**：默认升级现在会指向最新的稳定版，而不是不断变化的 `main` 分支。\n- **重大版本确认**：升级到 `6.0.0` 需要用户明确确认，才能替换已安装的运行时环境。\n\n**🤖 提供者可靠性：**\n- **Gemini 多轮稳定性**：Gemini 补全轮询现在会等待工具活动完成，不再在第一句稳定的规划性语句后就退出。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.3.0\u003C\u002Fb> - 简化 CLI、显式工作树模式和 Gemini 补全稳定性\u003C\u002Fsummary>\n\n**🚀 用户界面 CLI 简化：**\n- **精简主界面**：公开启动流程现为 `ccb`、`ccb -s`、`ccb -n`、`ccb kill` 和 `ccb kill -f`。\n- **模型控制平面仍可用**：`ask`、`ping`、`pend` 和 `watch` 仍然用于代理间的协调，而不干扰主帮助信息。\n\n**🧱 工作空间语义明确化：**\n- **默认原地模式**：紧凑的 `ccb.config` 条目现在会扩展为 `workspace_mode='inplace'`。\n- **选择性隔离模式**：当某个代理必须在其独立的 Git 工作树中运行时，可使用 `agent:provider(worktree)`。\n- **安全的代理管理**：添加代理不会干扰现有的工作树；移除或重命名工作树代理时，会退避干净的分支，并阻止对脏或未合并分支的操作。\n\n**🛠 恢复与重置加固：**\n- **保留配置的重置**：`ccb -n` 会在保留 `.ccb\u002Fccb.config` 的同时，重建项目运行时状态。\n- **清理过时注册**：启动和重置操作现在会在重新创建之前，先清除缺失的已注册 Git 工作树。\n- **终止警告**：`ccb kill` 会在工作树代理仍存在未合并或脏状态时发出明确警告。\n\n**🤖 Gemini 补全修复：**\n- **不再因规划文本提前结束**：Gemini 补全轮询现在会跟踪工具调用活动，并等待真正的最终回复，而不是在第一条稳定的“我将……”语句后就结束。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.2.6\u003C\u002Fb> - 异步通信与 Gemini 0.29 兼容性\u003C\u002Fsummary>\n\n**🔧 Gemini CLI 0.29.0 支持：**\n- **双重哈希策略**：会话路径发现现在同时支持基础名和 SHA-256 格式。\n- **自动启动**：`ccb-ping` 和 `ccb-mounted` 新增了 `--autostart` 标志，用于启动离线提供者守护进程。\n- **清理路径**：僵尸会话的清理现在由 `ccb kill -f` 负责。\n- **🔗 异步通信修复：**\n- **OpenCode 死锁**：修复了导致第二次异步调用总是失败的会话 ID 锁定问题。\n- **遗留补全兼容性**：基于文本的遗留提供者在降级模式下仍能容忍不匹配的 `CCB_DONE` 行。\n- **req_id 正则表达式**：`opencode_comm.py` 现在可以匹配旧的十六进制格式和新的基于时间戳的格式。\n- **Gemini 空闲超时**：当 Gemini 忽略 `CCB_DONE` 标记时，系统会自动检测回复完成（15 秒空闲，可通过 `CCB_GEMINI_IDLE_TIMEOUT` 配置）。\n- **Gemini 提示强化**：更严格的指令以降低 `CCB_DONE` 遗漏率。\n- **🛠 其他修复：**\n- **lpend**：当注册表过时时，优先使用新的 Claude 会话路径。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.2.5\u003C\u002Fb> - 异步护栏加固\u003C\u002Fsummary>\n\n**🔧 异步转接停止修复：**\n- **全局护栏**：在 `claude-md-ccb.md` 中新增强制性的“异步护栏”规则——涵盖 `\u002Fask` 技能以及直接的 `Bash(ask ...)` 调用。\n- **标记一致性**：`bin\u002Fask` 现在会发出 `[CCB_ASYNC_SUBMITTED provider=xxx]`，与其他所有提供者脚本保持一致。\n- **DRY 技能**：Ask 技能规则引用全局护栏，并带有本地回退机制，确保单一事实来源。\n- 这一修复防止了 Claude 在提交异步任务后继续轮询或休眠。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.2.3\u003C\u002Fb> - 项目本地历史与遗留兼容性\u003C\u002Fsummary>\n\n**📂 项目本地历史：**\n- **本地存储**：自动上下文导出现在会按项目保存到 `.\u002F.ccb\u002Fhistory\u002F`。\n- **安全范围**：自动转移仅针对当前工作目录运行。\n- **Claude \u002Fcontinue**：新增技能，可通过 `@` 附加最新的历史文件。\n- **🧩 遗留兼容性：**\n- **自动迁移**：`.ccb_config` 文件会在可能的情况下被检测并升级为 `.ccb`。\n- **回退查找**：过渡期间，遗留会话仍能正常解析。\n- 这些更改使交接工件限定在项目范围内，并使升级过程更加平滑。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.2.2\u003C\u002Fb> - 会话切换捕获与上下文转移\u003C\u002Fsummary>\n\n**🔁 会话切换追踪：**\n- **旧会话字段**：`.claude-session` 现在会记录 `old_claude_session_id`、`old_claude_session_path` 以及 `old_updated_at`。\n- **自动上下文导出**：之前的 Claude 会话会被自动提取到 `.\u002F.ccb\u002Fhistory\u002Fclaude-\u003Ctimestamp>-\u003Cold_id>.md`。\n- **更清洁的转移**：噪声过滤会移除协议标记和护栏内容，同时保留仅与工具相关的操作。\n- 这些更新使会话交接更加可靠，也更易于审计。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.2.1\u003C\u002Fb> - Ask 命令稳定性增强\u003C\u002Fsummary>\n\n**🔧 稳定性改进：**\n- **看门狗文件监控**：通过高效的文件监控实现会话的实时更新。\n- **强制调用者字段**：提升了请求跟踪和路由的可靠性。\n- **统一执行模型**：简化了跨平台的 ask 技能执行。\n- **自动依赖安装**：看门狗库会在设置过程中自动安装。\n- **会话注册表**：增强了 Claude 适配器，实现了会话的自动监控。\n- 这些改进显著提高了跨 AI 通信的可靠性，并减少了会话绑定失败的情况。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.2.0\u003C\u002Fb> - 历史邮件桥接版本\u003C\u002Fsummary>\n\n此版本引入了旧的邮件网关路径。该流程现已从支持的代理优先界面上移除，仅作为遗留代码保留在清理阶段。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.1.3\u003C\u002Fb> - Tmux Claude Ask 稳定性\u003C\u002Fsummary>\n\n**🔧 修复与改进：**\n- **tmux Claude ask**：从窗格输出中读取回复，并自动进行管道窗格日志记录，以提高完成的可靠性。\n- 更多详细信息请参阅 [CHANGELOG.md](CHANGELOG.md)。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.1.2\u003C\u002Fb> - 守护进程与钩子可靠性\u003C\u002Fsummary>\n\n**🔧 修复与改进：**\n- **Claude 补全钩子**：统一的 askd 现在会触发 Claude 的补全钩子\n- **askd 生命周期**：askd 已绑定到 CCB 生命周期，以避免出现过时的守护进程\n- **挂载检测**：`ccb-mounted` 在所有平台上都使用基于 ping 的检测方式\n- **状态文件查找**：`askd_client` 会在找不到守护进程状态文件时回退到 `CCB_RUN_DIR`\n\n完整详情请参阅 [CHANGELOG.md](CHANGELOG.md)。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.1.1\u003C\u002Fb> - 统一守护进程 + 错误修复\u003C\u002Fsummary>\n\n**🔧 错误修复与改进：**\n- **统一守护进程**：所有提供商现在都使用统一的 askd 守护进程架构\n- **安装\u002F卸载**：修复了安装和卸载中的错误\n- **进程管理**：修复了杀死\u002F终止相关的问题\n\n完整详情请参阅 [CHANGELOG.md](CHANGELOG.md)。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.1.0\u003C\u002Fb> - 统一命令系统 + 历史性的原生 Windows 实验\u003C\u002Fsummary>\n\n**🚀 统一命令** - 将各提供商特有的命令替换为以代理为中心的工作流：\n\n| 旧命令 | 新统一命令 |\n|--------------|---------------------|\n| `cask`, `gask`, `oask`, `dask`, `lask` | `ccb ask \u003Cagent> [from \u003Csender>] \u003Cmessage>` |\n| `cping`, `gping`, `oping`, `dping`, `lping` | `ccb ping \u003Cagent\\|all>` |\n| `cpend`, `gpend`, `opend`, `dpend`, `lpend` | `ccb pend \u003Cagent\\|job_id> [N]` |\n\n**支持的提供商：** `gemini`, `codex`, `opencode`, `droid`, `claude`\n\n**🪟 历史性的原生 Windows 实验：**\n- 此前的版本曾探索过原生 Windows 分屏路径\n- 后台执行使用 PowerShell + `DETACHED_PROCESS`\n- 大型负载传递采用基于 stdin 的交接方式\n- 该后端现已移除；未来原生 Windows 的多路复用支持将围绕 `psmux` 进行重新设计\n\n**📦 新技能：**\n- `\u002Fask \u003Cagent> \u003Cmessage>` - 向指定代理发送任务\n- `\u002Fping \u003Cagent|all>` - 检查已挂载代理的健康状况\n- `\u002Fpend \u003Cagent|job_id> [N]` - 查看代理的最新回复\n\n完整详情请参阅 [CHANGELOG.md](CHANGELOG.md)。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.0.6\u003C\u002Fb> - 清理僵尸会话 + 优化挂载技能\u003C\u002Fsummary>\n\n- **僵尸清理**：`ccb kill -f` 现在会全局清理孤儿 tmux 会话（即父进程已退出的会话）\n- **挂载技能**：优化为使用 `pgrep` 进行守护进程检测（速度提升约 4 倍），并提取为独立的 `ccb-mounted` 脚本\n- **Droid 技能**：将全套技能（cask\u002Fgask\u002Flask\u002Foask 以及 ping\u002Fpend 变体）添加到 `droid_skills\u002F` 目录下\n- **安装**：新增 `install_droid_skills()` 函数，用于将 Droid 技能安装到 `~\u002F.droid\u002Fskills\u002F`\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.0.5\u003C\u002Fb> - Droid 委托工具 + 设置\u003C\u002Fsummary>\n\n- **Droid**：增加了委托工具（`ccb_ask_*` 以及 `cask\u002Fgask\u002Flask\u002Foask` 别名）。\n- **设置**：新增 `ccb droid setup-delegation` 命令，用于 MCP 注册。\n- **安装程序**：当检测到 `droid` 时，会自动注册 Droid 委托（可通过环境变量选择退出）。\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>详情与使用方法\u003C\u002Fb>\u003C\u002Fsummary>\n\n使用方法：\n```\n\u002Fall-plan \u003Crequirement>\n```\n\n示例：\n```\n\u002Fall-plan 为 API 设计一个基于 Redis 的缓存层\n```\n\n亮点：\n- 苏格拉底式提问法 + 超能力视角 + 反模式分析。\n- 基于可用性的调度（仅使用已挂载的 CLI）。\n- 两轮评审员优化，并合并设计方案。\n\n\u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v5.0.0\u003C\u002Fb> - 任何 AI 均可作为主要驱动\u003C\u002Fsummary>\n\n- **Claude 独立性**：无需先启动 Claude；Codex 也可以作为主要 CLI。\n- **统一控制**：单一入口即可控制 Claude\u002FOpenCode\u002FGemini。\n- **简化启动**：移除了 `ccb up`；直接使用 `ccb ...` 或默认的 `ccb.config`。\n- **灵活挂载**：分屏挂载和会话绑定更加灵活。\n- **默认配置**：缺失时会自动创建 `ccb.config`。\n- **项目 askd 自动启动**：项目 askd 和提供商运行时会在需要时自动在项目的 tmux 命名空间中启动。\n- **会话稳健性**：通过 PID 活性检查防止出现过时的会话。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v4.0\u003C\u002Fb> - 以 tmux 为主的重构\u003C\u002Fsummary>\n\n- **全面重构**：结构更清晰、稳定性更好、扩展更容易。\n- **终端运行时清理**：运行时转向单一的 tmux 导向的分屏\u002F控制模型，而非并行的终端后端。\n- **完美的 tmux 体验**：稳定的布局 + 分屏标题\u002F边框 + 会话范围的主题设置。\n- **适用于任何终端**：只要你的终端能够运行 tmux，CCB 就能提供完整的多模型分屏体验。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>v3.0\u003C\u002Fb> - 智能守护进程\u003C\u002Fsummary>\n\n- **真正的并行处理**：可以同时向 Codex、Gemini 或 OpenCode 提交多个任务。\n- **跨 AI 协调**：Claude 和 Codex 现在可以共同驱动 OpenCode 代理。\n- **防弹级稳定性**：守护进程会在首次请求时自动启动，并在空闲后停止。\n- **链式执行**：Codex 可以委托 OpenCode 来完成多步骤的工作流程。\n- **智能中断处理**：Gemini 任务能够安全地处理中断情况。\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>详情\u003C\u002Fb>\u003C\u002Fsummary>\n\n\u003Cdiv align=\"center\">\n\n![并行](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FStrategy-Parallel_Queue-blue?style=flat-square)\n![稳定性](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FDaemon-Auto_Managed-green?style=flat-square)\n![中断](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FGemini-Interruption_Aware-orange?style=flat-square)\n\n\u003C\u002Fdiv>\n\n\u003Ch3 align=\"center\">✨ 关键特性\u003C\u002Fh3>\n\n- **🔄 真正并行处理**：可以同时向 Codex、Gemini 或 OpenCode 提交多个任务。提供商运行时会按顺序排队并执行，确保不会产生上下文污染。\n- **🤝 跨 AI 协调**：Claude 和 Codex 现在可以同时驱动 OpenCode 代理。所有请求均由项目 askd 层仲裁。\n- **🛡️ 防弹级稳定性**：运行时层是自我管理的。它会在首次使用时启动，并在空闲后关闭以节省资源。\n- **⚡ 链式执行**：支持高级工作流程！Codex 可以自主调用 `oask`，将子任务委托给 OpenCode 模型。\n- **🛑 智能中断处理**：Gemini 任务现在支持智能中断检测，能够自动处理中断情况，确保工作流程的连续性。\n\n\u003Ch3 align=\"center\">🧩 功能支持矩阵\u003C\u002Fh3>\n\n| 特性 | Codex | Gemini | OpenCode |\n| :--- | :---: | :---: | :---: |\n| **并行列队** | ✅ | ✅ | ✅ |\n| **中断感知** | ✅ | ✅ | - |\n| **响应隔离** | ✅ | ✅ | ✅ |\n\n\u003Cdetails>\n\u003Csummary>\u003Cstrong>📊 查看实际压力测试结果\u003C\u002Fstrong>\u003C\u002Fsummary>\n\n\u003Cbr>\n\n**场景 1：Claude 和 Codex 同时访问 OpenCode**\n*两个代理同时发出请求，由守护进程完美协调。*\n\n| 来源 | 任务 | 结果 | 状态 |\n| :--- | :--- | :--- | :---: |\n| 🤖 Claude | `CLAUDE-A` | **CLAUDE-A** | 🟢 |\n| 🤖 Claude | `CLAUDE-B` | **CLAUDE-B** | 🟢 |\n| 💻 Codex | `CODEX-A` | **CODEX-A** | 🟢 |\n| 💻 Codex | `CODEX-B` | **CODEX-B** | 🟢 |\n\n**场景 2：递归\u002F链式调用**\n*Codex 自主驱动 OpenCode 完成一个 5 步工作流程。*\n\n| 请求 | 退出代码 | 响应 |\n| :--- | :---: | :--- |\n| **ONE** | `0` | `CODEX-ONE` |\n| **TWO** | `0` | `CODEX-TWO` |\n| **THREE** | `0` | `CODEX-THREE` |\n| **FOUR** | `0` | `CODEX-FOUR` |\n| **FIVE** | `0` | `CODEX-FIVE` |\n\n\u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\u003C\u002Fdetails>\n\n---\n\n## 🚀 快速入门\n\n**步骤 1：** 使用支持 tmux 的环境（Linux\u002FmacOS\u002FWSL 上的 tmux）\n\n**步骤 2：** 根据您的环境选择安装程序：\n\n\u003Cdetails open>\n\u003Csummary>\u003Cb>Linux\u003C\u002Fb>\u003C\u002Fsummary>\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge.git\ncd claude_code_bridge\n.\u002Finstall.sh install\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>macOS\u003C\u002Fb>\u003C\u002Fsummary>\n\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge.git\ncd claude_code_bridge\n.\u002Finstall.sh install\n```\n\n> **注意：** 如果安装后命令未找到，请参阅 [macOS 故障排除](#-macos-installation-guide)。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>WSL（适用于 Linux 的 Windows 子系统）\u003C\u002Fb>\u003C\u002Fsummary>\n\n> 如果您的 Claude\u002FCodex\u002FGemini 在 WSL 中运行，请使用此方法。\n\n> **⚠️ 警告：** 请勿以 root\u002Fadministrator 身份安装或运行 ccb。请先切换到普通用户（`su - username` 或使用 `adduser` 创建一个新用户）。\n\n```bash\n# 在 WSL 终端内运行（以普通用户身份，而非 root）\ngit clone https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge.git\ncd claude_code_bridge\n.\u002Finstall.sh install\n```\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>Windows 原生\u003C\u002Fb>\u003C\u002Fsummary>\n\n> 如果您的 Claude\u002FCodex\u002FGemini 在 Windows 原生环境中运行，请使用此方法。\n\n> Windows 原生 mux 运行时目前正在围绕 `psmux` 进行重新设计。本分支中稳定的分屏路径仍然是 Linux\u002FmacOS\u002FWSL + `tmux`。\n\n```powershell\ngit clone https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge.git\ncd claude_code_bridge\npowershell -ExecutionPolicy Bypass -File .\\install.ps1 install\n```\n\n- 安装程序优先使用 `pwsh.exe`（PowerShell 7 及以上版本），如果不可用则使用 `powershell.exe`。\n\n\u003C\u002Fdetails>\n\n### 运行\n```bash\nccb                              # 从 .ccb\u002Fccb.config 启动默认代理\nccb -s                           # 安全启动：保持配置\u002F手动权限行为\nccb -n                           # 重建 .ccb 目录，但保留 ccb.config，然后全新启动\nccb kill                         # 停止该项目的后台运行\nccb kill -f                      # 强制清理后再重建状态\n\ntmux 小贴士：CCB 的 tmux 状态栏和窗格主题仅在 CCB 运行时启用。\ntmux 小贴士：按 `Ctrl+b` 然后 `Space` 可以循环切换 tmux 布局。您可以反复按下以不断切换布局。\n\n布局规则：最后选定的代理会运行在当前窗格中。额外的代理按照选定的目标列表排列；第一个额外代理位于右上角，然后左列从上到下填充，接着右列也从上到下填充。\n注意：`ccb up` 已被移除；请使用 `ccb ...` 并结合 `.ccb\u002Fccb.config` 文件。\n```\n\n### 标志位\n| 标志位 | 描述 | 示例 |\n| :--- | :--- | :--- |\n| `-s` | 安全启动；禁用 CLI 自动权限覆盖 | `ccb -s` |\n| `-n` | 重建 `.ccb` 目录，但保留 `ccb.config`，然后全新启动 | `ccb -n` |\n| `-h` | 显示帮助信息 | `ccb -h` |\n| `-v` | 显示版本并检查更新 | `ccb -v` |\n\n### ccb.config\n默认查找顺序：\n- `.ccb\u002Fccb.config`（项目级）\n- `~\u002F.ccb\u002Fccb.config`（全局级）\n\n仅支持紧凑格式：\n```text\nwriter:codex,reviewer:claude\n```\n\n启用命令窗格（默认标题\u002F命令）：\n```text\nagent1:codex,agent2:codex,agent3:claude,cmd\n```\n\n规则：\n- 每个代理条目必须是 `agent_name:provider`。\n- `cmd` 是用于 shell 窗格的保留独立标记，不是代理名称。\n- `;` 从左到右水平分割窗格。\n- `,` 从上到下垂直分割窗格。\n- `(…)` 显式分组布局的一部分。\n- 每个代理条目都会扩展为固定默认值：`target='.'`, `workspace_mode='inplace'`, `restore='auto'`, `permission='manual'`。\n- 当您希望某个代理在其自己的 git 工作树中隔离运行时，可以使用 `agent_name:provider(worktree)`。\n- 如果缺少项目配置文件，则会自动创建为 `codex:codex,claude:claude`。\n- 命令窗格作为第一个额外窗格参与布局，且不会改变当前窗格中运行的 AI。\n\n### 更新\nCCB v6 目前仅支持在 Linux\u002FWSL 上使用 `ccb update`。重大升级会完全替换已安装的运行时。在较旧项目的首次 `ccb` 启动时，CCB 会保留 `.ccb\u002Fccb.config`，清除其余旧 `.ccb` 状态，并在本地重新构建。\n\n```bash\nccb update              # 更新至最新稳定版\nccb update 6            # 更新至最新的 v6.x.x 版本\nccb update 6.0          # 更新至最新的 v6.0.x 版本\nccb update 6.0.4        # 更新至特定版本\nccb uninstall           # 卸载 ccb 并清理配置\nccb reinstall           # 清理后重新安装 ccb\n```\n\n---\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🪟 Windows 环境指南\u003C\u002Fb>\u003C\u002Fsummary>\n\n> **关键点：** `ccb` 和底层代理 CLI 必须在同一环境中运行。最常见的问题就是环境不匹配，导致项目启动或代理连接失败。\n\n注意：安装程序还会为 Claude\u002FCodex 技能安装特定于操作系统的 `SKILL.md` 变体：\n- Linux\u002FmacOS\u002FWSL：bash heredoc 模板（`SKILL.md.bash`）\n- Windows 原生：PowerShell here-string 模板（`SKILL.md.powershell`）\n\n### 1) 当前后端状态\n\n- 本分支中活跃的多窗格运行时仅为 `tmux`。\n- 目前稳定的分屏使用方式是 Linux\u002FmacOS\u002FWSL 配合 `tmux`。\n- Windows 原生的 mux 支持正在围绕 `psmux` 进行重新设计；详情请参阅 [docs\u002Fccbd-windows-psmux-plan.md](docs\u002Fccbd-windows-psmux-plan.md)。\n\n### 2) 如何识别您的环境\n\n根据您安装\u002F运行 Claude Code\u002FCodex 的方式来判断：\n\n- **WSL 环境**\n  - 您通过 WSL 终端（Ubuntu\u002FDebian）使用 `bash` 安装或运行（例如：`curl ... | bash`、`apt`、`pip`、`npm`）。\n  - 路径看起来像是 `\u002Fhome\u002F\u003Cuser>\u002F...`，也可能看到 `\u002Fmnt\u002Fc\u002F...`。\n  - 验证方法：运行 `cat \u002Fproc\u002Fversion | grep -i microsoft` 应有输出，或者 `echo $WSL_DISTRO_NAME` 不为空。\n\n- **Windows 原生环境**\n  - 您通过 Windows Terminal、PowerShell 或 CMD 安装或运行（例如：`winget`、PowerShell 脚本）。\n  - 路径看起来像是 `C:\\Users\\\u003Cuser>\\...`。\n\n### 3) 当前推荐方案\n\n- 如果您希望采用稳定的分屏\u002F运行时监督路径，请在 WSL 中运行 `ccb` 和所有代理 CLI，然后使用 `tmux`。\n- 如果您的工具目前在 Windows 原生环境中运行，请保持该环境一致，但将原生分屏编排视为过渡方案，直到 `psmux` 推出为止。\n\n### 4) 故障排除：`ccb` 无法正确启动\n\n- **最常见原因：** 环境不匹配（ccb 在 WSL 中而 codex 在 Windows 原生环境中，反之亦然）。\n- **tmux 未安装：** 请在运行 `ccb` 的环境中安装 `tmux`。\n- **终端未刷新：** 安装完成后重启终端，以便使 PATH 变更生效。\n\n\u003C\u002Fdetails>\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>🍎 macOS 安装指南\u003C\u002Fb>\u003C\u002Fsummary>\n\n### 安装后命令未找到\n\n如果您在运行 `.\u002Finstall.sh install` 后发现 `ccb` 未找到：\n\n**原因：** 安装目录（`~\u002F.local\u002Fbin`）未包含在您的 PATH 中。\n\n**解决方案：**\n\n```bash\nnano ~\u002F.zshrc\nexport PATH=$PATH:~\u002F.local\u002Fbin\nsource ~\u002F.zshrc\n```\n\n# 1. 检查安装目录是否存在\nls -la ~\u002F.local\u002Fbin\u002F\n\n# 2. 检查 PATH 是否包含该目录\necho $PATH | tr ':' '\\n' | grep local\n\n# 3. 检查 shell 配置文件（macOS 默认使用 zsh）\ncat ~\u002F.zshrc | grep local\n\n# 4. 如果未配置，手动添加\necho 'export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"' >> ~\u002F.zshrc\n\n# 5. 重新加载配置\nsource ~\u002F.zshrc\n```\n\n### tmux 中的 Shell 无法检测到命令\n\n如果在 tmux 内启动的 shell 找不到 ccb 命令，而普通终端却可以找到：\n\n- tmux 可能启动了不同的 shell 初始化路径。\n- 同时将 PATH 添加到 `~\u002F.zprofile` 文件中：\n\n```bash\necho 'export PATH=\"$HOME\u002F.local\u002Fbin:$PATH\"' >> ~\u002F.zprofile\n```\n\n然后完全重启 tmux 服务器：\n\n```bash\ntmux kill-server\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## 🗣️ 使用方法\n\n一旦启动，即可自然协作。Claude 会自动判断何时需要委派任务。\n\n**常见场景：**\n\n- **代码审查：** *“让 Codex 审查一下 `main.py` 中的更改。”*\n- **寻求第二意见：** *“请 Gemini 提供其他实现方案。”*\n- **结对编程：** *“Codex 负责编写后端逻辑，我来处理前端。”*\n- **架构设计：** *“先让 Codex 设计模块结构吧。”*\n- **信息交换：** *“获取 Codex 的三轮对话内容并进行总结。”*\n\n### 🎴 趣味创意：AI 牌局之夜！\n\n> *“让 Claude、Codex 和 Gemini 来玩斗地主！你负责发牌，大家明牌出牌！”*\n>\n> 🃏 Claude（地主）vs 🎯 Codex + 💎 Gemini（农民）\n\n> **注意：** CCB v6 中公开项目运行的工作流程被刻意简化为：`ccb`、`ccb -s`、`ccb -n`、`ccb kill` 和 `ccb kill -f`。内部控制平面的命令仍然存在，用于代理端的编排工作，但它们并不属于面向用户的启动或重置界面。\n\n---\n\n## 🛠️ 面向用户 CLI\n\nCCB v6 中公开项目的运行流程被有意缩减为五个主要命令：\n\n- **`ccb`** - 默认启动路径；启动由 `.ccb\u002Fccb.config` 定义的代理。\n- **`ccb -s`** - 安全启动；保持每个代理配置或默认的权限行为。\n- **`ccb -n`** - 重建项目 `.ccb` 状态，但不包括 `ccb.config`，然后在确认后全新启动。\n- **`ccb kill`** - 停止当前项目的运行。\n- **`ccb kill -f`** - 在执行 `ccb -n` 之前强制清理项目拥有的运行残留。\n  - 当 `.ccb` 存在但 `ccb.config` 丢失或过时时，此命令也可作为恢复途径。\n\n内部控制平面的命令仍然存在，用于模型端的编排和自动化，但这些命令并未在此处作为公开的用户命令呈现。\n\n### 跨平台支持\n- **Linux\u002FmacOS\u002FWSL**：使用 `tmux` 作为终端后端。\n- **原生 Windows**：Mux 运行时正在围绕 `psmux` 重新设计；本分支不再提供并行的旧版原生后端。\n\n### 完成钩子\n- 在任务完成后通知调用者。\n- 支持针对特定调用者的完成通知（`claude`\u002F`codex`\u002F`droid`）。\n- 兼容当前分支使用的 tmux 后端。\n  - 前台询问会抑制钩子，除非设置了 `CCB_COMPLETION_HOOK_ENABLED`。\n\n---\n\n## 🧩 技能\n\n- **\u002Fall-plan**：多 AI 协作设计，结合超级能力头脑风暴。\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>\u002Fall-plan 详情与使用方法\u003C\u002Fb>\u003C\u002Fsummary>\n\n使用方法：\n```\n\u002Fall-plan \u003C需求>\n```\n\n示例：\n```\n\u002Fall-plan 使用 Redis 为 API 设计一个缓存层\n```\n\n工作原理：\n1. **需求细化** - 通过苏格拉底式提问挖掘隐藏需求。\n2. **并行独立设计** - 每个 AI 独立设计（避免群体思维）。\n3. **对比分析** - 整合见解，识别反模式。\n4. **迭代优化** - 多 AI 互相评审和批评。\n5. **最终输出** - 可操作的实施计划。\n\n关键特性：\n- **苏格拉底阶梯**：7 个结构化问题，深入挖掘需求。\n- **超级能力视角**：系统性地探索替代方案（10 倍规模、移除依赖、反转流程）。\n- **反模式检测**：主动识别所有设计方案中的风险。\n\n适用场景：\n- 需要多元视角的复杂功能。\n- 有多种可行方案的架构决策。\n- 需要彻底验证的高风险实施。\n\n\u003C\u002Fdetails>\n\n---\n\n## 遗留清理说明\n\n仓库中已移除旧版邮件子系统。当前运行时以 `.ccb\u002Fccb.config` 为中心，旧的运行状态可以清除并重新构建。\n\n---\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbfly123_claude_code_bridge_readme_ee4d001f4368.png\" alt=\"Neovim 与多 AI 代码审查集成\" width=\"900\">\n\n> 结合像 **Neovim** 这样的编辑器，可实现无缝的代码编辑和多模型审查工作流。您可以在自己喜欢的编辑器中编辑代码，同时 AI 助手实时审查并提出改进建议。\n\n---\n\n## 📋 需求\n\n- **Python 3.10+**\n- **终端：** `tmux`\n\n---\n\n## 🗑️ 卸载\n\n```bash\nccb uninstall\nccb reinstall\n\n# 备用方案：\n.\u002Finstall.sh uninstall\n```\n\n---\n\n\u003Cdiv align=\"center\">\n\n**稳定运行环境：** Linux\u002FmacOS\u002FWSL + tmux\n\n**原生 Windows mux：** 计划围绕 `psmux` 构建。\n\n---\n\n**加入我们的社区**\n\n📧 邮箱：bfly123@126.com\n💬 微信：seemseam-com\n\n\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbfly123_claude_code_bridge_readme_e17b0f6d4768.png\" alt=\"微信群\" width=\"300\">\n\n\u003C\u002Fdiv>\n\n---\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>版本历史\u003C\u002Fb>\u003C\u002Fsummary>\n\n### v5.0.6\n- **僵尸清理**：`ccb kill -f` 全局清理孤立的 tmux 会话。\n- **挂载技能**：优化了 `pgrep`，提取到 `ccb-mounted` 脚本中。\n- **Droid 技能**：完整技能集已添加到 `droid_skills\u002F` 目录下。\n\n### v5.0.5\n- **Droid**：增加了委托工具（`ccb_ask_*` 和 `cask\u002Fgask\u002Flask\u002Foask`），以及用于 MCP 安装的 `ccb droid setup-delegation`。\n\n### v5.0.4\n- **OpenCode**：修复了 `-r` 恢复在多项目切换后失效的问题。\n\n### v5.0.3\n- **守护进程**：全新的稳定守护进程设计。\n\n### v5.0.1\n- **技能**：新增 `\u002Fall-plan` 技能，结合超级能力头脑风暴，并增加了可用性限制；Codex 新增 `lping\u002Flpend`；`gask` 会保留简短摘要，并记录 `CCB_DONE`。\n- **状态栏**：角色标签现在从 `.autoflow\u002Froles.json` 中读取角色名称（支持 `_meta.name`），并按路径缓存。\n- **安装程序**：复制技能子目录（如 `references\u002F`），用于 Claude 和 Codex 的安装。\n- **CLI**：新增 `ccb uninstall` \u002F `ccb reinstall` 命令，同时清理 Claude 的配置。\n- **路由**：更精确的项目\u002F会话解析（优先使用 `.ccb` 锚点，避免跨项目 Claude 会话不匹配）。\n\n### v5.0.0\n- **Claude 独立性**：无需先启动 Claude；Codex 或任何其他代理都可以作为主要 CLI。\n- **统一控制**：单一入口可平等控制 Claude\u002FOpenCode\u002FGemini。\n- **简化启动**：移除了 `ccb up`；当缺少 `ccb.config` 时，会自动创建默认配置。\n- **灵活挂载**：更灵活的窗格挂载和会话绑定。\n- **项目 askd 自动启动**：项目 askd 和提供商运行时会在需要时自动在项目 tmux 命名空间中启动。\n- **会话鲁棒性**：通过 PID 活性检查防止会话过期。\n\n### v4.1.3\n- **Codex 配置**：自动将已弃用的 `sandbox_mode = \"full-auto\"` 迁移到 `\"danger-full-access\"`，以修复 Codex 启动问题。\n- **稳定性**：修复了快速退出命令可能在设置 `remain-on-exit` 之前关闭窗格的竞争条件。\n- **Tmux**：增强了窗格检测（优先使用稳定的 `$TMUX_PANE` 环境变量），并在拆分目标消失时提供更好的回退机制。\n\n### v4.1.2\n- **性能**：为 Tmux 状态栏（Git 分支和 CCB 状态）添加缓存，以降低系统负载。\n- **严格 Tmux**：明确要求必须安装 `tmux` 才能自动启动；移除了容易出错的自动附加逻辑。\n- **CLI**：新增 `--print-version` 标志，用于快速检查版本。\n\n### v4.1.1\n- **CLI 修复**：改进了在 Tmux 中重新启动 `ccb` 时标志位（如 `-a`）的保留。\n- **用户体验**：在非交互式会话中运行时，提供更友好的错误信息。\n- **安装**：强制更新技能，确保应用最新版本。\n\n### v4.1.0\n- **异步护栏**：`cask\u002Fgask\u002Foask` 在提交后会打印 Claude 的护栏提醒。\n- **同步模式**：新增 `--sync` 参数，用于抑制 Codex 调用者收到的护栏提示。\n- **Codex 技能**：更新 `oask\u002Fgask` 技能，在使用 `--sync` 时静默等待。\n\n### v4.0.9\n- **Project_ID 简化**：`ccb_project_id` 使用当前目录下的 `.ccb\u002F` 锚点（无需向上遍历父目录，也不依赖 Git）。\n- **Codex 技能稳定性**：Codex 的 `oask\u002Fgask` 技能默认设置为等待状态（`--timeout -1`），以避免过早发送下一个任务。\n\n### v4.0.8\n- **Codex 日志绑定刷新**：Codex 运行时现在会定期通过解析 `start_cmd` 并扫描最新日志来刷新 `.codex-session` 日志路径。\n- **Tmux 剪贴板增强**：增加了对 `xsel` 的支持，并引入了 `update-environment`，以更好地实现 GUI 和远程会话之间的剪贴板集成。\n\n### v4.0.7\n- **Tmux 状态栏重新设计**：采用双行状态栏，使用现代圆点指示器（●\u002F○）、Git 分支和 CCB 版本显示。\n- **会话新鲜度**：始终扫描日志以获取最新的会话，而不是使用缓存的会话文件。\n- **简化自动模式（历史记录）**：自动权限行为现已整合到当前的主要启动流程中。\n\n### v4.0.6\n- **会话覆盖**：`cping\u002Fgping\u002Foping\u002Fcpend\u002Fopend` 支持 `--session-file` \u002F `CCB_SESSION_FILE`，以绕过错误的工作目录。\n\n### v4.0.5\n- **Gemini 可靠性**：重试读取 Gemini 会话 JSON 文件，以避免短暂的部分写入失败。\n- **Claude 代码可靠性**：`gpend` 支持 `--session-file` \u002F `CCB_SESSION_FILE`，以绕过错误的工作目录。\n\n### v4.0.4\n- **修复**：在启动 Codex 之前，自动修复 `~\u002F.codex\u002Fconfig.toml` 中重复的 `[projects.\\\"...\\\"]` 条目。\n\n### v4.0.3\n- **项目整洁性**：将会话文件存储在 `.ccb\u002F` 目录下（回退到旧版根目录中的 dotfiles）。\n- **Claude 代码可靠性**：`cask\u002Fgask\u002Foask` 支持 `--session-file` \u002F `CCB_SESSION_FILE`，以绕过错误的工作目录。\n- **Codex 配置安全性**：将自动批准设置写入带有 CCB 标记的区块中，以避免配置冲突。\n\n### v4.0.2\n- **剪贴板粘贴**：在 Tmux 配置中支持跨平台工具（xclip\u002Fwl-paste\u002Fpbpaste）。\n- **安装用户体验**：安装完成后自动重新加载 Tmux 配置。\n- **稳定性**：默认将 TMUX_ENTER_DELAY 设置为 0.5 秒，以提高可靠性。\n\n### v4.0.1\n- **东京之夜主题**：将 Tmux 状态栏和窗格边框切换为东京之夜配色方案。\n\n### v4.0\n- **全面重构**：从头开始重建，采用更清晰的架构。\n- **完美支持 Tmux**：一流的拆分、窗格标签、边框和状态栏。\n- **适用于任何终端**：建议所有操作都在 Tmux 中进行（Windows 原生环境除外）。\n\n### v3.0.0\n- **智能运行队列**：项目询问具有 60 秒空闲超时，并支持提供商队列。\n- **跨 AI 协作**：支持多个代理（Claude\u002FCodex）同时调用一个代理（OpenCode）。\n- **中断检测**：Gemini 现在支持智能的中断处理。\n- **链式执行**：Codex 可以调用 `oask` 来驱动 OpenCode。\n- **稳定性**：强大的队列管理和锁文件机制。\n\n### v2.3.9\n- 修复 oask 会话跟踪 bug——当 OpenCode 创建新会话时，oask 会跟随新的会话。\n\n### v2.3.8\n- 无论是否使用 `-a` 标志，自动流项目均可启用计划模式。\n\n### v2.3.7\n- 按目录加锁：不同的工作目录可以独立运行 cask\u002Fgask\u002Foask。\n\n### v2.3.6\n- 为 cask\u002Fgask\u002Foask 添加非阻塞锁，以防止并发请求。\n- 统一 oask 与 cask\u002Fgask 的逻辑（使用 _wait_for_complete_reply）。\n\n### v2.3.5\n- 修复计划模式与自动模式（--dangerously-skip-permissions）的冲突。\n- 修复 oask 在 OpenCode 仍在处理时返回过时回复的问题。\n\n### v2.3.4\n- 自动启用计划模式，当自动流功能被安装时。\n\n### v2.3.3\n- 简化 cping.md，使其与 oping\u002Fgping 风格一致（减少约 65% 的令牌数量）。\n\n### v2.3.2\n- 优化技能文件：将常见模式提取到 docs\u002Fasync-ask-pattern.md 中（减少约 60% 的令牌数量）。\n\n### v2.3.1\n- 修复 gask\u002Fcask 中的竞争条件：在进入等待循环前先检查是否存在消息。","# CCB v6 快速上手指南\n\n**claude_code_bridge (CCB)** 是一个原生的多智能体运行时工具，专为终端分屏协作设计。它允许 Claude、Codex、Gemini 等多个 AI 代理并行运行，拥有独立的角色、任务流和技能库，并通过内置通信层相互委托任务。\n\n## 环境准备\n\n### 系统要求\n- **操作系统**: Linux (推荐), macOS, Windows (需 WSL)\n- **核心依赖**: \n  - `tmux` (必须安装，用于终端分屏管理)\n  - `git` (用于项目版本控制及 worktree 隔离)\n  - Python 3.x (通常系统自带)\n\n### 前置检查\n在开始之前，请确保已安装 `tmux`。\n- **Linux (Ubuntu\u002FDebian)**: `sudo apt install tmux`\n- **macOS**: `brew install tmux`\n- **注意**: 如果在 macOS 上使用 Homebrew 缺失，安装脚本会发出警告。\n\n## 安装步骤\n\n目前官方主要提供基于 GitHub Release 的安装方式。\n\n1. **克隆或下载项目**\n   从 GitHub 获取最新源码或释放包（Release Tarball）。\n   ```bash\n   git clone https:\u002F\u002Fgithub.com\u002Fyour-repo\u002Fclaude_code_bridge.git\n   cd claude_code_bridge\n   ```\n   *(注：请将 `your-repo` 替换为实际的仓库地址，若直接下载 release 包请解压进入目录)*\n\n2. **执行安装脚本**\n   运行提供的安装脚本以配置环境。\n   ```bash\n   .\u002Finstall.sh\n   ```\n   *如果是 Linux 用户且已安装旧版本 (v6.0.1\u002Fv6.0.2)，可直接使用内置更新命令升级（见下文）。*\n\n3. **验证安装**\n   安装完成后，确保 `ccb` 命令可用：\n   ```bash\n   ccb --help\n   ```\n\n## 基本使用\n\n### 1. 启动多智能体环境\n进入你的项目根目录，运行以下命令启动 CCB。它会自动读取或创建 `.ccb\u002Fccb.config` 配置文件，并打开 tmux 分屏界面。\n\n```bash\nccb\n```\n\n- **安全模式**: 如果遇到问题，可使用安全模式启动：\n  ```bash\n  ccb -s\n  ```\n- **重建状态**: 如果项目状态损坏，可重建运行时状态（保留配置）：\n  ```bash\n  ccb -n\n  ```\n\n### 2. 配置智能体布局\nCCB 的行为由项目目录下的 `.ccb\u002Fccb.config` 文件控制。你可以定义智能体名称、使用的模型提供商以及分屏布局。\n\n**配置语法简表：**\n- `;` : 左右分割分屏\n- `,` : 上下分割分屏\n- `agent_name:provider` : 定义一个智能体\n- `(worktree)` : 让该智能体在独立的 Git Worktree 中运行（避免文件冲突）\n\n**示例配置 (` .ccb\u002Fccb.config`):**\n```text\ncmd; writer:codex, reviewer:claude; qa:gemini(worktree)\n```\n*上述配置含义：*\n- 左侧面板：命令行工具 (`cmd`)\n- 右侧区域垂直分为两部分：\n  - 右上：`writer` 智能体 (使用 Codex)\n  - 右下：水平分为 `reviewer` (Claude) 和 `qa` (Gemini，独立工作树)\n\n### 3. 智能体间通信\n在任意智能体的终端界面中，可以使用内置命令进行协作：\n\n- **广播消息** (通知所有在线智能体):\n  ```text\n  \u002Fask all \"sync on the latest repo state\"\n  ```\n\n- **定向委托** (指派特定任务给某个智能体):\n  ```text\n  \u002Fask reviewer \"review the new parser change\"\n  ```\n\n- **典型工作流**:\n  1. 使用 `\u002Fask all` 进行全局同步。\n  2. 使用 `\u002Fask \u003Cagent_name>` 将具体任务委派给具备相应技能的智能体。\n  3. 智能体之间会自动调用技能并相互通信，无需人工频繁干预。\n\n### 4. 关闭与清理\n- **正常退出**:\n  ```bash\n  ccb kill\n  ```\n- **深度清理** (强制退出并清理残留会话):\n  ```bash\n  ccb kill -f\n  ```\n\n### 5. 版本更新 (仅限 Linux\u002FWSL)\n对于 v6.x 版本，Linux 用户可以直接通过命令升级到最新稳定版：\n```bash\nccb update\n```\n*注意：升级到 6.0.0 及以上大版本时需要确认提示。*","某全栈开发团队正在紧急重构一个遗留微服务系统，需要同时完成代码生成、安全审查和跨语言单元测试。\n\n### 没有 claude_code_bridge 时\n- 开发者需在多个浏览器标签页间频繁切换，分别向 Claude、Codex 和 Gemini 重复粘贴上下文，导致注意力分散且效率低下。\n- 不同 AI 模型之间缺乏沟通机制，代码生成者不知道审查者的反馈，往往要人工充当“传话筒”来同步修改意见。\n- 并行任务难以管理，例如让一个模型写代码而另一个模型运行测试时，容易因共享目录冲突导致文件覆盖或状态不一致。\n- 上下文窗口浪费严重，每次新对话都要重新输入项目背景，不仅消耗大量 Token，还容易丢失之前的关键决策逻辑。\n\n### 使用 claude_code_bridge 后\n- 终端通过分屏技术原生并排运行多个 Agent，左侧 Codex 实时编写解析器，右侧 Claude 同步进行代码审查，所有交互过程一目了然。\n- 内置通信层支持定向委托，开发者只需输入 `\u002Fask reviewer \"检查新解析器\"`，即可将任务无缝流转给特定角色，无需人工中转。\n- 支持独立的 Git 工作树模式，QA 代理可在隔离环境中安全地执行破坏性测试或安装依赖，彻底避免污染主开发分支。\n- 项目级持久化上下文让所有 Agent 共享同一份记忆，无论是全局广播同步状态还是点对点协作，都无需重复提示词，大幅降低 Token 开销。\n\nclaude_code_bridge 将原本割裂的单点 AI 辅助升级为可视化的多智能体协同流水线，让复杂的软件工程任务像交响乐般有序并行。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fbfly123_claude_code_bridge_7542b41d.png","bfly123",null,"https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fbfly123_e7f37475.png","https:\u002F\u002Fgithub.com\u002Fbfly123",[19,23,27,31],{"name":20,"color":21,"percentage":22},"Python","#3572A5",97,{"name":24,"color":25,"percentage":26},"Shell","#89e051",2.3,{"name":28,"color":29,"percentage":30},"PowerShell","#012456",0.7,{"name":32,"color":33,"percentage":34},"Batchfile","#C1F12E",0,2289,215,"2026-04-18T08:08:38","NOASSERTION",2,"Linux, macOS, Windows","未说明",{"notes":43,"python":41,"dependencies":44},"该工具是一个终端多智能体运行时框架，依赖外部 AI 服务（如 Claude、Codex、Gemini 等）而非本地运行大模型，因此无特定 GPU、显存或 CUDA 版本要求。核心依赖为终端复用器 tmux 和版本控制工具 git。在 macOS 上若未安装 Homebrew，安装脚本会发出警告。支持通过配置文件的 worktree 模式让特定代理在隔离的 Git 工作树中运行以避免冲突。",[45,46],"tmux (macOS 需通过 Homebrew 安装)","git",[48,49,50,51],"插件","开发框架","语言模型","Agent",[53,54,55,56,57,58,59,60,61,62,63],"ai-collaboration","ai-tools","claude-code","cli","codex","cross-platform","gemini","llm","multi-agent-systems","python","terminal","ready","2026-03-27T02:49:30.150509","2026-04-18T22:31:42.846616",[68,73,78,83,88,93,98,103],{"id":69,"question_zh":70,"answer_zh":71,"source_url":72},40841,"如何在 Windows 上安装和使用 CCB？","项目已支持 Windows。维护者已增加了详细的 Windows 安装说明，请查阅项目文档中的安装指南。如果遇到具体问题，建议先尝试运行更新命令或重新安装最新版本。","https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge\u002Fissues\u002F3",{"id":74,"question_zh":75,"answer_zh":76,"source_url":77},40842,"启动 Codex 时报错“找不到进程”或权限错误怎么办（macOS）？","如果在 macOS 上启动时不使用 `-a` 参数报找不到进程错误，可以尝试添加 `-a` 参数以启用全自动权限模式（`ccb -a`）。如果仍有问题，可能是 tmux 输入或中文输入法导致的，建议切换到英文输入法尝试，或在 tmux 中按几次 'q' 退出 copy mode。该问题在最新版本中已修复。","https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge\u002Fissues\u002F1",{"id":79,"question_zh":80,"answer_zh":81,"source_url":82},40843,"如何查看多轮对话历史或获取子代理（如 Codex\u002FGemini）的最新输出？","可以使用 `cpend` 命令查看多轮对话历史。对于通过 CCB 启动的 Codex 或 Gemini，即使不使用 cask，也可以通过 `cpend` 获取最新输出。如果需要让一个代理获取另一个代理的输出，目前可以通过共享上下文文件或手动复制实现，具体取决于配置。","https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge\u002Fissues\u002F9",{"id":84,"question_zh":85,"answer_zh":86,"source_url":87},40844,"是否支持 Qwen CLI？如何启动 Qwen？","已支持 Qwen CLI。确保升级到最新版本，Qwen 代码已合并到 main 分支。启动后，`ccb --help` 的 providers 列表中应包含 `qwen`。可以通过 `ccb qwen` 启动，或使用 `qask \"消息内容\"` \u002F `ask qwen \"消息内容\"` 发送消息。如果帮助信息未显示，请运行 `ccb update` 更新到最新版。","https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge\u002Fissues\u002F59",{"id":89,"question_zh":90,"answer_zh":91,"source_url":92},40845,"使用 gask\u002Fcask 发送任务时输出被截断，看不到完整结果怎么办？","这是由于 `CCB_END_TURN` 标记机制与异步任务冲突导致的。在新版本中已修复：`gask`\u002F`cask` 现在仅负责后台提交请求并立即退出；若要前台阻塞等待并输出完整结果，请使用 `gask-w` 或 `cask-w` 命令，或者通过 `gpend`\u002F`cpend` 及指定的 output 文件获取完整输出。请升级到最新版本以解决此问题。","https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge\u002Fissues\u002F20",{"id":94,"question_zh":95,"answer_zh":96,"source_url":97},40846,"Headless Linux (如 Ubuntu 服务器) 环境下无法启动 WezTerm 或报错怎么办？","WezTerm 通常需要图形界面环境。在无显示器（headless）的 Ubuntu 服务器上，建议直接使用 tmux 模式而不是 WezTerm。如果必须排查错误，可以让 Claude 协助分析日志。对于纯命令行环境，确保安装了 tmux，并尝试运行 `ccb up codex` 或 `ccb up claude` 指定后端启动，避免依赖图形前端。","https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge\u002Fissues\u002F12",{"id":99,"question_zh":100,"answer_zh":101,"source_url":102},40847,"安装后系统自带的 ping 命令被 CCB 的 ping 技能覆盖了怎么办？","这是因为安装脚本创建了名为 `ping` 的技能文件，可能干扰了系统命令路径。解决方法是彻底卸载并清理残留文件，然后重新运行安装或更新命令。可以尝试运行 `ccb uninstall` 后手动检查 `~\u002F.local\u002Fbin` 或技能目录，删除冲突文件，再执行 `ccb update` 或重新安装最新版本。","https:\u002F\u002Fgithub.com\u002Fbfly123\u002Fclaude_code_bridge\u002Fissues\u002F85",{"id":104,"question_zh":105,"answer_zh":106,"source_url":77},40848,"MacOS 下启动时只打开了 Codex，Claude 没有自动启动且 .md 配置文件被覆盖？","这是一个已知的小 Bug。目前可以手动打开 Claude 进行询问。关于配置文件被覆盖的问题，建议在启动前备份原有的 `.md` 配置文件。维护者正在修复 MacOS 下的自动启动逻辑和文件写入冲突问题，请保持软件更新至最新版本。",[108,113,118,123,128,133],{"id":109,"version":110,"summary_zh":111,"released_at":112},324411,"v6.0.4","## 亮点\n- 通过为解压后的安装程序目录提供兼容性别名，使 Linux 发布资产与较旧的 6.x 更新程序向后兼容。\n- 恢复从现有的 `v6.0.1` 和 `v6.0.2` 安装到最新稳定版本的端到端 `ccb update` 功能。\n- 保留 `v6.0.3` 更新程序中的修复，以便当前运行时能够正确解析解压后的发布目录，而无需依赖该别名。\n\n## 包含早期 6.0.x 版本的修复\n- 来自 `v6.0.2` 的调用方归属和异步邮箱路由修复。\n- `install.sh` 中的 macOS Homebrew 警告。\n- 针对本地 `.ccb-requests\u002F` 残留文件的发布构建卫生改进。\n\n## 资产\n- `ccb-linux-x86_64.tar.gz`\n- `SHA256SUMS`","2026-04-17T13:42:52",{"id":114,"version":115,"summary_zh":116,"released_at":117},324412,"v6.0.3","## 亮点\n- 修复 `ccb update` 命令，使发布 tarball 升级能够正确解析解压后的目录，而不是将 `.tar.gz` 文件名当作文件夹处理。\n- 恢复端到端的自更新功能，通过正确查找解压后的发布资产中的 `install.sh` 脚本来实现。\n- 在 Linux 发布打包过程中忽略本地 `.ccb-requests\u002F` 邮箱残留文件，以确保官方构建的可重复性。\n\n## 包含 v6.0.2 的变更\n- 修复代理间回复的调用方归属问题。\n- 为异步委派任务（包括以 `cmd` 为锚点的工作流）提供稳定的邮箱路由。\n- 修复代理配置大小写混合情况下的恢复问题。\n- 在 `install.sh` 中添加 macOS Homebrew 警告信息。\n\n## 资产\n- `ccb-linux-x86_64.tar.gz`\n- `SHA256SUMS`","2026-04-17T13:35:07",{"id":119,"version":120,"summary_zh":121,"released_at":122},324413,"v6.0.2","## 亮点\n- 修复呼叫方归属问题，使 `ccb ask` 回复能够返回到正确的坐席邮箱，而不会漂移到 `user` 或 `cmd`。\n- 保持代理任务的异步回复路由稳定，包括以 `cmd` 为锚点的流程。\n- 在配置布局恢复过程中，对大小写混合的坐席名称进行规范化处理。\n- 在安装 tmux 及相关依赖之前，向 macOS 用户提示 Homebrew 是否缺失。\n- 在 Linux 发布包打包过程中忽略本地 `.ccb-requests\u002F` 目录残留，以确保官方构建的可重复性。\n\n## 资产\n- `ccb-linux-x86_64.tar.gz`\n- `SHA256SUMS`","2026-04-17T13:25:58",{"id":124,"version":125,"summary_zh":126,"released_at":127},324414,"v6.0.1","v6 系列的补丁版本。   - 移除了意外被追踪、污染 GitHub 源代码归档的 .tmp_pytest 临时文件   - 加强了升级解压过程，防止解压到不安全的符号链接目标   - 增加了仓库清洁度检查，以确保临时测试产物不会再次被追踪    该版本是那些在升级至 v6 时遇到源代码归档解压失败用户的推荐安全升级目标。","2026-04-16T12:26:45",{"id":129,"version":130,"summary_zh":131,"released_at":132},324415,"v6.0.0","CCB v6.0.0 是全新的 Linux 版本，专注于无限并行代理、原生代理间通信以及简化的用户命令界面。\n\n亮点：\n- 支持可见分屏并发的无限并行代理运行时\n- 简化后的公共 CLI：ccb、ccb -s、ccb -n、ccb kill、ccb kill -f\n- 围绕“ask all”和“ask agent_name”构建的原生通信流程\n- 精简的 .ccb\u002Fccb.config 文件，通过 agent:provider(worktree) 显式指定工作树模式\n- 仅限 Linux\u002FWSL 的基于发行版的 ccb 更新流程\n- 更强大的 Gemini 多轮补全检测能力\n- 在用 v6+ 替代 v6 之前的安装之前，需明确确认进行重大升级\n\n升级说明：\n- 在 v6 之前的项目中首次运行 ccb 时，CCB 会保留 .ccb\u002Fccb.config 文件，清除 .ccb 下的旧运行时状态，并在本地重新构建。\n- 在 6.x 版本中，ccb update 将在 Linux\u002FWSL 上安装 GitHub 发布资产，而非源代码压缩包。\n- 使用较早源代码版本安装的用户应主动迁移，而不应自动跟随主分支更新。","2026-04-16T11:19:25",{"id":134,"version":135,"summary_zh":136,"released_at":137},324416,"2.0","\r\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fdd4fb51d-bbe0-4aa1-864a-fee06ff4d2ba\r\n\r\n","2025-12-17T13:23:02",[139,150,158,166,175,183],{"id":140,"name":141,"github_repo":142,"description_zh":143,"stars":144,"difficulty_score":145,"last_commit_at":146,"category_tags":147,"status":64},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[51,49,148,149],"图像","数据工具",{"id":151,"name":152,"github_repo":153,"description_zh":154,"stars":155,"difficulty_score":145,"last_commit_at":156,"category_tags":157,"status":64},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[49,148,51],{"id":159,"name":160,"github_repo":161,"description_zh":162,"stars":163,"difficulty_score":39,"last_commit_at":164,"category_tags":165,"status":64},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",160015,"2026-04-18T11:30:52",[49,51,50],{"id":167,"name":168,"github_repo":169,"description_zh":170,"stars":171,"difficulty_score":172,"last_commit_at":173,"category_tags":174,"status":64},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[51,48],{"id":176,"name":177,"github_repo":178,"description_zh":179,"stars":180,"difficulty_score":39,"last_commit_at":181,"category_tags":182,"status":64},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,"2026-04-18T11:18:24",[49,148,51],{"id":184,"name":185,"github_repo":186,"description_zh":187,"stars":188,"difficulty_score":39,"last_commit_at":189,"category_tags":190,"status":64},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[48,51,148,49]]