i was running multiple agents across multiple tmux sessions and had no idea which one needed my attention.

cmux, superset, etc are cool ideas, but i wanted to retain the rest of my terminal setup.

i just wanted to know when my agents finish, fail, or need me. within tmux.

so i built a tmux sidebar. it runs inside your actual terminal on any OS and does not require any background database or external packages.

claude code and codex status via lifecycle hooks (codex just shipped hooks today: https://developers.openai.com/codex/hooks)

'ping' when agent is ready

experimental pgrep-based detection for agents that haven't built in hooks yet

deploy parallel agents across sessions with isolated git worktrees

git branch + working directory context

vim navigation

prefix + o and the sidebar appears as a tmux pane. that's it.

https://github.com/samleeney/tmux-agent-status

full disclosure. i actually built the first version of this about 8 months ago. it had some use, picked up 11 forks. then in the last month i saw 10+ similar tools posted on reddit solving the same problem. took the best ideas from the forks and from what others were building, and put out a new update.

shoutout to the ecosystem growing around this. if mine isn't your style, there are plenty of other approaches now:

claude-squad: https://github.com/smtg-ai/claude-squad
cmux: https://github.com/craigsc/cmux
dmux: https://github.com/standardagents/dmux
opensessions: https://github.com/ataraxy-labs/opensessions
agtx: https://github.com/fynnfluegge/agtx
ntm: https://github.com/Dicklesworthstone/ntm

i just wanted to know when my agents finish, fail, or need me within tmux