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/cry8a8y/hushflow/claude-mdgit clone --depth 1 https://github.com/cry8a8y/HushFlowWrote 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/cry8a8y/hushflow/claude-md)<a href="https://agentmods.dev/instructions/cry8a8y/hushflow/claude-md"><img src="https://agentmods.dev/badge/instructions/cry8a8y/hushflow/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.00900 | $0.00900 |
| Opus 5 | $0.00450 | $0.00450 |
| Sonnet 5 | $0.00180 | $0.00180 |
| Haiku 4.5 | $0.00090 | $0.00090 |
Grade A, and why
HushFlow 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 3d 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.
How it starts
The opening of the file, as written. The whole thing — 56 lines — stays where its author put it; the contents beside it link to each section on GitHub.
HushFlow — Claude Code Instructions
Project Overview
HushFlow is a CLI tool that turns AI coding assistant wait time into guided breathing exercises. Pure Bash implementation, no build step.
Key Conventions
- Language: Code, commits, and CLI output in English. Documentation available in EN/zh-TW/zh-CN/ja.
- Commit format:
<type>(<scope>): <description>— types: feat, fix, docs, test, chore, refactor - PR flow: All changes via branch → PR → merge. No direct push to main.
- Testing: Run all test suites before committing. All tests must pass.
bash test/smoke-test.sh— Core smoke tests (156+ tests)bash test/terminal-detect-test.sh— Terminal detection tests (19 tests)bash test/unit-test.sh— Unit tests for pure functions (29 tests)bash test/sound-test.sh— Sound system tests (27 tests)bash test/install-contract-test.sh— Installer contracts: 3 targets × 7 scenarios (76+ tests)bash test/e2e-install-test.sh— E2E install flow: fresh, non-git dir, update, reinstall (31 tests)bash test/onboarding-test.sh— Onboarding wizard tests (23 tests)bash scripts/test-ui-layout.sh --ci— UI layout tests (requires tmux)pwsh test/install-ps1-test.ps1— PowerShell installer tests (Windows only)- See
docs/testing/install-matrix.mdfor the full cross-platform test matrix
Architecture
breathe-compact.sh— Core rendering engine (SIN64/COS32 lookup tables, 10fps double-buffer)cli.sh— CLI entry point fornpx hushflow(routes: install, config, theme, animation, sound, stats, doctor, onboarding, version)onboarding.sh— Guided first-run wizard (exercise/theme selection + 5-second live demo)set-exercise.sh— Config management (exercises, themes, animations, sound)hooks/on-start.sh/on-stop.sh— AI tool lifecycle hooks (start/stop + session notification + onboarding trigger)hooks/on-permission.sh— Pauses breathing on PermissionRequesthooks/on-resume.sh— Smart resume after permission approval (3-tier expiry)lib/hook-common.sh— Shared hook bootstrap (hf_log, CONFIG_DIR, SESSION_DIR)lib/stats.sh— Session statistics (TSV format:timestamp\tcycles\tduration\texercise\tanimation\ttheme)lib/wrap.sh— Universal CLI wrapper (hushflow wrap -- <cmd>)lib/sound.sh— Async audio playback with crossfade (ffplay/mpv/afplay/paplay)lib/detect-background.sh— Terminal background color detection (OSC 11)lib/detect-terminal.sh— Terminal emulator detectionthemes/*.json— Community themes (JSON with RGB color values)
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.
- 3d ago First seen · 56 lines · 900 tokens per session scan A abf90f57e7e1
HushFlow CLAUDE.md is an instructions file published in the GitHub repository cry8a8y/HushFlow (1 stars, last pushed 5mo ago), licensed MIT. It adds 900 tokens to every session, about $0.0045 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-31.
Other instructions, from other repositories
kmux AGENTS.md
Instructions for kkd927/kmux, covering agents.md, kmux focus and test discipline.
stealth-code CLAUDE.md
Instructions for suxrobGM/stealth-code, covering stealthcode, build & run, architecture, project structure and key conventions.
gemini-cli-hud GEMINI.md
Instructions for yideng-xl/gemini-cli-hud, covering gemini cli hud, what it shows, how it works and notes.
herd CLAUDE.md
Claude Code instructions for poddubnyoleg/herd, covering claude.md, commands, architecture and key design decisions.
herd GEMINI.md
Gemini CLI instructions for poddubnyoleg/herd, covering gemini.md, architecture overview, core tasks & behaviors, file structure and api endpoints.
gemini-cli-hud AGENTS.md
Instructions for yideng-xl/gemini-cli-hud: This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in nodemodules/next/dist/docs/ before writing any code. Heed deprecation notices.