Updates tmux window title with Claude Code status indicators showing current activity (working, editing files, running commands, etc.)

version
1.42.0
GitHub stars
20

Install

/plugin install tmux-titles@motlin-claude-code-plugins

Run it inside Claude Code after adding the marketplace with /plugin marketplace add motlin/claude-code-plugins.

Contents

Discovered from source

Agents 1

tmux-titles

Hooks that store an agent activity symbol in the tmux window option @claude_indicator (○ ready, ✻ working, $ shell, ✎ edit, … read, ? needs input, ⌫ compacting, ✓ stopped), plus /rename <name> to rename the agent's tmux window. Claude Code clears the option on session end. No-op outside tmux. Requires jq.

Setup

The plugin does not edit tmux.conf. Render the option in a status format, for example:

set -g window-status-format '#I:#F #{?@claude_indicator,#{@claude_indicator} ,}#W '
set -g window-status-current-format '#[bold]#I:#F #{?@claude_indicator,#{@claude_indicator} ,}#W#[default] '

Set automatic-rename off if /rename names should stick. Clear a stale symbol with tmux set-option -wqu @claude_indicator.

Sponsors

Details

Marketplace
motlin/claude-code-plugins
Source
plugins/tmux-titles
Author
Craig Motlin
Category
Productivity

More from motlin/claude-code-plugins

All 30