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/meltforce/freereps/claude-mdgit clone --depth 1 https://github.com/meltforce/FreeRepsWhat 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.02285 | $0.02285 |
| Opus 5 | $0.01143 | $0.01143 |
| Sonnet 5 | $0.00457 | $0.00457 |
| Haiku 4.5 | $0.00229 | $0.00229 |
Grade A, and why
FreeReps 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 — 197 lines — stays where its author put it; the contents beside it link to each section on GitHub.
FreeReps
Self-hosted server for health data: ingest from Apple Health, Oura and Alpha
Progression, storage in PostgreSQL/TimescaleDB, a web dashboard with freely
configurable correlations, and an MCP server. It computes no scores and does no
coaching — that is a decision, not a gap (DECISIONS.md).
Monorepo. server/ holds the Go binary freereps with the web UI embedded;
app/ holds the iOS companion (FreeReps.xcodeproj). Build and run
instructions live in server/CLAUDE.md and app/CLAUDE.md, which load only
when working under those paths.
Gotchas
-
server/specs/is the source of truth for wire formats —hae-export-format.md,hae-rest-api.md,alpha-progression.md,hevy-api.md,withings-api.md,database-schema.md. Read the spec before changing an ingest path. Why: the payloads come from third-party apps whose shape is not derivable from this repo, and a mismatch surfaces as silently dropped rows rather than an error (seeINCIDENTS.md, 2026-04-08). -
The backend does not compile without
server/web/dist.server/web.goembeds it viago:embed. Build the frontend first, or create the stub:mkdir -p server/web/dist && touch server/web/dist/.gitkeep. Why: a missing directory fails the Go build with an embed error that names the directive, not the cause. -
A metric arriving from two sources needs a unit decision and a source filter. Apple Health and Oura disagree on both units and granularity. Why: both classes of failure have already occurred and neither raised an error — see the 2026-03-25 and 2026-03-26 entries in
INCIDENTS.md. -
What you learn about building or running goes into the
CLAUDE.mdnext to the code, not into this file. Why:server/andapp/instructions load only for sessions working there; in this file they would load in every session.
Repository & CI/CD
Forgejo is the source of truth: git.coydog-fence.ts.net/meltforce.net/freereps
(origin). github.com/meltforce/FreeReps is a push mirror — never push there
directly. The mirror is git push --mirror: it force-pushes and prunes refs
that don't exist on Forgejo, so anything that must survive on GitHub has to
exist on Forgejo first (a GitHub-only branch is deleted at the next sync).
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 · 197 lines · 2,285 tokens per session scan A c473713b601a
FreeReps CLAUDE.md is an instructions file published in the GitHub repository meltforce/FreeReps (16 stars, last pushed 23d ago), licensed MIT. It adds 2,285 tokens to every session, about $0.0114 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
withings-mcp CLAUDE.md
Instructions for akutishevsky/withings-mcp, covering claude.md, general rules, project overview, development commands and running.
hevy-mcp AGENTS.md
Instructions for chrisdoc/hevy-mcp, covering agent instructions for hevy-mcp, start in a fresh worktree, git safety in tests, source-of-truth pointers and runtime and package manager.
icuvisor CLAUDE.md
Instructions for ricardocabral/icuvisor, covering claude.md, what this project is, authoritative documents, hard rules and project layout.
gccli CLAUDE.md
Instructions for bpauli/gccli, covering claude.md, project overview, build & quality commands, architecture and key packages.
polar-mcp AGENTS.md
AGENTS.md instructions for davidmosiah/polar-mcp, covering agent development notes, scope, commands and rules.
oura-mcp CLAUDE.md
Claude Code instructions for Rajskij/oura-mcp, covering claude.md, current phase: 2 — showcase (self-host distribution), stack, commands and rules.