Home / canonry / canonry · GitHub

AGENTS.md@packages/canonry/src/agentA

AGENTS.md@packages/canonry/src/agent from canonry/canonry is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add canonry/canonry/packages/canonry/src/agent/AGENTS.md@git:20261105.20ec7e4

Pins git:20261105.20ec7e4 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
canonry/canonry
Path
packages/canonry/src/agent/AGENTS.md
Versions recorded
26
Latest version
git:20261105.20ec7e4, committed Nov 5, 2026
First version recorded
Sep 19, 2026
Size
40,051 bytes
Repository stars
199
License
MIT

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

# Aero (built-in agent)

The SEO view context resolves its selected profile through the public stored overview. Keep provider estimates separate from observed Search Console and AI citation/mention evidence. Profile writes, paid refresh/cancel and private operator receipt tools are excluded from Aero.

Canonry ships a built-in AI agent called **Aero**, built on
[`@earendil-works/pi-agent-core`](https://github.com/earendil-works/pi). Users
who already have their own agent (Claude Code, Codex, custom) can still
consume Canonry through the external-agent webhook.

## Built-in agent (native loop)

- **CLI**: `canonry agent ask <project> "<prompt>"` — one-shot turn. Streams
  `AgentEvent` lines to stdout (or JSON with `--format json`). Supports
  `--provider claude|openai|gemini|zai|openrouter` and `--model <id>`. `zai` is
  agent-only. Every provider resolves its models from pi-ai's catalog (for
  OpenRouter, a live one: see "Model tiers and upgrades") and
  authenticates with that vendor's own key (a proxied deployment can route
  Gemini through `GEMINI_BASE_URL` or Z.ai through `ZAI_BASE_URL`). The `deepinfra` provider was removed:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add canonry/canonry/packages/canonry/src/agent/AGENTS.md@sha256:1d1ad90e40df88ed

The line at the top of this page pins the label git:20261105.20ec7e4, 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_yqsqvkfydumxfzki.svg)](https://markdownregistry.com/a/art_yqsqvkfydumxfzki)

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

Versions

The registry has recorded 26 versions of this file, between Sep 19, 2026 and Nov 5, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20261105.20ec7e4 latest2026-11-05 20ec7e4 40,051 BA view · diff
git:20261029.a9c88612026-10-29 a9c8861 39,396 BA view · diff
git:20261024.522ff052026-10-24 522ff05 39,115 BA view · diff
git:20261024.d05c2c62026-10-24 d05c2c6 38,961 BA view · diff
git:20261022.e27d5bf2026-10-22 e27d5bf 38,682 BA view · diff
git:20261017.9f06b9b2026-10-17 9f06b9b 34,563 BA view · diff
git:20261013.213af7f2026-10-13 213af7f 33,924 BA view · diff
git:20261008.b8858fd2026-10-08 b8858fd 33,893 BA view · diff
git:20261008.6f387d82026-10-08 6f387d8 32,964 BA view · diff
git:20261007.0860f292026-10-07 0860f29 30,608 BA view · diff
git:20261006.9ddd0d52026-10-06 9ddd0d5 30,171 BA view · diff
git:20261001.39d2b042026-10-01 39d2b04 29,626 BA view · diff
git:20261001.408113d2026-10-01 408113d 28,828 BA view · diff
git:20260929.b5129302026-09-29 b512930 28,949 BA view · diff
git:20260929.0417a852026-09-29 0417a85 28,041 BA view · diff
git:20260928.927559d2026-09-28 927559d 27,730 BA view · diff
git:20260928.54ba11c2026-09-28 54ba11c 27,485 BA view · diff
git:20260928.a613f812026-09-28 a613f81 27,171 BA view · diff
git:20260924.38f48092026-09-24 38f4809 25,336 BA view · diff
git:20260923.f41fd9c2026-09-23 f41fd9c 25,038 BA view · diff
git:20260923.fbd3ec62026-09-23 fbd3ec6 24,294 BA view · diff
git:20260923.3cbbec12026-09-23 3cbbec1 23,827 BA view · diff
git:20260922.d2370872026-09-22 d237087 22,988 BA view · diff
git:20260922.f55491f2026-09-22 f55491f 22,394 BA view · diff
git:20260921.1697bee2026-09-21 1697bee 20,800 BA view · diff
git:20260919.46b60a62026-09-19 46b60a6 15,492 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 (40051 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

canonry/canonry · 199 stars · license MIT · pushed 2026-11-08 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_yqsqvkfydumxfzki
GET https://markdownregistry.com/api/v1/resolve?ref=canonry/canonry/packages/canonry/src/agent/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/1d1ad90e40df88ed45609d8f27896257703f527e50aa6830734eef701b48c65c

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 canonry/canonry

test-audit SKILL.md skill
canonry/canonry · .agents/skills/test-audit/SKILL.md · Invoke whenever writing, changing, reviewing, running, or sweeping Canonry tests. Authoring gate for new tests plus…
git:20261015.3a14a05 · audit A · 199 stars
AGENTS.md AGENTS.md file
canonry/canonry · AGENTS.md
git:20261101.8b16fda · audit A · 199 stars
DESIGN.md DESIGN.md file
canonry/canonry · DESIGN.md
git:20261102.cd516b0 · audit A · 199 stars
AGENTS.md@apps/api AGENTS.md file
canonry/canonry · apps/api/AGENTS.md
git:20261007.254a7fb · audit A · 199 stars
AGENTS.md@apps/mcp-gateway AGENTS.md file
canonry/canonry · apps/mcp-gateway/AGENTS.md
git:20261101.29f3cd5 · audit A · 199 stars
AGENTS.md@apps/web AGENTS.md file
canonry/canonry · apps/web/AGENTS.md
git:20261107.f5d4612 · audit A · 199 stars
AGENTS.md@apps/worker AGENTS.md file
canonry/canonry · apps/worker/AGENTS.md
git:20261015.c8ecbd8 · audit A · 199 stars
AGENTS.md@packages/api-client-generated AGENTS.md file
canonry/canonry · packages/api-client-generated/AGENTS.md
git:20261020.3ca6ab5 · audit A · 199 stars
AGENTS.md@packages/api-routes AGENTS.md file
canonry/canonry · packages/api-routes/AGENTS.md
git:20261108.bd245fd · audit A · 199 stars
AGENTS.md@packages/api-routes/src/discovery AGENTS.md file
canonry/canonry · packages/api-routes/src/discovery/AGENTS.md
git:20261007.254a7fb · audit A · 199 stars
AGENTS.md@packages/api-routes/src/doctor AGENTS.md file
canonry/canonry · packages/api-routes/src/doctor/AGENTS.md
git:20261026.bc41644 · audit A · 199 stars
AGENTS.md@packages/canonry AGENTS.md file
canonry/canonry · packages/canonry/AGENTS.md
git:20261108.bd245fd · audit B · 199 stars

Every file in canonry/canonry

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