codermungan/tmux-claude-code

tmux-claude-code is a bash-only tmux plugin for browsing, tracking, and resuming Claude Code sessions from inside tmux. It combines two sources of information: tmux panes that currently have Claude Code running in them, and the local session transcripts that Claude Code stores on disk under the projects folder in your home directory. That gives you a single browser covering sessions already open in a pane, sessions you touched recently, and older sessions that have gone idle. Opening the popup with a keyboard shortcut, prefix plus C by default, shows a list of sessions with a colored status dot, the session title, its project directory, and its git branch. Green means the session already has a live tmux pane open, yellow means it was touched recently, and gray means it has gone idle. If fzf is installed, the popup supports fuzzy searching, and if not, it falls back to a plain numbered menu. Selecting a session either jumps straight to the pane that already has it open, or runs claude with the resume flag in a new tmux window or split pane if it is not currently open anywhere. The plugin also offers an optional status line segment you can add to your existing tmux status bar, showing counts of total, active, recent, and idle sessions. Behind the scenes, it reads each Claude Code session's stored JSONL transcript to get its working directory, git branch, last activity time, and a title pulled from the session summary or first user prompt, using jq for that when it is available and falling back gracefully when it is not. Installing it works either through the Tmux Plugin Manager or by cloning the repository manually into your tmux plugins folder and pointing tmux at its entry script. Requirements are tmux 3.2 or newer, bash, and the claude CLI on your path, with jq and fzf as optional extras for richer titles and fuzzy search. The plugin only reads local tmux and Claude Code metadata and does not send any data anywhere. It is licensed under MIT.