https://github.com/hiroppy/tmux-agent-sidebar
A tmux sidebar that monitors AI coding agents across all windows and sessions in real-time
https://github.com/hiroppy/tmux-agent-sidebar
Last synced: about 2 months ago
JSON representation
A tmux sidebar that monitors AI coding agents across all windows and sessions in real-time
- Host: GitHub
- URL: https://github.com/hiroppy/tmux-agent-sidebar
- Owner: hiroppy
- License: mit
- Created: 2026-04-05T00:59:09.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-08T04:36:05.000Z (2 months ago)
- Last Synced: 2026-04-08T06:28:10.709Z (2 months ago)
- Language: Rust
- Size: 2 MB
- Stars: 57
- Watchers: 1
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
tmux-agent-sidebar
One tmux sidebar that tracks every Claude Code and Codex pane across every session and window. See status, prompts, Git state, activity, and worktrees without switching windows.
Documentation ·
Getting Started ·
Features
## Features
- **Every pane, one view**
— tracks Claude Code and Codex panes across all tmux sessions and windows
- **Live metadata**
— prompts, tool calls, response previews, wait reasons, task progress, and subagent trees refresh as the agents work
- **Worktrees, included**
— spawn a fresh worktree + agent from the sidebar and tear it down — window, worktree, and branch — in one keystroke
- **Desktop notifications**
— native alerts when an agent finishes, needs permission, or errors out
## Requirements
- tmux 3.0+
- [TPM](https://github.com/tmux-plugins/tpm) (or the manual install in [Installation](https://hiroppy.github.io/tmux-agent-sidebar/getting-started/installation/))
- [GitHub CLI](https://cli.github.com/) (optional — required only for PR numbers in the Git tab)
## Quick Start
### 1. Install the plugin
Using [TPM](https://github.com/tmux-plugins/tpm):
```tmux
set -g @plugin 'hiroppy/tmux-agent-sidebar'
```
Reload tmux (`tmux source ~/.tmux.conf`), then press `prefix + I`. The install wizard downloads a pre-built binary or builds from source.
### 2. Wire up the agent hooks
- **Claude Code** — register the plugin inside Claude Code:
```sh
/plugin marketplace add ~/.tmux/plugins/tmux-agent-sidebar
/plugin install tmux-agent-sidebar@hiroppy
```
- **Codex** — open a Codex pane, press `prefix + e`, click the yellow `ⓘ` badge, copy the setup snippet, paste it into the Codex pane.
Full walkthroughs: [Claude Code setup](https://hiroppy.github.io/tmux-agent-sidebar/getting-started/claude-code/) · [Codex setup](https://hiroppy.github.io/tmux-agent-sidebar/getting-started/codex/)
### 3. Toggle the sidebar
`prefix + e` toggles the sidebar in the current window, `prefix + E` toggles it everywhere.
## Documentation
The [documentation site](https://hiroppy.github.io/tmux-agent-sidebar/) covers every feature and option:
- [Agent pane breakdown](https://hiroppy.github.io/tmux-agent-sidebar/features/agent-pane/)
- [Worktree lifecycle](https://hiroppy.github.io/tmux-agent-sidebar/features/worktree/)
- [Activity log](https://hiroppy.github.io/tmux-agent-sidebar/features/activity-log/) · [Git tab](https://hiroppy.github.io/tmux-agent-sidebar/features/git-status/) · [Notifications](https://hiroppy.github.io/tmux-agent-sidebar/features/notifications/)
- [Agent support matrix](https://hiroppy.github.io/tmux-agent-sidebar/agents/)
- [Keybindings](https://hiroppy.github.io/tmux-agent-sidebar/reference/keybindings/) · [tmux options](https://hiroppy.github.io/tmux-agent-sidebar/reference/tmux-options/) · [Scripting](https://hiroppy.github.io/tmux-agent-sidebar/reference/scripting/)
## Development
Symlink the plugin directory to your working copy so builds are picked up without copying:
```sh
rm -rf ~/.tmux/plugins/tmux-agent-sidebar
ln -s ~/.tmux/plugins/tmux-agent-sidebar
cargo build --release
```
Toggle the sidebar off → on to pick up the new binary.
## License
[MIT](./LICENSE)