{"name":"tmux-agent-sidebar: Real-time AI Agent Monitoring in tmux","description":"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","url":"https://osrepos.com/repo/hiroppy-tmux-agent-sidebar","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/hiroppy-tmux-agent-sidebar","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/hiroppy-tmux-agent-sidebar.md","json":"https://osrepos.com/repo/hiroppy-tmux-agent-sidebar.json","topics":["Rust","tmux","AI","Developer Tools","Productivity","CLI","Open Source"],"keywords":["Rust","tmux","AI","Developer Tools","Productivity","CLI","Open Source"],"stars":null,"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.","content":"## Introduction\n\ntmux-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.\n\nThis 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.\n\n## Installation\n\nThe easiest way to install tmux-agent-sidebar is by using [TPM (tmux Plugin Manager)](https://github.com/tmux-plugins/tpm).\n\n1.  Add the plugin to your `~/.tmux.conf` file:\n\n    tmux\n    set -g @plugin 'hiroppy/tmux-agent-sidebar'\n    \n\n2.  Reload your tmux environment (`tmux source ~/.tmux.conf`).\n\n3.  Press `prefix + I` (capital i) to fetch and install the plugin. The install wizard will download a pre-built binary or build from source.\n\nFor manual installation or more detailed instructions, please refer to the [official documentation](https://hiroppy.github.io/tmux-agent-sidebar/getting-started/installation/).\n\n## Examples\n\nAfter 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:\n\n*   **Claude Code:** Register the plugin within Claude Code using `/plugin marketplace add ~/.tmux/plugins/tmux-agent-sidebar` and `/plugin install tmux-agent-sidebar@hiroppy`.\n*   **Codex:** Open a Codex pane, press `prefix + e`, click the yellow `?` badge, copy the setup snippet, and paste it into the Codex pane.\n*   **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`.\n\nOnce configured, you can toggle the sidebar:\n\n*   `prefix + e` toggles the sidebar in the current window.\n*   `prefix + E` toggles it across all windows and sessions.\n\n## Why Use It\n\ntmux-agent-sidebar offers several compelling features that make it an essential tool for developers working with AI coding agents:\n\n*   **Every pane, one view:** It tracks Claude Code, Codex, and OpenCode panes across all your tmux sessions and windows, providing a centralized dashboard.\n*   **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.\n*   **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.\n*   **Desktop notifications:** Receive native alerts when an agent finishes a task, requires permission, or encounters an error, keeping you informed without constant monitoring.\n\n## Links\n\n*   **GitHub Repository:** [https://github.com/hiroppy/tmux-agent-sidebar](https://github.com/hiroppy/tmux-agent-sidebar){:target=\"_blank\"}\n*   **Official Documentation:** [https://hiroppy.github.io/tmux-agent-sidebar/](https://hiroppy.github.io/tmux-agent-sidebar/){:target=\"_blank\"}\n*   **Getting Started:** [https://hiroppy.github.io/tmux-agent-sidebar/getting-started/installation/](https://hiroppy.github.io/tmux-agent-sidebar/getting-started/installation/){:target=\"_blank\"}\n*   **Features Overview:** [https://hiroppy.github.io/tmux-agent-sidebar/features/agent-pane/](https://hiroppy.github.io/tmux-agent-sidebar/features/agent-pane/){:target=\"_blank\"}","metrics":{"detailViews":2,"githubClicks":2},"dates":{"published":null,"modified":"2026-08-23T07:38:43.000Z"}}