Tmux Agent Indicator

tmux-agent-indicator

[](https://github.com/accessd/tmux-agent-indicator/actions/workflows/ci.yml)

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 and Codex fire hooks on prompt submit, permission request, and stop. OpenCode uses its plugin system. Any other agent can call `agent-state.sh` directly from a wrapper script or hook.

Each state can change:

• Pane border color
• Pane background (supported but disabled by default to avoid visual noise)
• Window title background and foreground
• Status bar icon (per-agent, e.g. claude=🤖, codex=🧠)

States reset when you focus the pane/window, or on the next transition.

Features

• Per-agent status icons in the status bar
• Knight Rider animation during running state
• Deferred pane reset: keep pane colors until focus, not when the hook fires
• Process detection fallback for agents that don't fire hooks
• Tmux display-message notifications on state transitions

Requirements

tmux 3.1+, bash 4+, Python 3

Installation

One-command installer (recommended)

curl -fsSL https://raw.githubusercontent.com/accessd