hiroppy/tmux-agent-sidebar

What it solves

It eliminates the need to manually switch between multiple tmux windows and sessions to monitor AI coding agents. It provides a centralized view of all active agents, regardless of where they are running in your tmux environment.

How it works

The project acts as a tmux plugin that integrates with AI agents like Claude Code, Codex, and OpenCode. It uses hooks and plugins to track agent metadata—such as prompts, tool calls, and task progress—and displays this information in a dedicated sidebar. It also manages the lifecycle of Git worktrees, allowing users to spawn and tear down agents in fresh worktrees with a single keystroke.

Who it’s for

Developers who use tmux and AI coding agents (specifically Claude Code, Codex, or OpenCode) and want a unified dashboard to monitor agent activity and manage their workspace.

Highlights

• Unified Monitoring: Tracks agents across all tmux sessions and windows in one sidebar.
• Live Metadata: Displays real-time updates on prompts, response previews, background shell states, and subagent trees.
• ** uma Worktree Management**: Ability to create and destroy worktrees and associated agents quickly.
• Native Notifications: Sends desktop alerts when agents finish tasks, encounter errors, or require permission.