# tmux-agent-sidebar: Real-time AI Agent Monitoring in tmux

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/hiroppy-tmux-agent-sidebar
Generated for open source discovery and AI-assisted research.

tmux-agent-sidebar is a powerful tmux plugin designed to monitor AI coding agents like Claude Code, Codex, and OpenCode across all your tmux sessions and windows. It provides real-time status updates, background shell states, prompts, and Git information, all within a convenient sidebar. This tool enhances productivity by centralizing agent activity and offering quick actions like spawning worktrees.

GitHub: https://github.com/hiroppy/tmux-agent-sidebar
OSRepos URL: https://osrepos.com/repo/hiroppy-tmux-agent-sidebar

## Summary

tmux-agent-sidebar is a powerful tmux plugin designed to monitor AI coding agents like Claude Code, Codex, and OpenCode across all your tmux sessions and windows. It provides real-time status updates, background shell states, prompts, and Git information, all within a convenient sidebar. This tool enhances productivity by centralizing agent activity and offering quick actions like spawning worktrees.

## Topics

- Rust
- tmux
- AI
- Developer Tools
- Productivity
- CLI
- Open Source

## Repository Information

Last analyzed by OSRepos: Sun Aug 23 2026 08:38:43 GMT+0100 (Western European Summer Time)
Detail views: 2
GitHub clicks: 2

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

tmux-agent-sidebar is an innovative tmux sidebar that provides real-time monitoring of AI coding agents across all your tmux windows and sessions. Developed in Rust, this plugin offers a unified view of agents like Claude Code, Codex, and OpenCode, displaying their status, background shells, prompts, Git state, activity, and worktrees without requiring you to switch windows.

This tool is designed to streamline your development workflow by centralizing information from your AI assistants, making it easier to track their progress and interact with them efficiently.

## Installation

The easiest way to install tmux-agent-sidebar is by using [TPM (tmux Plugin Manager)](https://github.com/tmux-plugins/tpm).

1.  Add the plugin to your `~/.tmux.conf` file:

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

2.  Reload your tmux environment (`tmux source ~/.tmux.conf`).

3.  Press `prefix + I` (capital i) to fetch and install the plugin. The install wizard will download a pre-built binary or build from source.

For manual installation or more detailed instructions, please refer to the [official documentation](https://hiroppy.github.io/tmux-agent-sidebar/getting-started/installation/).

## Examples

After installation, you'll need to wire up your AI agents to integrate with the sidebar. Here's a brief overview, with full walkthroughs available in the documentation:

*   **Claude Code:** Register the plugin within Claude Code using `/plugin marketplace add ~/.tmux/plugins/tmux-agent-sidebar` and `/plugin install tmux-agent-sidebar@hiroppy`.
*   **Codex:** Open a Codex pane, press `prefix + e`, click the yellow `?` badge, copy the setup snippet, and paste it into the Codex pane.
*   **OpenCode:** Symlink the plugin file to your OpenCode plugins directory: `ln -sf ~/.tmux/plugins/tmux-agent-sidebar/.opencode/plugins/tmux-agent-sidebar.js ~/.config/opencode/plugins/tmux-agent-sidebar.js`.

Once configured, you can toggle the sidebar:

*   `prefix + e` toggles the sidebar in the current window.
*   `prefix + E` toggles it across all windows and sessions.

## Why Use It

tmux-agent-sidebar offers several compelling features that make it an essential tool for developers working with AI coding agents:

*   **Every pane, one view:** It tracks Claude Code, Codex, and OpenCode panes across all your tmux sessions and windows, providing a centralized dashboard.
*   **Live metadata:** Get real-time updates on prompts, tool calls, response previews, background shell states, wait reasons, task progress, and subagent trees as your agents work.
*   **Worktrees, included:** Easily spawn a fresh worktree and agent directly from the sidebar, and tear it down, including the window, worktree, and branch, with a single keystroke.
*   **Desktop notifications:** Receive native alerts when an agent finishes a task, requires permission, or encounters an error, keeping you informed without constant monitoring.

## Links

*   **GitHub Repository:** [https://github.com/hiroppy/tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar){:target="_blank"}
*   **Official Documentation:** [https://hiroppy.github.io/tmux-agent-sidebar/](https://hiroppy.github.io/tmux-agent-sidebar/){:target="_blank"}
*   **Getting Started:** [https://hiroppy.github.io/tmux-agent-sidebar/getting-started/installation/](https://hiroppy.github.io/tmux-agent-sidebar/getting-started/installation/){:target="_blank"}
*   **Features Overview:** [https://hiroppy.github.io/tmux-agent-sidebar/features/agent-pane/](https://hiroppy.github.io/tmux-agent-sidebar/features/agent-pane/){:target="_blank"}