Skip to content

tmux-agent-sidebar

Every Claude Code and Codex pane across every tmux session and window — status, prompts, Git, and activity in one sidebar.
tmux-agent-sidebar screenshot

One sidebar, every pane

Tracks Claude Code and Codex panes across every tmux session and window at once, so context switching stops meaning window switching.

Live status, prompts, responses

Prompts, tool calls, response previews, wait reasons, task progress, and subagent trees — all refreshing as the agents work.

Worktree-aware

Spawn a fresh worktree + agent from the sidebar, and tear it down — window, worktree, and branch — in a single keystroke.

Desktop notifications

Native notifications when an agent finishes, needs a permission, or errors out. Configurable per event.

Using TPM:

Terminal window
set -g @plugin 'hiroppy/tmux-agent-sidebar'

Reload with tmux source ~/.tmux.conf, press prefix + I to install, and the install wizard downloads a pre-built binary or builds from source.

Next, wire up your agent hooks — Claude Code installs as a plugin, and Codex is a one-paste setup inside its own pane.