Auto-discovered marketplace from haxybaxy/claude-tmux-status
npx claudepluginhub haxybaxy/claude-tmux-statusShow Claude Code session state as an emoji in your tmux window name
A Claude Code plugin that shows session state as emoji icons in your tmux window name.
zsh — no session
zsh [🧑🍳] — thinking / tool use
zsh [👀] — needs attention (permission request / notification)
zsh [😴] — idle
From inside Claude Code, run:
/plugin marketplace add https://github.com/haxybaxy/claude-tmux-status.git
Then install the plugin:
/plugin install tmux-status
Finally, activate it:
/reload-plugins
Clone into your Claude Code plugins directory:
git clone https://github.com/haxybaxy/claude-tmux-status \
~/.claude/plugins/claude-tmux-status
Claude Code picks up the plugin automatically on next launch.
The plugin registers hooks for Claude Code lifecycle events. Each event runs a small bash script that appends or removes an icon suffix on the current tmux window name.
| Event | Icon | State |
|---|---|---|
SessionStart | 😴 | Idle |
UserPromptSubmit | 🧑🍳 | Processing |
PreToolUse | 🧑🍳 | Processing |
PostToolUse | 🧑🍳 | Processing |
Stop | 😴 | Idle |
PermissionRequest | 👀 | Needs attention |
Notification | 👀 | Needs attention |
SessionEnd | (removed) | Cleans up and re-enables automatic-rename |
Use the built-in skill from inside Claude Code:
/tmux-icons # list available themes
/tmux-icons emoji # switch to emoji (default)
/tmux-icons nerd-font # switch to Nerd Font icons
/tmux-icons minimal # switch to plain text indicators
Changes take effect immediately on the next lifecycle event — no restart needed.
/tmux-icons set attention !!
/tmux-icons create my-theme
| Theme | Idle | Processing | Attention | Notes |
|---|---|---|---|---|
emoji | 😴 | 🧑🍳 | 👀 | Default, works everywhere |
nerd-font | | | | Requires a patched font |
minimal | zzz | ... | (!) | Plain text, no font needed |
The active icon set is stored in config/active.conf as simple key=value pairs:
idle=😴
processing=🧑🍳
attention=👀
Theme presets live in config/themes/*.json.
MIT