accessd/tmux-agent-indicator

84 stars · Last commit 2026-07-26

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

[![CI](https://github.com/accessd/tmux-agent-indicator/actions/workflows/ci.yml/badge.svg)](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](docs/images/needs-input.png) | ![done](docs/images/done.png) | ![done-pane-bg](docs/images/done-pane-bg.png) |
|:---:|:---:|:---:|
| 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`.

View full repository on GitHub →