convez.ai
AgenteDevOps & InfraestruturaIntermediário
kkd927

kmux — Multiplexador de Terminal para Agentes de IA

kkd927/kmux

Execute múltiplos agentes IA em paralelo com controle centralizado

Ver no GitHub
BomPluginScore · de 0 a 100

Um 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/kmux

1 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

Estrelas
26
Forks
2
Acompanhando
0
Saúde
100%
Último commit
há 2 semanas
Versão
v1.1.3
Issues abertas
15
Contribuidores
4

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.

CI Release macOS PRs Welcome

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

ShortcutAction
⌘ NNew workspace
⌘ ]Next workspace
⌘ [Previous workspace
⌘ 1–9Switch to workspace by number
⌘ ⇧ RRename workspace
⌘ ⇧ WClose workspace
⌘ BToggle sidebar

Panes

ShortcutAction
⌘ DSplit right (vertical)
⌘ ⇧ DSplit down (horizontal)
⌥ ⌘ ← → ↑ ↓Focus pane directionally
⌥ ⇧ ⌘ ← → ↑ ↓Resize pane
⌥ ⌘ KClose pane

Surface Tabs

ShortcutAction
⌘ TNew surface tab
⌃ TabNext surface
⌃ ⇧ TabPrevious surface
⌃ 1–9Switch to surface by number
⌘ WClose surface
⌃ ⌘ WClose other surfaces

Terminal & Utilities

ShortcutAction
⌘ ⇧ PCommand palette
⌘ FSearch in terminal
⌘ G / ⌘ ⇧ GFind next / previous
⌘ C / ⌘ VCopy / paste
⌘ ⇧ MVim-style copy mode
⌘ IToggle notifications
⌘ ⇧ UToggle usage dashboard
⌘ ,Open settings

📚 Resources

📖 Product Specdocs/product-spec.md — full feature spec, including automation socket & CLI
🏗️ Architecture ADRdocs/adr/0002-electron-xterm-mvp-architecture.md
🛠️ Development Guidedocs/development.md — build from source, dev loop, debugging
🤝 ContributingCONTRIBUTING.md
📜 Code of ConductCODE_OF_CONDUCT.md
🔒 Security PolicySECURITY.md

kmux — your AI coding agents, side-by-side.

macOS only · Pre-release · Actively developed

Ver o original no GitHub

Bom para

Relacionados