Claude Code Bridge (ccb) v4.1.0

Silky Smooth Claude & Codex & Gemini Collaboration via Split-Pane Terminal

Build a real AI expert team. Give Claude Code / Codex / Gemini / OpenCode partners that never forget.

English | 中文

Introduction: Multi-model collaboration effectively avoids model bias, cognitive blind spots, and context limitations. However, MCP, Skills and other direct API approaches have many limitations. This project offers a new WYSIWYG solution.

⚡ Why ccb?

Feature	Benefit
🖥️ Visual & Controllable	Multiple AI models in split-pane CLI. See everything, control everything.
🧠 Persistent Context	Each AI maintains its own memory. Close and resume anytime (`-r` flag).
📉 Token Savings	Sends lightweight prompts instead of full file history.
🪟 Native Workflow	Integrates directly into WezTerm (recommended) or tmux. No complex servers required.

🚀 What's New in v4.0

People keep asking how this differs from other workflow tools. My one-sentence answer: this project is a visible & controllable multi-model communication layer built out of dissatisfaction with API-style agent interactions; it is not a workflow project, but it makes it much easier to build the workflow you want on top.

New way to play: pair it with VS Code (see video above) for an integrated CLI experience

Rebuilt for tmux-first, any terminal, and remote workflows

Full Refactor: Cleaner structure, better stability, and easier extension.
Terminal Backend Abstraction: Unified terminal layer (TmuxBackend / WeztermBackend) with auto-detection and WSL path handling.
Perfect tmux Experience: Stable layouts + pane titles/borders + session-scoped theming that restores on exit.
Works in Any Terminal: If your terminal can run tmux, CCB can provide the full multi-model split experience (except native Windows; WezTerm recommended; otherwise just use tmux).

🚀 What's New in v3.0

The Ultimate Bridge for Cross-AI Collaboration

v3.0 brings a revolutionary architecture change with Smart Daemons, enabling parallel execution, cross-agent coordination, and enterprise-grade stability.

✨ Key Features

🔄 True Parallelism: Submit multiple tasks to Codex, Gemini, or OpenCode simultaneously. The new daemons (caskd, gaskd, oaskd) automatically queue and execute them serially, ensuring no context pollution.
🤝 Cross-AI Orchestration: Claude and Codex can now simultaneously drive OpenCode agents. All requests are arbitrated by the unified daemon layer.
🛡️ Bulletproof Stability: Daemons are self-managing—they start automatically on the first request and shut down after 60s of idleness to save resources.
⚡ Chained Execution: Advanced workflows supported! Codex can autonomously call oask to delegate sub-tasks to OpenCode models.
🛑 Smart Interruption: Gemini tasks now support intelligent interruption detection, automatically handling stops and ensuring workflow continuity.

🧩 Feature Support Matrix

Feature	`caskd` (Codex)	`gaskd` (Gemini)	`oaskd` (OpenCode)
Parallel Queue	✅	✅	✅
Interruption Awareness	✅	✅	-
Response Isolation	✅	✅	✅

📊 View Real-world Stress Test Results

Scenario 1: Claude & Codex Concurrent Access to OpenCode Both agents firing requests simultaneously, perfectly coordinated by the daemon.

Source	Task	Result	Status
🤖 Claude	`CLAUDE-A`	CLAUDE-A	🟢
🤖 Claude	`CLAUDE-B`	CLAUDE-B	🟢
💻 Codex	`CODEX-A`	CODEX-A	🟢
💻 Codex	`CODEX-B`	CODEX-B	🟢

Scenario 2: Recursive/Chained Calls Codex autonomously driving OpenCode for a 5-step workflow.

Request	Exit Code	Response
ONE	`0`	`CODEX-ONE`
TWO	`0`	`CODEX-TWO`
THREE	`0`	`CODEX-THREE`
FOUR	`0`	`CODEX-FOUR`
FIVE	`0`	`CODEX-FIVE`

🧠 Introducing CCA (Claude Code Autoflow)

Unlock the full potential of ccb with CCA — an advanced workflow automation system built on top of this bridge.

