GitHub Repository

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.

62 starsShell

Visual state tracking for AI agents in tmux

Name: Visual state tracking for AI agents in tmux
Availability: InStock
Author: accessd

by accessd·Feb 15, 2026·1 point·0 comments

Visit Project View on HN

AI Analysis

●●SolidNiche GemSolve My Problem

The Take

If you run multiple LLM sessions in tmux, this stops the annoying habit of constantly switching panes by surfacing state through pane borders, window-title colors and status-bar icons. It hooks into Claude Code and Codex lifecycle events (or accepts calls to agent-state.sh), offers a one-command installer, a Knight Rider running animation, and a process-detection fallback — small, clever tmux trickery that actually improves day-to-day ergonomics for its niche.

Post Description

I run multiple Claude Code and Codex sessions in tmux panes. The main annoyance was not knowing when an agent finished or hit a permission prompt without switching to each pane to check.

This plugin hooks into agent lifecycle events and changes pane borders, window titles, and status bar icons to reflect three states: running, needs-input, done. Colors reset when you focus the pane.

Works with Claude Code and Codex out of the box. Any other agent can integrate by calling a single shell script.