claude-tmux

claude-tmux

A terminal user interface for managing multiple Claude Code sessions within tmux. claude-tmux provides a centralized view of all your Claude Code instances, enabling quick switching, status monitoring, and session lifecycle management, including git worktree and pull request support.

Installation

Cargo install

Just run:

cargo install claude-tmux

Add the following line to your `~/.tmux.conf`:

bind-key C-c display-popup -E -w 80 -h 30 "~/.cargo/bin/claude-tmux"

Build from source

git clone https://github.com/nielsgroen/claude-tmux.git
cd claude-tmux
cargo build --release

Add this to your `~/.tmux.conf` to bind claude-tmux to a key:

bind-key C-c display-popup -E -w 80 -h 30 "/path/to/claude-tmux"

How to use

Reload your tmux configuration. Press `Ctrl-b, Ctrl-c` to open claude-tmux from any tmux session.

To use pull requests, make sure you have `gh` installed.

Tmux options

Options:

• -E — Close popup when claude-tmux exits
• -w 80 -h 30 — Popup dimensions (adjust to preference)

Features

• Session Overview — See all tmux sessions at a glance with Claude Code status indicators
• Status Detection — Know whether each Claude Code instance is idle, working, or waiting for input
• Quick Switching — Jump to any session with minimal keystrokes
• Live Preview — See the last lines of the selected session's Claude Code pane with full ANSI color support
• Session Management — Create, kill, and rename sessions without leaving the TUI
• Expandable Details — View metadata like window count, pane commands, uptime, and attachment status
• Fuzzy Filtering — Quickly filter sessions by name or path

Screenshots

View the screenshots at [GitHub](https://github.com/nielsgroen/claude-tmux).

**Status indicators:**

• ● — Working: Claude is actively processing
• ○ — Idle: Ready for input
• ◐ — Waiting for input: Permission prompt ([y/n])

...