wtf is agents.tmux?

agents.tmux is a macOS menu bar app that watches tmux sessions and shows you, at a glance, whether the AI coding agents running inside them need your attention. If you run several agents like Claude Code, GitHub Copilot, Cursor, or Codex in parallel across different tmux panes, this app puts a single small badge in the menu bar summarizing their state instead of you having to alt tab between terminal windows to check. The badge uses a simple color code: green means agents are busy and you are free to do something else, yellow means at least one agent is waiting for input while others are still running, and red means every agent is waiting on you and needs action now. Clicking the badge shows a per agent status line and, if you use iTerm2, lets you jump straight to that agent's tmux window. Detection mostly relies on CPU usage: if an agent's process is using enough CPU it is considered busy, avoiding the need to parse terminal text for most cases. It also checks the last few lines of each pane's output for signs that an agent is waiting for input. These thresholds and settings live in a configuration file you can adjust, for example raising the CPU threshold if brief focus events cause false positives. Agents running outside tmux in their own terminal window are still detected through the operating system's process list and marked as external. To install it, you clone the repository and run a setup script that installs dependencies and starts the app, you can also run a Python script directly to check detection without opening the graphical interface. It requires macOS, tmux, and Python 3.11 or later, and is intended for developers who juggle multiple AI coding agents at once.