how it works
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.
Claude Code, Codex, Hermes, Oh My Pi, OpenCode, and Pi. Adding an agent is one small config file — no code.
A single daemon on one persistent tmux control-mode connection. Prebuilt, verified binaries download automatically; Linux builds are statically linked.
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
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 →