agenmux: monitor every AI coding agent in tmux.
Who's blocked, who's working, who's done — without switching panes.

Previously named tmux-agents-mon.

agenmux on github · v0.2.1 · MIT
tmux
⧉ webapp vim 1 agents 2 nu 3 15:56
⤳ 2 ✳ claude

every agent's state at a glance — vim motions (or arrows) to the blocked one, answer, done

how it works

no hooks

Detection is scraping-only: agents are identified by walking each pane's process tree, state inferred from the visible screen and title. Nothing runs inside your agents.

six agents built in

Claude Code, Codex, Hermes, Oh My Pi, OpenCode, and Pi. Adding an agent is one small config file — no code.

rust engine

A single daemon on one persistent tmux control-mode connection. Prebuilt, verified binaries download automatically; Linux builds are statically linked.

native notifications

macOS notifications via a signed Agenmux.app — click one and your terminal jumps to the exact pane. notify-send on Linux.

install

With TPM:

set -g @plugin 'snirt/agenmux'

Press prefix + I. That's it: the plugin downloads and verifies the Rust engine for your platform in the background.

Or manually:

git clone https://github.com/snirt/agenmux ~/.tmux/plugins/agenmux
echo "run-shell ~/.tmux/plugins/agenmux/agenmux.tmux" >> ~/.tmux.conf

Requirements: tmux and bash. curl and tar enable the automatic native download; without them, Cargo builds the engine when available. Release tarballs with SHA256SUMS are on the latest release.

use it

prefix + Atoggle sidebar
j/k /move
Enterjump to agent
/live search
fstate filter
uversion picker
?help
click / wheeljump / scroll (mouse)

Add #{agenmux} anywhere in your status line for the compact summary — e.g. ⣿1 ⣾2 ⣿1 for blocked/working/idle:

set -g status-right '#{agenmux} | %H:%M'

latest release

v0.2.1 all releases →