AGENTS.mdA

AGENTS.md from dfkhelper/token-goat is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add dfkhelper/token-goat/AGENTS.md@git:20261104.848f124

Pins git:20261104.848f124 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
dfkhelper/token-goat
Path
AGENTS.md
Versions recorded
12
Latest version
git:20261104.848f124, committed Nov 4, 2026
First version recorded
Aug 1, 2026
Size
10,410 bytes
Repository stars
146
License
a license file GitHub does not identify

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# AGENTS.md

Guidance for AI agents and human contributors working in this repository. This file follows the tool-agnostic [AGENTS.md](https://agents.md) convention, so it is read by Claude Code, Codex, Cursor, Copilot, and any agent that honors it. For local toolchain rough edges and the release flow, see [CONTRIBUTING.md](CONTRIBUTING.md).

## Project

token-goat is a Claude Code / Codex CLI companion, written in TypeScript and bundled to `dist/token-goat.mjs`, that reduces token burn through three mechanisms: image shrinking, session-aware read hints, and surgical reads (CLI commands that extract one symbol or section instead of a whole file).

## Build, test, lint

`--cmd-b64` is strictly an internal hook transport flag, generated programmatically by token-goat hooks. Agents and interactive users must pass ordinary plain shell commands directly, using positional arguments or `--cmd`; never synthesize base64 manually, because character corruption can change commands and file paths.

```bash
npm install
npm test            # full test suite
npm run test:guards # fast I/O-free structural guards (tests/guards)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add dfkhelper/token-goat/AGENTS.md@sha256:b080fbc6a7713f93

The line at the top of this page pins the label git:20261104.848f124, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_5ob4ldegy5glqifl.svg)](https://markdownregistry.com/a/art_5ob4ldegy5glqifl)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 12 versions of this file, between Aug 1, 2026 and Nov 4, 2026, about one every 9 days.

versioncommittedcommitsizeaudit
git:20261104.848f124 latest2026-11-04 848f124 10,410 BA view · diff
git:20261025.13698142026-10-25 1369814 9,847 BA view · diff
git:20261025.fe7e6032026-10-25 fe7e603 9,679 BA view · diff
git:20261025.dd4f6562026-10-25 dd4f656 9,563 BA view · diff
git:20261016.3f80b5e2026-10-16 3f80b5e 9,329 BA view · diff
git:20261003.b75142d2026-10-03 b75142d 6,802 BA view · diff
git:20260915.17461462026-09-15 1746146 6,479 BA view · diff
git:20260818.3daa3332026-08-18 3daa333 6,362 BA view · diff
git:20260818.07e429a2026-08-18 07e429a 6,345 BA view · diff
git:20260810.78606ef2026-08-10 78606ef 5,910 BA view · diff
git:20260804.272e76c2026-08-04 272e76c 5,942 BA view · diff
git:20260801.d9af9142026-08-01 d9af914 5,637 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (10410 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

dfkhelper/token-goat · 146 stars · license a license file GitHub does not identify · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_5ob4ldegy5glqifl
GET https://markdownregistry.com/api/v1/resolve?ref=dfkhelper/token-goat/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/b080fbc6a7713f93af55dcbb26eb13ea5baa85e069fa455604e42d266df1052b

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261102.920d634 · audit A · 433,876 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 314,583 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 299,696 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 199,595 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 185,249 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 144,492 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261107.ef99eb5 · audit A · 140,694 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20261106.e45976c · audit A · 118,366 stars

Browse by kind, by grade A, or by owner.