kmux

Run Claude Code, Codex CLI, Gemini CLI, and Antigravity CLI side-by-side — without losing track of any of them.

A macOS workspace for AI coding agents: parallel sessions, integrated usage, instant resume, worktree-safe branches.

English | 日本語 | 简体中文 | 한국어 | Español

 

✨ Why kmux?

If you've started leaning on Claude Code, Codex CLI, Gemini CLI, and Antigravity CLI for real work, you've already hit the friction: multiple terminals, multiple agent surfaces, separate session histories, and no good way to keep them from stepping on each other inside the same repo.

kmux is a macOS workspace built around exactly that workflow:

• Park each agent in its own workspace and run them in parallel
• Get native macOS notifications when any agent needs input or finishes
• Track combined usage and remaining session budgets in one sidebar
• Jump back into any past Claude/Codex/Gemini/Antigravity session with one click
• Spin up a git worktree so two agents can edit the same repo on different branches safely

It's keyboard-first by design — every workflow is reachable from the home row — but that's how it gets out of your way, not the headline.

🚀 Highlights

📊 Unified Usage Dashboard Track Claude Code, Codex CLI, Gemini CLI, and Antigravity CLI side-by-side in one right-sidebar panel. Usage and state roll up from each provider's local records where available, while lifecycle hooks stay focused on live status and notifications. A daily heatmap, today's spend, top-spending models, and per-project hotspots round out the view, replacing a stack of usage commands with a single live dashboard.
	🕘 Cross-Agent Session History kmux indexes local session records for all four agents — Claude (~/.claude/projects), Codex (~/.codex/sessions), Gemini (~/.gemini/tmp), and Antigravity (~/.gemini/antigravity-cli) — and surfaces them in one filterable panel. Click any row to resume that session. kmux focuses an existing surface for the same cwd if one is open, or spins up a fresh workspace and runs claude --resume, codex resume, gemini --resume, or agy --conversation for you.
🌳 Worktree Workspaces Right-click any workspace → Convert to Worktree Workspace to lock it onto a fresh git worktree. Now two agents can edit the same repo on different branches without fighting over the working tree. kmux tracks the worktree lifecycle — branch name, dirty state, and removal, including a confirmation prompt before deleting a worktree with uncommitted changes — so the working copy never gets orphaned.

Everything else you'd expect from a serious terminal

• Split panes & surface tabs — group server, logs, and agent shells in one pane
• Smart sidebar — auto-detected cwd, git branch, active ports, and unread badges per workspace
• Workspace persistence — full layout restore on app launch
• Command palette (⌘ ⇧ P), terminal search (⌘ F), vim-style copy mode
• Native macOS look — proper title-bar integration, dark palette, retina-tuned rendering

📦 Install

1. Click the button that matches your Mac (M1/M2/M3/M4 → Apple Silicon, older Intel Macs → Intel)
2. Open the downloaded .dmg and drag kmux into your Applications folder
3. On first launch, macOS may ask you to confirm — click Open

🏁 Quick Start

1. Launch kmux and press ⌘ N to create a workspace
2. Inside it, run your agent — claude, codex, gemini, or agy
3. Toggle the sidebar with ⌘ B to see the Usage and Sessions panels
4. Press ⌘ N again to park another agent in its own workspace — or right-click a workspace → Convert to Worktree Workspace if both should touch the same repo
5. When an agent needs input or finishes, a native macOS notification fires and the workspace picks up an attention badge

⌨️ Keyboard Shortcuts

Every shortcut here is also reachable from the command palette (⌘ ⇧ P).

Workspaces

Panes

Surface Tabs

Terminal & Utilities

📚 Resources