Workflow Automation: Intelligent task assignment and automated state management.
Seamless Integration: Native support for the v3.0 daemon architecture.

👉 View Project on GitHub

Install via CCB:

ccb update cca

🚀 Quick Start

Step 1: Install WezTerm (native .exe for Windows)

Step 2: Choose installer based on your environment:

Linux

git clone https://github.com/bfly123/claude_code_bridge.git
cd claude_code_bridge
./install.sh install

macOS

git clone https://github.com/bfly123/claude_code_bridge.git
cd claude_code_bridge
./install.sh install

Note: If commands not found after install, see macOS Troubleshooting.

WSL (Windows Subsystem for Linux)

Use this if your Claude/Codex/Gemini runs in WSL.

⚠️ WARNING: Do NOT install or run ccb as root/administrator. Switch to a normal user first (su - username or create one with adduser).

# Run inside WSL terminal (as normal user, NOT root)
git clone https://github.com/bfly123/claude_code_bridge.git
cd claude_code_bridge
./install.sh install

Windows Native

Use this if your Claude/Codex/Gemini runs natively on Windows.

git clone https://github.com/bfly123/claude_code_bridge.git
cd claude_code_bridge
powershell -ExecutionPolicy Bypass -File .\install.ps1 install

Run

ccb up codex            # Start Codex
ccb up gemini           # Start Gemini
ccb up opencode         # Start OpenCode
ccb up codex gemini     # Start both
ccb up codex gemini opencode  # Start all three (spaces)
ccb up codex,gemini,opencode  # Start all three (commas)

tmux tip: CCB's tmux status/pane theming is enabled only while CCB is running.
ccb-layout              # Start 2x2 layout (Codex+Gemini+OpenCode)

Flags

Flag	Description	Example
`-r`	Resume previous session context	`ccb up codex -r`
`-a`	Auto-mode, skip permission prompts	`ccb up codex -a`
`-h`	Show help information	`ccb -h`
`-v`	Show version and check for updates	`ccb -v`

Update

ccb update              # Update ccb to the latest version

🪟 Windows Installation Guide (WSL vs Native)

Key Point: ccb/cask/cping/cpend must run in the same environment as codex/gemini. The most common issue is environment mismatch causing cping to fail.

1) Prerequisites: Install Native WezTerm

Install Windows native WezTerm (.exe from official site or via winget), not the Linux version inside WSL.
Reason: ccb in WezTerm mode relies on wezterm cli to manage panes.

2) How to Identify Your Environment

Determine based on how you installed/run Claude Code/Codex:

WSL Environment
- You installed/run via WSL terminal (Ubuntu/Debian) using bash (e.g., curl ... | bash, apt, pip, npm)
- Paths look like: /home/<user>/... and you may see /mnt/c/...
- Verify: cat /proc/version | grep -i microsoft has output, or echo $WSL_DISTRO_NAME is non-empty
Native Windows Environment
- You installed/run via Windows Terminal / WezTerm / PowerShell / CMD (e.g., winget, PowerShell scripts)
- Paths look like: C:\Users\<user>\...

3) WSL Users: Configure WezTerm to Auto-Enter WSL

Edit WezTerm config (%USERPROFILE%\.wezterm.lua):

local wezterm = require 'wezterm'
return {
  default_domain = 'WSL:Ubuntu', -- Replace with your distro name
}

Check distro name with wsl -l -v in PowerShell.

4) Troubleshooting: `cping` Not Working

Most common: Environment mismatch (ccb in WSL but codex in native Windows, or vice versa)
Codex session not running: Run ccb up codex first
WezTerm CLI not found: Ensure wezterm is in PATH
Terminal not refreshed: Restart WezTerm after installation
Text sent but not submitted (no Enter) on Windows WezTerm: Set CCB_WEZTERM_ENTER_METHOD=key and ensure your WezTerm supports wezterm cli send-key

🍎 macOS Installation Guide

Command Not Found After Installation

If ccb, cask, cping commands are not found after running ./install.sh install:

Cause: The install directory (~/.local/bin) is not in your PATH.

Solution:

