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:

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

Build from source

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

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.

Status indicators:
- ● — Working: Claude is actively processing
- ○ — Idle: Ready for input
- ◐ — Waiting for input: Permission prompt ([y/n])
- ? — Unknown: Not a Claude Code session or status unclear

Keybindings

Navigation

Actions

Other

Status Detection

claude-tmux detects Claude Code status by analyzing pane content:

Session Model

claude-tmux identifies sessions containing…