Tmux Claude Code — Development skill for Claude Code

tmux-claude-code

Manage [Claude Code](https://docs.anthropic.com/en/docs/claude-code) sessions in tmux. Search past conversations by keyword, resume them in the right directory, and browse sessions interactively.

Features

• prefix-c — New Claude Code pane (or prefix-C for a named one)
• prefix-C-r — Resume a session by keyword (searches transcript content)
• prefix-C-b — Browse all sessions with fzf preview
• cc list — List recent sessions with status (active/inactive)
• cc detect — Show which panes are running Claude Code
• Status bar — Active CC session count in your tmux status line

Session search

The killer feature: search across all your Claude Code session transcripts by keyword. It checks the first few user messages of every session, excludes currently active ones, resolves the correct working directory, and opens a new pane with `claude --resume`.

cc resume nextladder proposal    # finds and resumes the matching session
cc resume fix ctc phaseout       # keyword search across all transcripts

Smart pane detection

Correctly identifies Claude Code in tmux panes even when `pane_current_command` reports `zsh` (common when CC is launched via `zsh -c "claude ...; exec zsh"`). Uses a three-tier approach:

1. Check pane_current_command
2. Check child processes via pgrep
3. Content-based fallback (CC prompt markers)

Install

With [TPM](https://github.com/tmux-plugins/tpm) (recommended)

Add to `~/.tmux.conf`:

set -g @plugin 'MaxGhenis/tmux-claude-code'

Then press `prefix-I` to install.

Manual

git clone https://github.com/MaxGhenis/tmux-claude-code ~/.tmux/plugins/tmux-claude-code

Add to `~/.tmux.conf`:

run-shell ~/.tmux/plugins/tmux-claude-code/claude-code.tmux

CLI wrapper (optional)

For shell access to `cc` commands:

ln -sf ~/.tmux/plugins/tmux-claude-code/cc ~/bin/cc

Configuration

All options have sensible defaults. Add t