# 1. Check if install directory exists
ls -la ~/.local/bin/

# 2. Check if PATH includes the directory
echo $PATH | tr ':' '\n' | grep local

# 3. Check shell config (macOS defaults to zsh)
cat ~/.zshrc | grep local

# 4. If not configured, add manually
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc

# 5. Reload config
source ~/.zshrc

WezTerm Not Detecting Commands

If WezTerm cannot find ccb commands but regular Terminal can:

WezTerm may use a different shell config
Add PATH to ~/.zprofile as well:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zprofile

Then restart WezTerm completely (Cmd+Q, reopen).

🗣️ Usage

Once started, collaborate naturally. Claude will detect when to delegate tasks.

Common Scenarios:

Code Review: "Have Codex review the changes in main.py."
Second Opinion: "Ask Gemini for alternative implementation approaches."
Pair Programming: "Codex writes the backend logic, I'll handle the frontend."
Architecture: "Let Codex design the module structure first."
Info Exchange: "Fetch 3 rounds of Codex conversation and summarize."

🎴 Fun & Creative: AI Poker Night!

"Let Claude, Codex and Gemini play Dou Di Zhu (斗地主)! You deal the cards, everyone plays open hand!"

🃏 Claude (Landlord) vs 🎯 Codex + 💎 Gemini (Farmers)

Note: Manual commands (like cask, cping) are usually invoked by Claude automatically. See Command Reference for details.

📝 Command Reference

Codex Commands

Command	Description
`/cask <msg>`	Background mode: Submit task to Codex, free to continue other tasks (recommended)
`cpend [N]`	Fetch Codex conversation history, N controls rounds (default 1)
`cping`	Test Codex connectivity

Gemini Commands

Command	Description
`/gask <msg>`	Background mode: Submit task to Gemini
`gpend [N]`	Fetch Gemini conversation history
`gping`	Test Gemini connectivity

🖥️ Editor Integration: Neovim + Multi-AI Review

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.

📋 Requirements

Python 3.10+
Terminal: WezTerm (Highly Recommended) or tmux

🗑️ Uninstall

./install.sh uninstall

Windows fully supported (WSL + Native via WezTerm)

Join our community

📧 Email: bfly123@126.com 💬 WeChat: seemseam-com

Version History

v4.1.0

Async Guardrail: cask/gask/oask print a post-submit guardrail reminder for Claude
Sync Mode: add --sync to suppress guardrail prompts for Codex callers
Codex Skills: update oask/gask skills to wait silently with --sync

v4.0.9

Project_ID Simplification: ccb_project_id uses .ccb_config/ anchor (and optional CCB_PROJECT_ROOT), no git dependency
Codex Skills Stability: Codex oask/gask skills default to waiting (--timeout -1) to avoid sending the next task too early

v4.0.8

Daemon Log Binding Refresh: caskd daemon now periodically refreshes .codex-session log paths by parsing start_cmd and scanning latest logs
Tmux Clipboard Enhancement: Added xsel support and update-environment for better clipboard integration across GUI/remote sessions

v4.0.7

Tmux Status Bar Redesign: Dual-line status bar with modern dot indicators (●/○), git branch, CCA status, and CCB version display
Session Freshness: Always scan logs for latest session instead of using cached session file
Simplified Auto Mode: Removed CCA detection logic from ccb up -a, now purely uses --dangerously-skip-permissions

v4.0.6

Session Overrides: cping/gping/oping/cpend/opend support --session-file / CCB_SESSION_FILE to bypass wrong cwd

v4.0.5

Gemini Reliability: Retry reading Gemini session JSON to avoid transient partial-write failures
Claude Code Reliability: gpend supports --session-file / CCB_SESSION_FILE to bypass wrong cwd

v4.0.4

