by SeemSeam
Visible multi-agent CLI workspace for mixing Codex, Claude, Gemini, Kimi, Qwen, Cursor, Copilot, Pi, OpenCode, and other AI coding agents
# Add to your Claude Code skills
git clone https://github.com/SeemSeam/claude_codex_bridgeGuides for using ai agents skills like claude_codex_bridge.
Last scanned: 5/10/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-10T06:32:58.802Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}A lightweight multi-agent TUI with a stable cross-provider collaboration layer Coordinate Codex, Claude, Gemini, and other CLI agents in visible, controllable workflows you can take over
中文 | English | 日本語 | Français | Deutsch | العربية | Español | Português | 한국어 | Русский
Quick Start · Mobile App · Rich Mode · Configure Agents · User Guide · Developer Guide
A -> B -> C, A,B -> C, and A -> B,C.Install or update an npm-managed CCB with npm:
npm install -g @seemseam/ccb@latest
For GitHub release-package or source installs, use CCB's transactional updater:
ccb update
On an npm-managed install, ccb update prints the equivalent npm command and
does not modify npm's vendored payload in place.
CCB-managed provider panes suppress known provider-native startup update prompts.
After updating CCB—or immediately when CCB is already current—ccb update
checks installed provider CLIs and offers supported updates once. Use
--providers check, --providers all, or --providers none for explicit
report-only, non-interactive update, or skip behavior. Declining prompts again
on the next ccb update; skipping a version hides only that exact version.
CCB never restarts active provider panes during this flow, so an accepted
provider update applies when that pane next starts or is explicitly restarted.
After a release change, the newly installed CCB also retires old
project-scoped Claude/Gemini caches. Manifest-valid caches for deleted projects
are removed immediately. A stopped current project is cleaned immediately;
active or other existing projects are preserved and cleaned after their next
successful ccb kill. Unknown providers, malformed manifests, foreign
symlinks, sessions/auth, and the user-scoped Gemini cache are never removed by
this migration. Use ccb update --no-cache-cleanup to skip it for one update.
To roll back, use the same transactional updater with an older released version,
for example ccb update 8.1.3. CCB rejects a same-version artifact whose build
identity differs from the installed build, and restores the prior local prefix
if the update transaction fails. If restoration itself cannot complete, CCB
retains and reports the external recovery backup path.
If npm is not convenient in your environment, download the matching package from Releases, unpack it, and install:
tar -xzf ccb-*.tar.gz
cd ccb-*
./install.sh install
Source install is intended only for development or temporary fallback:
git clone https://github.com/SeemSeam/claude_codex_bridge.git
cd claude_codex_bridge
./install.sh install
Source install links global ccb / ask back to the checkout. Regular users should prefer the npm package.
Run this from your working directory:
ccb
If startup reports that .ccb cannot be created automatically or that the project anchor is missing, create .ccb manually:
mkdir -p .ccb
A blank project starts light: CCB opens one main window with a single agent named demo, selecting the first supported CLI available on the machine (Codex, Claude, Gemini, then other providers). It no longer mounts a multi-agent team by default.
Click the ⚙ Settings icon at the top-left of the CCB sidebar to open the local configuration control panel. You can also run ccb config ui from the project directory.
The Config UI always binds to loopback. To use a stable local port and token, configure a token source in .ccb/ccb.config; never put a literal token in that file:
[config_ui]
port = 43123
token_env = "CCB_CONFIG_UI_TOKEN"
# Or use this instead of token_env:
# token_file = ".ccb/config-ui.token"
--port remains a one-run override. token_file must be project-relative, non-symlinked, and owner-only (chmod 600 .ccb/config-ui.token on POSIX). Without a token source, CCB keeps the existing random token and ephemeral-port behavior. The CLI prints only the loopback URL and token source, never the token value.
The panel edits windows, pane splits, providers, models, thinking levels, API overrides, workspaces, Rich mode, and sidebar settings. It validates changes before saving and supports reload dry-runs and guarded hot reload. Saving creates .ccb/ccb.config and pins the selected provider and topology for this project.
For an advanced multi-agent topology, edit it visually or create .ccb/ccb.config manually. In v2 [windows], , and ; control vertical stacking and horizontal splits inside each window, so A,B;C,D is close to a four-pane layout.
version = 2
[windows]
main = "main:codex"
work = "worker1:codex(worktree), worker2:claude(worktree)"
review = "reviewer:claude, qa:gemini"
[ui.sidebar]
mode = "every_window"
width = "15%"
bottom_height = 20
agents_height = "50%"
comms_height = "15%"
tips_height = "35%"
comms_limit = 3
Validate the config and start the workspace:
ccb config validate
ccb
You can type directly in any agent pane, or let agents collaborate:
/ask reviewer review the latest parser changes and list blocking issues.
Agents can also call /ask during workflow orchestration to delegate and hand off work. Use agent memory or the project-wide shared memory file .ccb/ccb_memory.md for durable coordination.
The recommended way to control CCB from a phone can connect to all CCB projects, control each agent, accept voice input, and transfer files.
ccb update mobile
This command guides installation and configuration.
CCB 8.5.6 includes the Flutter CCB Mobile source in mobile/ and publishes the Android APK through GitHub Releases:
mobile/applib/mobile_gatewayThe phone app is a remote controller for real CCB projects
claude_codex_bridge is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by SeemSeam. Visible multi-agent CLI workspace for mixing Codex, Claude, Gemini, Kimi, Qwen, Cursor, Copilot, Pi, OpenCode, and other AI coding agents. It has 3,377 GitHub stars.
Yes. claude_codex_bridge passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/SeemSeam/claude_codex_bridge" and add it to your Claude Code skills directory (see the Installation section above).
claude_codex_bridge is primarily written in Python. It is open-source under SeemSeam on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh claude_codex_bridge against similar tools.
No comments yet. Be the first to share your thoughts!