accessd/tmux-agent-indicator
61 stars · Last commit 2026-03-10
Tmux plugin that gives visual feedback for AI agent states (running/needs-input/done). Supports Claude Code, Codex, and custom agents. Pane borders, window title colors, status bar icons.
README preview
# tmux-agent-indicator AI agents run in tmux panes but give no signal when they finish or need input. You have to keep switching panes to check. This plugin tracks agent state and surfaces it through pane borders, window titles, and status bar icons so you never miss a transition. ## Demo https://github.com/user-attachments/assets/b6b6b466-4b42-4d45-85aa-b9b659e4bafe When the agent finishes, the window title background/foreground changes and the pane border updates to signal completion. |  |  |  | |:---:|:---:|:---:| | needs-input: yellow window title | done: red window title | done: pane background change | ## How it works The plugin tracks three states per pane: `running`, `needs-input`, and `done`. State transitions are driven by hooks. Claude Code fires hooks on prompt submit, permission request, and stop. Codex uses its `notify` command. OpenCode uses its plugin system. Any other agent can call `agent-state.sh` directly from a wrapper script or hook.