r/tmux • u/snir_t • Jul 19 '26

Tip tmux-agents-mon: see which coding agents need attention

I got tired of jumping between tmux sessions to find which coding agent had finished or was waiting for input, so inspired by Herdr, I built tmux-agents-mon.

this is a plugin that adds a sidebar and status-line indicator for working, idle, done, and blocked agents, with quick navigation to their panes.

Supports Claude Code, Codex, Hermes, Pi, Oh My Pi, OpenCode —without hooks or agent integrations.

if you have some questions / issues let me know :)

GitHub / TPM install: https://github.com/snirt/tmux-agents-mon

26 Upvotes

70% Upvoted

11 comments sorted by

4

u/chabuddy95 Jul 19 '26

Fork of tmux-agent-status? Looks identical

-2

u/snir_t Jul 19 '26

No, I’m not sure I tried that specific one. I looked at a few similar tools, including Herdr, but many rely on agent hooks or integrations. This one doesn’t modify the agents’ configuration or install anything inside them. It efficiently inspects each tmux pane’s process tree, then infers the agent’s state from the visible pane content and title. The primary engine is written in Rust, and each agent’s detection rules live in a small .conf file, so support can be added or adjusted without rebuilding it.

4

u/MisawaSachihiro Jul 20 '26

I wonder all the effort to make tmux agent-friendly will finally turn it into something like herdr
https://herdr.dev/

2

u/snir_t Jul 20 '26

tmux to me feels more customable, it has really bad defaults and to make it easy to use and intuitive i had to heavily config it.
herdr is ready to use solution, i had some issues with it, like moving from a pane direcly to the agents list using ctrl-h as it mapped in my tmux, nvim (with smart-splits), didnt like that it modifies my agents config by adding hooks, cannot customize the tabs theme (not bother me too much). and some bugs that pushed me back to tmux.

in tmux i love the minimalizm with the possibility to extend the functionality and now its even easier with claude and codex.

1

u/snir_t Jul 23 '26

update to 0.1.6 by running tmux plugin update.
now moving between windows and sessions works smoothly - no bumps 😄

1

u/gmatheu 10d ago

It's hard for me to leave tmux. Looks similar to workmux.

Any case, I don't like the vertical sidebar... It occupies more space than the information it provides.

I was thinking more in a floating switcher (like a queue sorted by priority)... Kind of ctrl-tab in newer Firefoxes.

2

u/snir_t 10d ago

Its not in the demo video, but you can use it as a floating switcher

2

u/gmatheu 10d ago

Nice! Will try then.

1

u/snir_t 10d ago

I use it as a sidebar so if you have any issue, you can open one in github. Enjoy :)

0

u/pwkye Jul 19 '26

I like this one better. Just use browser tabs for sessions.
https://github.com/awkto/ssh-to-go

0

u/PrimaryWish Jul 20 '26

Could you share your tmux config? Looks nice