A tmux sidebar designed to monitor AI coding agents (Claude Code, Codex, OpenCode) across all tmux sessions and windows in real-time. It offers a unified view of agent status, prompts, Git state, and activity, allowing developers to stay informed without context switching, thereby enhancing productivity within their existing terminal workflow.

How It Works

The sidebar integrates with supported AI agents via specific hooks or local plugin bridges. It continuously streams live metadata from agent panes, including active prompts, tool calls, response previews, background shell states, wait reasons, task progress indicators, and subagent hierarchies. This real-time data flow is presented within a dedicated sidebar pane in tmux, enabling users to track multiple agents and their states concurrently without leaving their primary terminal environment.

Quick Start & Requirements

• Installation: Primarily via TPM: add set -g @plugin 'hiroppy/tmux-agent-sidebar' to ~/.tmux.conf, reload tmux (tmux source ~/.tmux.conf), and run prefix + I. The install wizard handles binary download or source compilation.
• Prerequisites: tmux 3.0+, TPM (or manual installation), GitHub CLI (optional, for PR numbers in Git tab).
• Agent Integration: Requires specific setup steps for Claude Code, Codex, and OpenCode, detailed in the documentation.
• Links: Documentation, Getting Started, Features.

Highlighted Details

• Unified Agent View: Tracks Claude Code, Codex, and OpenCode panes across all tmux sessions and windows.
• Live Metadata: Real-time updates on prompts, tool calls, response previews, background shell state, wait reasons, task progress, and subagent trees.
• Worktree Management: Integrated functionality to spawn new worktrees with agents and manage windows, worktrees, and branches from the sidebar.
• Desktop Notifications: Native alerts for agent completion, permission requests, or errors.
• Git Integration: Displays Git status and optionally PR numbers (requires GitHub CLI).

Maintenance & Community

The provided README does not detail specific contributors, sponsorships, community channels (like Discord/Slack), or a public roadmap. Development appears focused on core functionality and integration.

Licensing & Compatibility

The project is released under the MIT License. This license is permissive and generally allows for commercial use, modification, and distribution, including within closed-source applications, without significant copyleft restrictions.

Limitations & Caveats

The README does not explicitly mention alpha status, known bugs, or unsupported platforms. Integration requires specific configuration steps for each supported AI agent. The GitHub CLI is optional but necessary for full Git tab functionality (PR numbers).