A terminal workspace for running multiple AI coding CLIs in parallel
Website · Download · Report a Bug · 繁體中文
demo2.mp4
If you're running Claude Code, Codex, or Gemini across multiple projects at the same time, you know the pain: opening terminals, cd-ing into repos, arranging windows, losing track of which agent is doing what.
Codirigent is a Tmux-style workspace built for this workflow. Open it once, and your sessions are already where you left them — right directory, right layout, right agent.
Multiple sessions, one view — run Claude Code, Codex, and Gemini side by side. Each session shows a real-time status indicator:
| Status | Meaning | |
|---|---|---|
| Idle |  |
Shell idle, no agent activity |
| Working |  |
Agent is generating a response |
| Attention |  |
Agent is waiting for user input or permission |
| Ready |  |
Agent finished, response is waiting in an unfocused session |
Custom layouts — arrange sessions in any grid configuration and save them. Drag and drop session headers to rearrange positions on the fly.
Synced file tree — the file explorer always reflects whichever session is focused, so you always know where you are.
Git worktree support — run agents on isolated branches simultaneously without conflicts.
Session resume — Codirigent detects and resumes previous Claude Code and Codex sessions automatically, so you pick up right where you left off.
Smart clipboard — paste text, files, or images into any session. File paths are automatically converted to shell-friendly formats for the target CLI.
Early alpha — expect rough edges. Feedback welcome.
Download the .msi installer from the latest release.
SmartScreen warning: Windows may show "Windows protected your PC" since the app is not yet code-signed. Click More info → Run anyway to proceed.
Download the .dmg from the latest release.
Codirigent uses lightweight hooks to track agent status in real time — showing whether each session is Working, Needs Attention, or has a Response Ready. If hooks are unavailable, Codirigent falls back to its reader/detector path, which is less precise.
Hooks are installed automatically on first launch for supported CLIs. Codirigent registers its codirigent-hook binary into each CLI's configuration:
| CLI | Config file | Auto-installed |
|---|---|---|
| Claude Code | ~/.claude/settings.json |
Yes |
| Codex CLI | ~/.codex/config.toml |
Yes |
| Gemini CLI | ~/.gemini/settings.json |
Yes |
To verify hooks are installed, check that codirigent-hook appears in your CLI's config file. If you move or reinstall Codirigent, relaunch it once to re-register the hooks with the updated binary path.
Prerequisites: Rust 1.75+, Windows or macOS
git clone https://github.com/oso95/Codirigent.git
cd Codirigent
cargo install --path . --all-features
cargo install --path crates/codirigent-hookThis installs both codirigent and codirigent-hook to ~/.cargo/bin/. The hook binary is required for real-time agent status tracking (see Hook Setup).
To run without installing:
cargo run --all-featuresLinux support is not yet complete.
cargo test --all --all-targets # run tests
cargo fmt --all # format
cargo clippy --all -- -D warnings # lintOpen an issue before major changes. PRs welcome.
GPL-3.0 — see LICENSE.
