Tmux Agent Panel — Development skill for Claude Code

tap — Tmux Agent Panel

An agent-aware tmux pane picker. `tap` lists every pane across all your tmux sessions in an fzf popup and shows, live, what your coding agents (Claude Code, Codex, pi) are doing in each of them: blocked on a permission request, waiting for your input, running, or idle — and what they're working on. Blocked agents sort first, so the pane that needs you is always at the top.

fzf is embedded as a Go library, so the only runtime dependency is tmux itself.

Install

# Homebrew
brew install ahmedelgabri/tap/tmux-agent-panel

# mise (prebuilt binary from GitHub releases)
mise use github:ahmedelgabri/tmux-agent-panel

# Nix
nix run github:ahmedelgabri/tmux-agent-panel

# Or build from source
go build -o tap ./cmd/tap/

Then wire the agent hooks. Installation leaves integration contents unchanged on repeat runs, but saves a timestamped backup before every rewrite of an existing JSON config or pi extension. By default, it only modifies agents whose binary is on `PATH`. Force a subset with `--claude`, `--codex`, or `--pi`.

tap install
tap doctor # verify the wiring

`tap uninstall` removes direct tap hook invocations and the tap-managed pi extension. It leaves other hooks and native plugin/package installs alone. Files managed by Nix/Home Manager are refused with a pointer to declarative wiring instead.

Usage

Open the picker from any shell inside tmux:

tap pick

The picker opens focused on agent panes, or all panes if none are running.

Key	Action
Enter	Switch to the highlighted pane
ctrl-a	Toggle between agent panes and all panes
ctrl-p	Toggle the preview