abmux

AI Board on tmux — A TUI for managing multiple Claude Code sessions from a single terminal screen.

Monitor, create, switch between, and delete Claude Code sessions running on tmux, all in one place.

Requirements

• Node.js >= 24
• tmux

Install

npm install -g abmux
# or
yarn global add abmux
# or
pnpm add -g abmux
# or
bun add -g abmux

Getting Started

abmux

Run without arguments to launch the TUI.

CLI commands are also available for scripting:

abmux new <prompt> [--dir <path>]  # Create a session
abmux open [session]               # Attach to a session
abmux kill [session]               # Kill a session
abmux list                         # List sessions

Screen Layout

The main screen is split into three panels:

+-----------------------+---------------------------------------+
| abmux - v0.0.x                                                |
+-----------------------+---------------------------------------+
|                       |                                       |
| Session List          | Pane List                             |
| (Left Panel)          | (Right Panel)                         |
|                       |                                       |
| > my-project (cwd)    |   * [thinking] Refactoring...  %5     |
|   other-project       |   * [running]  Fixing tests    %8     |
|                       |   o [idle]     Waiting         %12    |
|                       |   * vim                        %3     |
|                       |                                       |
+-----------------------+---------------------------------------+
|                                                               |
| Session Overview (Bottom Panel)                               |
| Summaries of what Claude is working on in each session        |
|                                                               |
+---------------------------------------------------------------+
| [keys] move / select / Tab / n / d / q       * 2 thinking     |
+---------------------------------------------------------------+

Press Tab to cycle focus: Left → Right → Bottom. The focused panel is highlighted with a green border.

Panels

Left Panel: Session List

Lists tmux sessions grouped by project directory. The session matching your current directory is marked with (cwd).

Key	Action
↑ / ↓	Move cursor
Enter / →	Select session, move to right panel
n	Add session via directory search
d	Delete session
q	Quit

Right Panel: Pane List

Shows all panes in the selected session. Claude Code panes display their status; other panes (editors, shells) are also listed.

Key	Action
↑ / ↓	Move cursor
Enter	Attach to pane (switch to tmux)
n	Create a new Claude session
v	Open session in $EDITOR
d	Kill pane
Esc / ←	Back to left panel

Bottom Panel: Session Overview

Displays AI-generated summaries of what Claude is doing in each session. Auto-refreshes every 60 seconds.

Key	Action
↑ / ↓	Scroll
Tab	Next panel
Esc / ←	Back to left panel

Status Icons

The right panel and the status bar show Claude session states with these icons:

Icon	Status	Meaning
⠋ (braille)	thinking	Claude is reasoning
✳	running	Executing a tool
❓	confirm	Waiting for user approval
❯	waiting	Ready for input
○	idle	Idle

Non-Claude panes show ● (busy) or ○ (available).

Development

pnpm install
pnpm start        # Run in dev mode
pnpm test         # Run tests
pnpm typecheck    # Type check
pnpm lint:check   # Lint
pnpm format:check # Format check
pnpm build        # Bundle

License

MIT