Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/luongnv89/context-stats/claude-mdgit clone --depth 1 https://github.com/luongnv89/context-statsWrote 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.
[](https://agentmods.dev/instructions/luongnv89/context-stats/claude-md)<a href="https://agentmods.dev/instructions/luongnv89/context-stats/claude-md"><img src="https://agentmods.dev/badge/instructions/luongnv89/context-stats/claude-md.svg" alt="Measured on agentmods" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.03724 | $0.03724 |
| Opus 5 | $0.01862 | $0.01862 |
| Sonnet 5 | $0.00745 | $0.00745 |
| Haiku 4.5 | $0.00372 | $0.00372 |
Grade A, and why
context-stats CLAUDE.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 today.
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.
How it starts
The opening of the file, as written. The whole thing — 114 lines — stays where its author put it; the contents beside it link to each section on GitHub.
CLAUDE.md
Project Purpose
context-stats provides real-time context window monitoring for Claude Code sessions. It tracks token consumption over time and displays live ASCII graphs so users can see how much context remains.
Implementation
The statusline is implemented in Python. Claude Code invokes the statusline script via stdin JSON pipe — the script reads JSON from stdin and writes formatted text to stdout. The Python implementation persists state to CSV files read by the context-stats CLI. The standalone statusline lives at scripts/statusline.py (Python 3, state-writing, pip-installable via the package).
CSV Format Contract
State files are append-only CSV at ~/.claude/statusline/statusline.<session_id>.state with 15 comma-separated fields. See docs/CSV_FORMAT.md for the full field specification. Key constraint: workspace_project_dir has commas replaced with underscores before writing.
Test Commands
# Python tests (canonical — matches docs/DEVELOPMENT.md agent setup notes)
source venv/bin/activate && pytest tests/python/ -q -p no:cacheprovider
# Coverage (enforces the --cov-fail-under=94 floor from pyproject.toml addopts)
pytest tests/python/ -q -p no:cacheprovider --cov=src/claude_statusline --cov-report=term
Verification Gates
After editing anything under src/ or scripts/statusline.py, run from the activated venv:
ruff check .
mypy src scripts
IMPORTANT: work is not done until lint, typecheck, and tests all pass.
Key Architectural Decisions
- Append-only CSV state files with rotation at 10,000 lines (keeps most recent 5,000); append+rotation serialized under a best-effort
fcntlexclusive lock - No network requests — all data stays local in
~/.claude/statusline/ - Session ID validation — rejects
/,\,.., null bytes, plus comma/newline/control characters (CSV safety) for path-traversal and column-shift defense - 5-second git command timeout in the Python implementation
- Config via
~/.claude/statusline.conf— simple key=value pairs
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.
- today Changed · +24 tokens per session c1042867d0c4
- 4d ago First seen · 114 lines · 3,700 tokens per session scan A 678934846795
context-stats CLAUDE.md is an instructions file published in the GitHub repository luongnv89/context-stats (116 stars, last pushed yesterday), licensed MIT. It adds 3,724 tokens to every session, about $0.0186 per session on Opus 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.
Other instructions, from other repositories
feishu-docx CLAUDE.md
Instructions for leemysw/feishu-docx, a project described as: 🚀 Feishu/Lark Docs、Sheet、Bitable Markdown | AI Agent-friendly knowledge base exporter and writer with OAuth 2.0, CLI, TUI & Claude Skills support - 飞书文档 Markdown | AI Agent 友好型导出-写入工具.
agentic-resume-builder CLAUDE.md
Claude Code instructions for WtotdeD/agentic-resume-builder, covering agentic-resume-builder development guidelines, what this repo is, active technologies, package manager and validation.
fcp-sheets CLAUDE.md
Instructions for os-tack/fcp-sheets, covering fcp-sheets, project overview, architecture, key patterns and commands.
paperless-ngx-mcp-server CLAUDE.md
Claude Code instructions for cbsmiley/paperless-ngx-mcp-server, covering claude.md, project overview, common commands, architecture and entry points.
hermes-procurement-pricing-mcp AGENTS.md
AGENTS.md instructions for felix-windsor/hermes-procurement-pricing-mcp, a project described as: Secure procurement quotation comparison MCP service with document parsing, mock market pricing, anomaly detection, and Telegram/Hermes integration.
mcp-svg-marp CLAUDE.md
Claude Code instructions for koppe-pan/mcp-svg-marp, covering mcp-svg-marp tool instructions, mcp tools available, 📊 convertsvgtomarp, 🔍 analyzesvg and automatic slide creation workflow.