AGENTS.mdA

AGENTS.md from superdesigndev/treg is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add superdesigndev/treg/AGENTS.md@git:20261016.4c86ce5

Pins git:20261016.4c86ce5 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
superdesigndev/treg
Path
AGENTS.md
Versions recorded
50
Latest version
git:20261016.4c86ce5, committed Oct 16, 2026
First version recorded
Aug 31, 2026
Size
18,081 bytes
Repository stars
5,899
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

# tools-registry (`treg`) - guide for every coding agent

<!-- Editors: CLAUDE.md imports this file; Codex and Cursor read it directly. -->

treg is the tool catalog for an agent: one base URL, one token, and the agent can call a curated
catalog of external endpoints plus its own team's tools without ever holding an API key. The
load-bearing mechanic is a proxy that makes the caller's **real upstream request**, injects the
credential server-side when one is required, and relays the answer verbatim. A catalog endpoint
explicitly verified as public can instead relay with no injected credential. We never model an
upstream API.

## Paired treg.to checkout

For work on the hosted treg.to service, clone the public `treg` repository and private
`treg-internal` repository as siblings with those exact directory names. When `../treg-internal`
exists, treat both repositories as one operational workspace:

- `treg` owns public product code, portable behavior and self-hosting documentation.
- `treg-internal` owns live production configuration, operational runbooks, incident evidence and
  private admin tools.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add superdesigndev/treg/AGENTS.md@sha256:45ebf52ad1ddcc98

