Show HN: Kmux – Parallel terminal workspace optimized for AI coding agents

Kmux, a new keyboard-centric terminal emulator for macOS and Linux, launches to provide parallel terminal workspaces optimized for AI coding agents like Claude Code, Codex CLI, and Antigravity CLI. The tool offers isolated sessions, git worktree integration, and a unified usage dashboard to manage multiple agent workflows without clutter or conflicts.

The multi-session terminal workspace for running AI coding agents side-by-side. A keyboard-centric terminal emulator designed for Claude Code, Codex CLI, and Antigravity CLI on macOS and Linux. Keep track of parallel agent sessions, monitor API usage, and work safely on separate branches via native git worktrees. English | 日本語 /kkd927/kmux/blob/main/README.ja.md | 简体中文 /kkd927/kmux/blob/main/README.zh-CN.md | 한국어 /kkd927/kmux/blob/main/README.ko.md | Español /kkd927/kmux/blob/main/README.es.md Running CLI-based AI agents like Claude Code , Codex CLI , or Antigravity CLI alongside your development server quickly leads to terminal clutter, fragmented session history, and git conflicts when agents write to the same working directory. kmux solves this by providing a dedicated terminal workspace built for agent workflows: Isolated Parallel Sessions : Run multiple agents simultaneously in split panes or vertical tabs without environment conflicts. Attention Notifications : Get native desktop notifications and workspace badges immediately when an agent completes a task or requires human input. Unified Usage Dashboard : Monitor API spend, token heatmaps, and session budgets across all agent providers in a single sidebar. Instant Session Resume : Browse your indexing history and resume past agent sessions in one click. Worktree Workspaces : Spin up isolated git worktree environments automatically, allowing multiple agents to safely modify different branches of the same repository. Split Panes & Tabs — Group build servers, logs, and agent shells within a single workspace. Smart Sidebar — Automatically detects your active working directory cwd , git branch, listening ports, and unread status. Layout Persistence — Instantly restores your exact workspace layouts, active tabs, and directories when you relaunch the app. Vim Copy Mode & Search — Search terminal buffers ⌘ F and use Vim-like keybindings to select and copy text without touching the mouse. Command Palette — Access all actions and custom workspace commands quickly with ⌘ ⇧ P . - Click the button that matches your Mac M1/M2/M3/M4 → Apple Silicon, older Intel Macs → Intel - Open the downloaded .dmg and drag kmux into your Applications folder - On first launch, macOS may ask you to confirm — click Open - Choose the AppImage for your Linux CPU x64 → Intel/AMD 64-bit, ARM64 → ARM 64-bit - Make it executable: chmod +x kmux-linux-x64.AppImage or chmod +x kmux-linux-arm64.AppImage - Run the matching file: ./kmux-linux-x64.AppImage or ./kmux-linux-arm64.AppImage - Launch kmux and create a workspace ⌘ N on macOS . - Inside the terminal, run your local agent CLI — claude , codex , or agy .💡 Note : kmux runs the agent CLIs already installed on your system. It does not require you to configure any API keys or wrappers. - Toggle the sidebar ⌘ B on macOS to see the Usage and Sessions panels. - Create another workspace to run another agent — or right-click a workspace → Convert to Worktree Workspace if both need to touch the same repo. - When an agent needs input or finishes, a native desktop notification fires and the workspace picks up an attention badge. Shortcuts below show the macOS defaults. Linux uses platform-specific text shortcuts, and every action is also reachable from the command palette. | 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 | | Shortcut | Action | |---|---| ⌘ D | Split right vertical | ⌘ ⇧ D | Split down horizontal | ⌥ ⌘ ← → ↑ ↓ | Focus pane directionally | ⌥ ⇧ ⌘ ← → ↑ ↓ | Resize pane | ⌥ ⌘ K | Close pane | | 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 | | 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 | 📖 Product Spec | | Architecture ADR docs/adr/0002-electron-xterm-mvp-architecture.md /kkd927/kmux/blob/main/docs/adr/0002-electron-xterm-mvp-architecture.md Development Guide docs/development.md /kkd927/kmux/blob/main/docs/development.md — build from source, dev loop, debugging Contributing CONTRIBUTING.md /kkd927/kmux/blob/main/CONTRIBUTING.md Code of Conduct CODE OF CONDUCT.md /kkd927/kmux/blob/main/CODE OF CONDUCT.md Security Policy SECURITY.md /kkd927/kmux/blob/main/SECURITY.md kmux — your AI coding agents, side-by-side. macOS + Linux · Pre-release · Actively developed