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,836 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,836 This file is loaded in full into every session.
When invoked 1,836 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.01836 $0.01836
Opus 5 $0.00918 $0.00918
Sonnet 5 $0.00367 $0.00367
Haiku 4.5 $0.00184 $0.00184

Measured 5d ago against content hash c489a6a2ce31, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, 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 5d 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 · 157 lines

How it starts

The opening of the file, as written. The whole thing — 157 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 shim (TPM entry point), sources tmux-pane-tree.tmux
tmux-pane-tree.tmux   <- 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 · 157 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. 5d ago Changed · +54 tokens per session c489a6a2ce31
  2. 9d 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 (54 stars, last pushed 7d ago), licensed MIT. It adds 1,836 tokens to every session, about $0.0092 per session on Opus 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

next.js AGENTS.md

AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.

vercel/next.js · 7,296 tokens

codex AGENTS.md

AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.

openai/codex · 5,153 tokens

vscode buildNext.instructions.md

Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).

microsoft/vscode · 6,785 tokens

vscode oss-third-party-notices.instructions.md

Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).

microsoft/vscode · 5,001 tokens

langchain AGENTS.md

AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.

langchain-ai/langchain · 4,469 tokens

deepseek-harness AGENTS.md

AGENTS.md instructions for deepseek-ai/deepseek-harness, covering agents.md, pre-stable apis and released session data, repository layout, commands and host sandbox failures.

deepseek-ai/deepseek-harness · 3,735 tokens