tmux-pane-tree: Instructions file for Claude Code

CLAUDE.md

tmux-pane-tree CLAUDE.md is an instructions file for Claude Code from sandudorogan/tmux-pane-tree. It costs 1,899 tokens per session, scanned A, original, MIT.

Project instructions for tmux-pane-tree, a tmux plugin that shows terminal sessions, windows, and panes in an interactive sidebar. Tmux is a terminal tool for managing multiple command-line workspaces in one window.

In plain words
What is it for?
Use them when changing the plugin's Bash utilities, Python terminal interface, agent-status detection, hooks, configuration, or unit and live-test setup.
Why use it?
They give a coding agent the project's architecture and testing rules, including how to test without relying on a live tmux session.

Instructions file for Claude Code

Written for Claude Code: the file is CLAUDE.md. Also seen: positional $N argument; mentions Codex; mentions OpenCode.

This is sandudorogan/tmux-pane-tree's own configuration. It tells Claude Code how to work on tmux-pane-tree itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything tmux-pane-tree configures →

Reuse

Borrowing it

Nothing to install: this file belongs to sandudorogan/tmux-pane-tree. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/sandudorogan/tmux-pane-tree/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/sandudorogan/tmux-pane-tree

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for tmux-pane-tree CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/sandudorogan/tmux-pane-tree/claude-md/github.svg)](https://agentmods.dev/instructions/sandudorogan/tmux-pane-tree/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/sandudorogan/tmux-pane-tree/claude-md"><img src="https://agentmods.dev/badge/instructions/sandudorogan/tmux-pane-tree/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for tmux-pane-tree CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/sandudorogan/tmux-pane-tree/claude-md"><img src="https://agentmods.dev/badge/instructions/sandudorogan/tmux-pane-tree/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 1,899 This file is loaded in full into every session.
When invoked 1,899 The same file — it is already loaded in full.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.01899 $0.01899
Opus 5.5 $0.00760 $0.00760
Sonnet 5.5 $0.00380 $0.00380
Haiku 4.5 $0.00190 $0.00190

Measured 1mo ago against content hash ad5b3c33ec0d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

tmux-pane-tree CLAUDE.md scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Runs shell commandslowCapability

Expected in a hook, worth knowing in a rule or an instructions file.

- `subprocess.check_output` / `subprocess.run` for external commands
CLAUDE.md · 158 lines

How it starts

The opening of the file, as written. The whole thing — 158 lines — stays where its author put it; the contents beside it link to each section on GitHub.

tmux-sidebar

A tmux plugin that adds an interactive sidebar showing sessions, windows, and panes with agent status badges. Written in bash and python3 (curses UI).

Architecture

sidebar.tmux          <- polyglot TPM entry point, applies tmux-pane-tree.conf
tmux-pane-tree.tmux   <- polyglot, no-op under TPM, sources the conf when sourced
tmux-pane-tree.conf   <- primary tmux config: hooks, keybindings, startup
sidebar.conf          <- legacy config (kept for install-live.sh compatibility)
scripts/
  core/
    lib.sh            <- shared bash utilities (state, tmux helpers, json)
    hook-lib.sh       <- shared shell hook input handling
    hook-parser.py    <- shared agent event parsing
    hook-metadata.py  <- structured metadata extraction from hook payloads
  ui/
    sidebar-ui.py     <- interactive curses loop entrypoint
    sidebar_ui_lib/
      core.py         <- tmux/config helpers, prompts, pane actions
      status.py       <- live agent detection and badge selection
      tree.py         <- tree loading, selection, search helpers
      render.py       <- curses colors, drawing, row-map/context-menu IPC
      icon_config.py  <- icon theme/badge config (ASCII, Unicode, Nerd Font)
  features/
    sidebar/          <- toggle/ensure/focus/close/render lifecycle helpers
    hooks/            <- agent hook wrappers, event filter, built-in installer
    state/            <- pane-state writers and cleanup helpers
    context-menu/     <- right-click menu integration
    sessions/         <- creation and renaming of windows/sessions
  install-live.sh     <- dev installer (copies to plugin dir, patches paths, reloads)
tests/
  testlib.sh          <- fake tmux test framework
  real_tmux_testlib.sh <- live tmux test helpers
  run.sh              <- test runner
  core/ sidebar/ ui/ hooks/ state/ sessions/ context-menu/ integration/ examples/
                      <- grouped test suites
examples/
  claude-hook.sh / codex-hook.sh / cursor-hook.sh / kiro-hook.sh / opencode-hook.sh / pi-hook.sh
                      <- agent integration hooks
docs/                 <- project landing page

Read the full file on GitHub · 158 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago Changed · +1 lines · +63 tokens per session ad5b3c33ec0d
  2. 1mo ago Changed · +54 tokens per session c489a6a2ce31
  3. 1mo ago First seen · 157 lines · 1,782 tokens per session scan A a161c4bc88eb

Subscribe to this mod's changes

tmux-pane-tree CLAUDE.md is an instructions file published in the GitHub repository sandudorogan/tmux-pane-tree (65 stars, last pushed 3d ago), licensed MIT. It adds 1,899 tokens to every session, about $0.0076 per session on Opus 5.5. A static security scan graded it A with 1 finding (runs shell commands). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories