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

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 | 日本語 | 简体中文 | 한국어 | Español 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 isolatedgit 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 dragkmux into yourApplications

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

, oragy

.💡

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 theUsage andSessions 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.

📖 Product Spec | |

Architecture ADRdocs/adr/0002-electron-xterm-mvp-architecture.mdDevelopment Guidedocs/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 + Linux · Pre-release · Actively developed