The line at the top of this page pins the label git:20261016.4c86ce5, 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_tmq6lm63i46xak3j.svg)](https://markdownregistry.com/a/art_tmq6lm63i46xak3j)

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

Versions

The registry has recorded 50 versions of this file, between Aug 31, 2026 and Oct 16, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20261016.4c86ce5 latest2026-10-16 4c86ce5 18,081 BA view · diff
git:20261016.ab5a1d62026-10-16 ab5a1d6 18,063 BA view · diff
git:20261016.3f983cb2026-10-16 3f983cb 17,988 BA view · diff
git:20261016.4199ac72026-10-16 4199ac7 17,970 BA view · diff
git:20261013.35e2d0c2026-10-13 35e2d0c 17,409 BA view · diff
git:20261013.917fb972026-10-13 917fb97 17,221 BA view · diff
git:20261012.b4be3192026-10-12 b4be319 17,128 BA view · diff
git:20261010.b9537e12026-10-10 b9537e1 16,999 BA view · diff
git:20261010.1c7110f2026-10-10 1c7110f 16,393 BA view · diff
git:20261008.30efe2a2026-10-08 30efe2a 16,746 BA view · diff
git:20261008.a7544e52026-10-08 a7544e5 16,599 BA view · diff
git:20261008.477890b2026-10-08 477890b 16,347 BA view · diff
git:20261008.f9a477d2026-10-08 f9a477d 16,338 BA view · diff
git:20261007.a72d7842026-10-07 a72d784 16,140 BA view · diff
git:20261004.565bb622026-10-04 565bb62 15,762 BA view · diff
git:20260930.95e4a102026-09-30 95e4a10 15,706 BA view · diff
git:20260929.a8d41702026-09-29 a8d4170 15,536 BA view · diff
git:20260929.2e3097c2026-09-29 2e3097c 15,494 BA view · diff
git:20260926.a6dbaee2026-09-26 a6dbaee 15,387 BA view · diff
git:20260925.3ee19482026-09-25 3ee1948 15,217 BA view · diff
git:20260925.b279e6f2026-09-25 b279e6f 13,996 BA view · diff
git:20260925.aa6c1502026-09-25 aa6c150 14,457 BA view · diff
git:20260925.c6a64352026-09-25 c6a6435 14,398 BA view · diff
git:20260925.fd5a2c02026-09-25 fd5a2c0 14,388 BA view · diff
git:20260923.c2962452026-09-23 c296245 14,282 BA view · diff
git:20260923.55727e72026-09-23 55727e7 14,067 BA view · diff
git:20260923.b9c2ddd2026-09-23 b9c2ddd 13,876 BA view · diff
git:20260923.72795002026-09-23 7279500 13,599 BA view · diff
git:20260922.00335c52026-09-22 00335c5 13,110 BA view · diff
git:20260922.675c7f22026-09-22 675c7f2 13,526 BA view · diff
git:20260916.e780aeb2026-09-16 e780aeb 12,196 BA view · diff
git:20260915.c824d042026-09-15 c824d04 11,596 BA view · diff
git:20260915.2df9f0a2026-09-15 2df9f0a 11,980 BA view · diff
git:20260915.27306912026-09-15 2730691 11,687 BA view · diff
git:20260914.10530162026-09-14 1053016 11,380 BA view · diff
git:20260912.f7db3592026-09-12 f7db359 11,087 BA view · diff
git:20260911.6bd723f2026-09-11 6bd723f 10,136 BA view · diff
git:20260910.a49ae8d2026-09-10 a49ae8d 9,904 BA view · diff
git:20260910.9f671302026-09-10 9f67130 9,707 BA view · diff
git:20260910.cea732b2026-09-10 cea732b 9,666 BA view · diff
git:20260910.51921c02026-09-10 51921c0 9,397 BA view · diff
git:20260910.6d327e32026-09-10 6d327e3 9,638 BA view · diff
git:20260909.03e9cfd2026-09-09 03e9cfd 9,369 BA view · diff
git:20260909.6e6ba3f2026-09-09 6e6ba3f 9,279 BA view · diff
git:20260907.03335162026-09-07 0333516 9,091 BA view · diff
git:20260906.9bcb6892026-09-06 9bcb689 9,065 BA view · diff
git:20260906.c8d262a2026-09-06 c8d262a 9,036 BA view · diff
git:20260905.6a68eb02026-09-05 6a68eb0 8,991 BA view · diff
git:20260905.8031c832026-09-05 8031c83 8,611 BA view · diff
git:20260831.e8c35862026-08-31 e8c3586 3,239 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 (18081 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

superdesigndev/treg · 5,899 stars · license a license file GitHub does not identify · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_tmq6lm63i46xak3j
GET https://markdownregistry.com/api/v1/resolve?ref=superdesigndev/treg/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/45ebf52ad1ddcc9880cd97d83e7493c454009f555998f54279e0e7d1a0c7ef3f

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.

More from superdesigndev/treg

add-oauth-provider SKILL.md skill
superdesigndev/treg · .agents/skills/add-oauth-provider/SKILL.md · Add a provider to treg's OAuth registry (the ones treg holds its own approved app for). Use when asked to "add…
git:20260928.ce916f2 · audit A · 5,899 stars
code-quality SKILL.md skill
superdesigndev/treg · .agents/skills/code-quality/SKILL.md · Use when writing or reviewing code, comments, tests, or docs.
git:20261015.d4c34b8 · audit A · 5,899 stars
dev-local SKILL.md skill
superdesigndev/treg · .agents/skills/dev-local/SKILL.md · One-command local dev stack for tools-registry. Use when asked to "start the dev server", "run treg locally", "test…
git:20260928.ce916f2 · audit A · 5,899 stars
google-ads SKILL.md skill
superdesigndev/treg · .agents/skills/google-ads/SKILL.md · Traps when running Google Ads through treg — the API requirements and cleanup semantics that cost round-trips or money…
git:20260817.6541167 · audit A · 5,899 stars
google-analytics SKILL.md skill
superdesigndev/treg · .agents/skills/google-analytics/SKILL.md · Traps to avoid when querying Google Analytics 4 through treg — cases where the GA4 Data API returns a confident wrong…
git:20260723.9d1ab49 · audit A · 5,899 stars
google-search-console SKILL.md skill
superdesigndev/treg · .agents/skills/google-search-console/SKILL.md · Traps to avoid when querying Google Search Console through treg — cases where the API returns a confident wrong answer…
git:20260723.9d1ab49 · audit A · 5,899 stars
portrait-clone SKILL.md skill
superdesigndev/treg · .agents/skills/portrait-clone/SKILL.md · Turn any n reference images (with at least one person) into one exhaustively locked, always de-slopped, JSON-only AIGC…
git:20260915.e0d336d · audit B · 5,899 stars
tools-registry-context SKILL.md skill
superdesigndev/treg · .agents/skills/tools-registry-context/SKILL.md · tools-registry context + doc upkeep. Use to warm up a fresh session (orient on the architecture + recent commits) or…
git:20260928.ce916f2 · audit A · 5,899 stars
ugc-talking-head-video SKILL.md skill
superdesigndev/treg · .agents/skills/ugc-talking-head-video/SKILL.md · Turn a locked character image (from portrait-clone) into a UGC-style 9:16 talking-head video: pick a voice-reference…
git:20260915.e0d336d · audit B · 5,899 stars
vendor-listing SKILL.md skill
superdesigndev/treg · .agents/skills/vendor-listing/SKILL.md · Onboard a vendor who wants their API listed in the treg catalog. Use whenever someone asks "how do we get listed on…
git:20261019.4df5b3f · audit A · 5,899 stars
write-provider-skill SKILL.md skill
superdesigndev/treg · .agents/skills/write-provider-skill/SKILL.md · Build a treg provider skill — the endpoint map + mistake map that lets an agent do real work on a platform API through…
git:20260928.ce916f2 · audit A · 5,899 stars
CLAUDE.md CLAUDE.md file
superdesigndev/treg · CLAUDE.md
git:20260905.8031c83 · audit A · 5,899 stars

Every file in superdesigndev/treg

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261015.0e1f0bf · audit A · 352,890 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 302,424 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261011.412347a · audit A · 284,510 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 193,096 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 170,980 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261011.5d64745 · audit A · 136,966 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 129,649 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 113,780 stars

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