Show Claude Code session headlines in tmux window tabs and pane borders. Auto-detects the tmux pane, writes a short task summary after each response, and pushes it to tmux. Requires the tmux-headline Claude Code plugin for hook support.
Shows a 3-6 word summary of what Claude is working on in your tmux window tab and pane border. Updates automatically after each response. For Codex, use tmux pane titles plus ~/.codex/config.toml segment ordering rather than Claude hooks.
~/.claude/headline/headlines/{session_id}.headline@headline and @pane_headline tmux optionsFor Codex, there are no equivalent headline hooks here. The practical integration is:
terminal_titlepane_title for Codex panes~/.codex/config.toml# Add the marketplace
claude plugin marketplace add ofan/agent-plugins
# Install the plugin
claude plugin install tmux-headline@ofan-plugins
Then add to your ~/.tmux.conf:
# Show headline in window tabs (with spinner)
set -g window-status-format " #I #{?#{@headline},#[fg=colour244]#{=18:@headline},#W} "
set -g window-status-current-format "#[fg=colour15,bg=colour239,bold] #I #{?#{@headline},#{=18:@headline},#W} #[default]"
set -g status-interval 1