Fix: Auto-repair duplicate [projects.\"...\"] entries in ~/.codex/config.toml before starting Codex

v4.0.3

Project Cleanliness: Store session files under .ccb_config/ (fallback to legacy root dotfiles)
Claude Code Reliability: cask/gask/oask support --session-file / CCB_SESSION_FILE to bypass wrong cwd
Codex Config Safety: Write auto-approval settings into a CCB-marked block to avoid config conflicts

v4.0.2

CCA Detection: Improved install directory inference for various layouts
Clipboard Paste: Cross-platform support (xclip/wl-paste/pbpaste) in tmux config
Install UX: Auto-reload tmux config after installation
Stability: Default TMUX_ENTER_DELAY set to 0.5s for better reliability

v4.0.1

Tokyo Night Theme: Switch tmux status bar and pane borders to Tokyo Night color palette

v4.0

Full Refactor: Rebuilt from the ground up with a cleaner architecture
Perfect tmux Support: First-class splits, pane labels, borders and statusline
Works in Any Terminal: Recommended to run everything in tmux (except native Windows)

v3.0.0

Smart Daemons: caskd/gaskd/oaskd with 60s idle timeout & parallel queue support
Cross-AI Collaboration: Support multiple agents (Claude/Codex) calling one agent (OpenCode) simultaneously
Interruption Detection: Gemini now supports intelligent interruption handling
Chained Execution: Codex can call oask to drive OpenCode
Stability: Robust queue management and lock files

v2.3.9

Fix oask session tracking bug - follow new session when OpenCode creates one

v2.3.8

Simplify CCA detection: check for .autoflow folder in current directory
Plan mode enabled for CCA projects regardless of -a flag

v2.3.7

Per-directory lock: different working directories can run cask/gask/oask independently

v2.3.6

Add non-blocking lock for cask/gask/oask to prevent concurrent requests
Unify oask with cask/gask logic (use _wait_for_complete_reply)

v2.3.5

Fix plan mode conflict with auto mode (--dangerously-skip-permissions)
Fix oask returning stale reply when OpenCode still processing

v2.3.4

Auto-enable plan mode when CCA (Claude Code Autoflow) is installed

v2.3.3

Simplify cping.md to match oping/gping style (~65% token reduction)

v2.3.2

Optimize skill files: extract common patterns to docs/async-ask-pattern.md (~60% token reduction)

v2.3.1

Fix race condition in gask/cask: pre-check for existing messages before wait loop

Name		Name	Last commit message	Last commit date
Latest commit History 256 Commits
.github/workflows		.github/workflows
assets		assets
bin		bin
codex_skills		codex_skills
commands		commands
config		config
docs		docs
lib		lib
skills		skills
test		test
.gitignore		.gitignore
CHANGELOG_4.0.md		CHANGELOG_4.0.md
LICENSE		LICENSE
README.md		README.md
README_zh.md		README_zh.md
ccb		ccb
install.cmd		install.cmd
install.ps1		install.ps1
install.sh		install.sh

Folders and files

Latest commit

History

Repository files navigation

Claude Code Bridge (ccb) v4.1.0

⚡ Why ccb?

🚀 What's New in v4.0

🚀 What's New in v3.0

✨ Key Features

🧩 Feature Support Matrix

🧠 Introducing CCA (Claude Code Autoflow)

🚀 Quick Start

Run

Flags

Update

🪟 Windows Installation Guide (WSL vs Native)

1) Prerequisites: Install Native WezTerm

2) How to Identify Your Environment

3) WSL Users: Configure WezTerm to Auto-Enter WSL

4) Troubleshooting: cping Not Working

🍎 macOS Installation Guide

Command Not Found After Installation

WezTerm Not Detecting Commands

🗣️ Usage

🎴 Fun & Creative: AI Poker Night!

📝 Command Reference

Codex Commands

Gemini Commands

🖥️ Editor Integration: Neovim + Multi-AI Review

📋 Requirements

🗑️ Uninstall

v4.1.0

v4.0.9

v4.0.8

v4.0.7

v4.0.6

v4.0.5

v4.0.4

v4.0.3

v4.0.2

v4.0.1

v4.0

v3.0.0

v2.3.9

v2.3.8

v2.3.7

v2.3.6

v2.3.5

v2.3.4

v2.3.3

v2.3.2

v2.3.1

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

4) Troubleshooting: `cping` Not Working

Packages