What is TAW?
TAW is a tmux plugin for people who run AI coding agents in terminal panes and want to monitor them without leaving their existing setup. It detects the state of 22 agents, brings their sessions and panes into one navigable tree, and lets you jump to the agent that needs attention. It also handles project sessions, Git worktrees, remote machines, and session restore. It requires tmux 3.2 or newer and runs on macOS and Linux.
TAW Features:
Agent Overview: Open one tree of tmux sessions, panes, and worktrees to see each detected agent's state, task, and how long it has been in that state.
Attention Shortcuts: Use Tab to select the next blocked, errored, or newly finished agent, Enter to go to it, or prefix + O to jump from elsewhere in tmux.
Agent Detection: Recognizes 22 coding agents, including Claude Code, Codex, Gemini CLI, OpenCode, Copilot CLI, and Cursor, including agents launched through wrappers or containers.
Notifications: Get alerts in tmux, on a macOS or Linux desktop, or in a terminal; hooks can send messages through ntfy, Pushover, or another command.
Session Restore: Save tmux sessions, windows, layouts, and folders, then restore them after a reboot or crash; 18 agents can reopen their conversations when their hooks are installed.
Worktrees and Machines: Create a tmux session for a Git worktree, reopen a closed worktree from the tree, or list and enter agents on other machines over SSH.
TAW Benefits:
Less Pane Checking: A shared view and alerts make it easier to notice an agent waiting for approval or finished while you are working in another pane.
Faster Handoffs: Direct navigation to the next agent needing attention avoids cycling through sessions to find the conversation that requires a response.
Keep Your Setup: The plugin works inside the tmux environment you already use, so you can keep your tmux configuration, key bindings, and other plugins.
Resume Work: Restoring sessions and supported agent conversations helps you return to an interrupted coding setup without rebuilding its layout by hand.
Remote Awareness: The shared list of local and remote agents helps you track work across machines without treating each machine as a separate view.
Use Cases:
Parallel Coding: Monitor Claude Code in one session, Codex in another, and other agents in separate panes while keeping their states visible in one tree.
Approval Prompts: Get notified when an agent in an unattended pane blocks for permission, then jump to its session to review the prompt.
Finished Tasks: Find agents that have completed work but have not yet been checked, and move directly to the next one that needs review.
Worktree Projects: Give separate Git worktrees their own tmux sessions, then reopen a closed worktree from the session tree when you return to it.
Recovering Sessions: Restore sessions and supported agent conversations after a reboot or tmux crash, or attach from a phone over SSH to check on agents.

