tmux-agent-sidebar: Monitor Coding Agents Across tmux

Overview

tmux-agent-sidebar is a Rust tmux plugin for developers who run AI coding agents in multiple panes, windows, or sessions. It gathers agent status and related context into a single sidebar, reducing the need to switch around tmux to see what each agent is doing.

It supports Claude Code, Codex, and OpenCode. The sidebar also surfaces activity and Git context, and can start or remove an agent worktree. It is most useful when several agents are running concurrently in a tmux-based workflow.

Key Features

• Track Claude Code, Codex, and OpenCode panes across tmux sessions and windows.
• View prompts, tool calls, response previews, task progress, wait reasons, and subagent trees.
• See background shell state and Git information alongside agent activity.
• Create a worktree and agent from the sidebar, or remove the associated window, worktree, and branch.
• Receive desktop notifications when an agent finishes, needs permission, or encounters an error.
• Use an OpenCode plugin bridge that can be installed as a single plugin file.

Use Cases

• Developers running agents in several tmux windows can check progress without cycling through panes.
• A developer managing parallel tasks can compare agent activity and identify agents waiting for input or permission.
• Teams using Git worktrees for separate agent tasks can start and clean up worktrees from the sidebar.
• Developers who leave agents working in the background can use notifications to notice completions or errors.

Getting Started

Requires tmux 3.0 or later and TPM, or use the manual installation instructions. Add the plugin to your tmux configuration:

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

Reload tmux and press prefix + I to install. Agent-specific setup is also needed; see the README and documentation for details.

Considerations

• This is a tmux plugin, so it requires a tmux-based workflow and tmux 3.0 or later.
• Agent hooks or plugins must be configured for the agents you want to track.
• TPM is the documented installation path; manual installation is also available.
• GitHub CLI is optional and is only required for pull request numbers in the Git tab.