ccmux: Instructions file for Claude Code

AGENTS.md

ccmux AGENTS.md is an instructions file for Claude Code, Codex, OpenCode from epilande/ccmux. It costs 6,377 tokens per session, scanned A, original, MIT.

A project instruction file for ccmux, a terminal dashboard that tracks AI coding-agent sessions running in tmux panes.

In plain words
What is it for?
It is for developing the Bun and TypeScript command-line tool, monitoring agent logs, and verifying changes to its interactive terminal interface.
Why use it?
It records the supported agents, technical stack, file-watching approach, and coding conventions needed to change the tool safely.

Instructions file for Claude CodeCodexOpenCode

Written for Claude Code and Codex and OpenCode: SessionStart hook event, but also the file is AGENTS.md. Also seen: mentions subagents; mentions Claude Code; mentions AGENTS.md.

This is epilande/ccmux's own configuration. It tells Claude Code, Codex and OpenCode how to work on ccmux 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 ccmux configures →

Reuse

Borrowing it

Nothing to install: this file belongs to epilande/ccmux. 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/epilande/ccmux/main/AGENTS.md
Clone the repo
git clone --depth 1 https://github.com/epilande/ccmux

Made for: Claude Code, Codex, OpenCode.

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 ccmux AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/epilande/ccmux/agents-md/github.svg)](https://agentmods.dev/instructions/epilande/ccmux/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/epilande/ccmux/agents-md"><img src="https://agentmods.dev/badge/instructions/epilande/ccmux/agents-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 ccmux AGENTS.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/epilande/ccmux/agents-md"><img src="https://agentmods.dev/badge/instructions/epilande/ccmux/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 6,377 This file is loaded in full into every session.
When invoked 6,377 The same file — it is already loaded in full.
Security scan A 0 findings. 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.06377 $0.06377
Opus 5.5 $0.02551 $0.02551
Sonnet 5.5 $0.01275 $0.01275
Haiku 4.5 $0.00638 $0.00638

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

Security

Grade A, and why

ccmux AGENTS.md scanned grade A with 0 findings 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 10d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

AGENTS.md · 228 lines

How it starts

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

AGENTS.md

Project Overview

ccmux is a CLI tool for tracking AI coding agent sessions running in tmux panes and jumping to the one that needs you. It uses a background daemon that detects agent processes, watches log files, and scans terminal output to derive session state. An interactive TUI shows live session states at a glance.

Built-in agents: Claude Code, Codex, Cursor, OpenCode, Pi, oh-my-pi (omp), Antigravity, Copilot, Gemini CLI, plus custom agent definitions via config.

Tech Stack

  • Runtime: Bun 1.x
  • Language: TypeScript 5.x
  • TUI Framework: @opentui/solid 0.1.97 (Solid.js-based terminal UI)
  • Reactivity: Solid.js 1.9
  • File Watching: native recursive fs.watch for the agent log trees (log-tree-watcher.ts; chokidar fallback when recursive watching is unavailable), chokidar 4.x for the small flat dirs (markers, Claude subagents); stat-polling for agents that hold their log fd open (codex), whose appends fs.watch cannot see
  • CLI Framework: Commander 14.x

Development Guidelines

  • Always use bun instead of npm for all package management and script execution
  • Avoid as any type casts. Use proper types, generics, or as unknown as T only when source types have a genuine gap
  • Use ccmux show to check session status and see active tmux panes
  • You can run tmux and ccmux commands directly to test features end to end (e.g., ccmux screen, ccmux send, ccmux spawn, tmux list-panes, tmux send-keys)

Verifying TUI changes

Typecheck and bun test verify code correctness, not rendering correctness. After any change touching TUI components, columns, layout, theming, or the daemon→TUI data path, you MUST launch the picker and/or sidebar and capture the output before declaring the work done. Non-rendering CLI commands (ccmux show, ccmux config get/set) do not exercise the renderer.

Always test in a detached, isolated tmux session. Do not launch the picker in a window/pane inside the user's active session.

Read the full file on GitHub · 228 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. 10d ago Changed · +1 lines · +72 tokens per session 39be3252c0b8
  2. 13d ago Changed · +1 lines · +77 tokens per session 29e31805e0c8
  3. 17d ago Changed · -100 tokens per session 4fb03349d496
  4. 22d ago Changed · +43 tokens per session 57c0998e8b2b
  5. 1mo ago Changed · +4 tokens per session f450f919bb22
  6. 1mo ago Changed · +4 tokens per session 6b7f259b773a
  7. 1mo ago First seen · 226 lines · 6,277 tokens per session scan A 6576ef8a2132

Subscribe to this mod's changes

ccmux AGENTS.md is an instructions file published in the GitHub repository epilande/ccmux (237 stars, last pushed 3d ago), licensed MIT. It adds 6,377 tokens to every session, about $0.0255 per session on Opus 5.5. A static security scan graded it A with 0 findings. 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