Skip to content
tmux-agent-sidebar

Agent pane

agent pane screenshot

The sidebar renders one row per agent pane across all tmux sessions and windows. Each row is packed with live metadata pulled from the agent’s hooks and from tmux itself.

Filter bar

Section titled “Filter bar”

The top row of the sidebar filters the agent list by status. Each entry is an icon + live count; selecting one hides rows whose status doesn’t match.

Status filter

Section titled “Status filter”
  • ≡N — all panes
  • ●N — running
  • ◐N — waiting
  • ○N — idle
  • ✕N — error

Cycle with h / l (or ← / →), or click an entry. Tab advances through the filter one step at a time.

Repo filter

Section titled “Repo filter”

Below the status row, a repo selector (▾) narrows the list to a single repository. Open it with r or by clicking the arrow; — means no repo filter is active.

Row elements

Section titled “Row elements”

Status icon

Section titled “Status icon”
  • ● running
  • ◐ waiting
  • ○ idle
  • ✕ error

Permission badge

Section titled “Permission badge”
  • plan — plan mode
  • edit — auto-edit
  • auto — auto-accept
  • dontAsk — skip every permission prompt for the session
  • defer — wait for an explicit decision before applying
  • ! — bypass permissions (dangerous)

Session name

Section titled “Session name”

Defaults to the agent name. Can be changed through Claude Code’s /rename.

+ marker

Section titled “+ marker”

Indicates the pane sits in a git worktree (any worktree, not only sidebar-created ones). Sidebar-spawned worktrees additionally show a × button for one-keystroke teardown. See Worktree for details.

Branch

Section titled “Branch”

Current Git branch for the pane’s cwd. Claude updates dynamically through the CwdChanged hook.

Elapsed time

Section titled “Elapsed time”

Time since the last user prompt.

Task progress

Section titled “Task progress”

Synchronized from the agent’s task list. Each task gets a glyph for its state; the trailing count is completed/total.

  • ✔ — completed
  • ◼ — in progress
  • ◻ — pending
  ✔✔◼◻ 2/4

Subagent tree

Section titled “Subagent tree”

Parent-child branches for spawned sub-agents. Middle entries use ├, the last uses └. Each row shows the subagent kind followed by #<id>.

├ Explore #a1b2
├ Plan    #d4e5
└ Bash    #dead

Listening ports

Section titled “Listening ports”

Localhost ports the pane’s process is listening on.

Response arrow (▷)

Section titled “Response arrow (▷)”

Preview of the latest agent response.

Prompt text

Section titled “Prompt text”

Latest user prompt.

Wait reason

Section titled “Wait reason”

Why the agent is waiting — populated from Claude’s Notification, PermissionDenied, and TeammateIdle hooks.