kmux — Multiplexador de Terminal para Agentes de IA
kkd927/kmux
Execute múltiplos agentes IA em paralelo com controle centralizado
Ver no GitHubUm workspace macOS que orquestra e monitora múltiplos agentes de codificação IA (Claude Code, Codex CLI, Gemini CLI, Antigravity CLI) em paralelo, sem conflitos. Oferece histórico unificado de sessões, dashboard de uso integrado, notificações nativas e suporte a git worktrees para edição segura em branches distintos.
Instalação
npx convez-ai kkd927/kmux1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Orquestração de múltiplos agentes de codificação em um único projeto
- Monitoramento integrado de uso e quotas de diferentes provedores IA
- Retomada rápida de sessões anteriores com histórico unificado
- Desenvolvimento paralelo seguro usando git worktrees com diferentes agentes
Veredito

kmux resolve um problema real para desenvolvedores que trabalham com múltiplos agentes IA: fragmentação de sessões, uso oculto e falta de coordenação. A implementação é sólida (TypeScript, notificações nativas macOS, indexação de histórico), mas escopo restrito a macOS limita seu alcance no ecossistema.
README
A tradução para o português deste README ainda está na fila.
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 worktreeso 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
- Click the button that matches your Mac (M1/M2/M3/M4 → Apple Silicon, older Intel Macs → Intel)
- Open the downloaded
.dmgand drag kmux into yourApplicationsfolder - On first launch, macOS may ask you to confirm — click Open
🏁 Quick Start
- Launch kmux and press
⌘ Nto create a workspace - Inside it, run your agent —
claude,codex,gemini, oragy - Toggle the sidebar with
⌘ Bto see the Usage and Sessions panels - Press
⌘ Nagain to park another agent in its own workspace — or right-click a workspace → Convert to Worktree Workspace if both should touch the same repo - 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
| Shortcut | Action |
|---|---|
⌘ N | New workspace |
⌘ ] | Next workspace |
⌘ [ | Previous workspace |
⌘ 1–9 | Switch to workspace by number |
⌘ ⇧ R | Rename workspace |
⌘ ⇧ W | Close workspace |
⌘ B | Toggle sidebar |
Panes
| Shortcut | Action |
|---|---|
⌘ D | Split right (vertical) |
⌘ ⇧ D | Split down (horizontal) |
⌥ ⌘ ← → ↑ ↓ | Focus pane directionally |
⌥ ⇧ ⌘ ← → ↑ ↓ | Resize pane |
⌥ ⌘ K | Close pane |
Surface Tabs
| Shortcut | Action |
|---|---|
⌘ T | New surface tab |
⌃ Tab | Next surface |
⌃ ⇧ Tab | Previous surface |
⌃ 1–9 | Switch to surface by number |
⌘ W | Close surface |
⌃ ⌘ W | Close other surfaces |
Terminal & Utilities
| Shortcut | Action |
|---|---|
⌘ ⇧ P | Command palette |
⌘ F | Search in terminal |
⌘ G / ⌘ ⇧ G | Find next / previous |
⌘ C / ⌘ V | Copy / paste |
⌘ ⇧ M | Vim-style copy mode |
⌘ I | Toggle notifications |
⌘ ⇧ U | Toggle usage dashboard |
⌘ , | Open settings |
📚 Resources
| 📖 Product Spec | docs/product-spec.md — full feature spec, including automation socket & CLI |
| 🏗️ Architecture ADR | docs/adr/0002-electron-xterm-mvp-architecture.md |
| 🛠️ Development Guide | docs/development.md — build from source, dev loop, debugging |
| 🤝 Contributing | CONTRIBUTING.md |
| 📜 Code of Conduct | CODE_OF_CONDUCT.md |
| 🔒 Security Policy | SECURITY.md |
kmux — your AI coding agents, side-by-side.
macOS only · Pre-release · Actively developed