See which tmux AI agent is waiting on you, and jump straight there
A tmux plugin that reads the state of 22 coding agents across your panes and shows blocked, working, done or idle in one tree.
- LinkLoot access
- Free
- Provider costs
- Unknown
What you get from it
What it does
tmux-agent-wizard (taw) puts a state dashboard inside the tmux you already run. It watches every pane with herdr's detection engine and labels each agent as blocked, working, done or idle. Press prefix + A for one tree of sessions, panes and worktrees; Tab hops to the next agent that needs attention, Enter lands you in its session. If an agent blocks or finishes while you're elsewhere, a toast names it and prefix + O jumps there.
It also folds in two familiar jobs: project-to-session picking from tmux-session-wizard, and save/restore of sessions, layouts and folders so agents come back into their conversations after a reboot. Your existing tmux.conf, keys, plugins and status line stay untouched. There is no central daemon — just a small watcher per pane, about 9 MB each — and no account.
Who it helps
Developers who juggle several AI coding agents at once: Claude Code in one window, Codex in another, OpenCode in a worktree. The pain it targets is real — one agent stuck on a permission prompt for twenty minutes while you flick through windows to notice. taw surfaces exactly which pane is waiting, including over ssh via terminal notifications or system toasts on macOS and Linux.
Getting started
Requirements: tmux 3.2 or newer on macOS or Linux, plus TPM. Add set -g @plugin '27medkamal/tmux-agent-wizard' to ~/.tmux.conf, press prefix + I, and TPM installs it. On first load taw downloads its binary from GitHub releases, checked against the release's SHA-256 checksum. Then prefix + A lists the agents already running.
Optional extras: run taw integration install claude (or codex, opencode, cursor) once per agent so restore returns it to the same conversation; symlink taw into ~/.local/bin if you want it outside tmux. Without TPM, from source, or with the download disabled, see the project's install page.
Limits and costs
The detection list covers 22 agents via herdr's rules, so unusual or brand-new tools may not be recognized until the engine updates. Restore requires per-agent integration setup. Each pane runs a ~9 MB watcher, which adds up on wide setups. The project is MIT-licensed and free; pricing beyond that is not stated. No security audit or human review is claimed by the documentation — the checksum verification is the only integrity step described.
Source links
Discussion
Share practical experience, questions, or warnings with the community.
Sign in to join the discussion and vote on comments.
Sign in