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

> Source: <https://github.com/kkd927/kmux>
> Published: 2026-07-14 13:34:00+00:00

**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