jonmosco

Tmux Canopy — AI skill for Claude Code

AI community

A tmux workspace tree and AI-agent monitor in one sidebar, with no daemon.

How to install Tmux Canopy

This entry records only its repository, not the path inside it, so there is no exact command to give. Open jonmosco/tmux-canopy and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Tmux Canopy does

A tmux workspace tree and AI-agent monitor in one sidebar, with no daemon. Tracks Claude Code, Codex, OpenCode, Gemini, Cursor and more.

Alternatives in AI

Token Monitor — Local-first desktop widget for tracking token usage, costs, and limits across 32+ AI coding tools—including Cl 1.8k ★
Agmsg — Cross-vendor messaging for CLI AI coding agents — let Claude Code, Codex, Gemini & Copilot talk to each other 1.5k ★
Claude Replay — Convert AI coding agent sessions (Claude Code, Cursor, Codex, Gemini, OpenCode) into self-contained, embeddabl 644 ★

README

tmux-canopy

[![Test](https://github.com/jonmosco/tmux-canopy/actions/workflows/test.yml/badge.svg)](https://github.com/jonmosco/tmux-canopy/actions/workflows/test.yml)

**A tmux workspace tree and AI-agent monitor in one sidebar, with no daemon.**

Canopy keeps your sessions, windows, and panes in a persistent tree that follows you as you switch windows and sessions, with the same selection and the same folded branches. Turn on agent mode and the same tree shows what every Claude Code, Codex, OpenCode, Gemini, Cursor, Antigravity, and Pi session is doing: which agents are working, which subagents they started, and which are waiting for you. Press `n` to jump straight to the next one that needs input.

Preview

[![Animated tmux-canopy demo showing navigation, readable notification badges, search, folding, and buffers](docs/assets/canopy-demo.gif)](docs/assets/canopy-demo.gif)

[View a still image](docs/assets/canopy-demo.png).

Quick start

Install [tmux](https://github.com/tmux/tmux), [fzf](https://github.com/junegunn/fzf), and Bash 4.4+ (see [Requirements](#requirements-and-support)). With [TPM](https://github.com/tmux-plugins/tpm), add this before its `run '~/.tmux/plugins/tpm/tpm'` line:
```
set -g @plugin 'jonmosco/tmux-canopy'
set -g @tmux-canopy-agents 'on'   # optional: monitor AI coding agents
```
Press **prefix + I** to install.
Press **prefix + T** to open the sidebar (with the default prefix: **Ctrl-b**, then **Shift-t**). Press `?` inside it for every key.

For agent status beyond process detection, run `~/.tmux/plugins/tmux-canopy/canopy setup` and pick your agents (see [AI agent monitoring](#ai-agent-monitoring)). [Manual installation](#install) needs no plugin manager.

Features

Sessions → windows → panes tree with application icons and an active-location marker.
Left or right placement; left by default.
Width-aware directory grouping, optional minimal and compact views, previews, and scrollable popup