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/lsegal/aviary/agents-mdgit clone --depth 1 https://github.com/lsegal/aviaryWhat 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.00269 | $0.00269 |
| Opus 5 | $0.00134 | $0.00134 |
| Sonnet 5 | $0.00054 | $0.00054 |
| Haiku 4.5 | $0.00027 | $0.00027 |
Grade A, and why
aviary AGENTS.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 2d 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.
What it actually says
Developer Notes
- Don't support "legacy" code. Remove code. We don't yet care about breaking changes.
- The server is always running, so you can connect to it and test features as you develop. Don't worry about starting/stopping the server. This applies for go server, vite server, and docs vitepress server.
- Don't rebuild docs, don't rebuild the Go server. Just connect to the running server and test your changes.
- http://localhost:5173 for web frontend
- http://localhost:5174 for docs.
- Don't rebuild docs, don't rebuild the Go server. Just connect to the running server and test your changes.
- Aviary is an MCP, so you can connect to it via
go run ./cmd/aviary serveand then connect on https://localhost:16677/mcp (read ~/.config/aviary/aviary.yaml for port, ~/.config/aviary/token has the bearer token).- The server is usually already running so you should assume that it is, and just connect to it. If you need to restart it, you can do so with the above command.
- Always use the MCP to test features when developing
- Run
pnpm test:goafter any Go changes;pnpm test:e2efor web, runpnpm lintafter any changes; runpnpm testto run everything
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.
- 2d ago First seen · 12 lines · 269 tokens per session scan A 9026a31a1847
aviary AGENTS.md is an instructions file published in the GitHub repository lsegal/aviary (10 stars, last pushed 5d ago), licensed MIT. It adds 269 tokens to every session, about $0.0013 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
codex-autoresearch AGENTS.md
Instructions for TheGreenCedar/codex-autoresearch, covering agents.md, purpose and scope, canonical sources, stable product boundaries and source and package boundaries.
OwnPilot AGENTS.md
Instructions for ownpilot/OwnPilot, covering ownpilot, architecture, key patterns, commands and tech stack.
pydantic-ai-todo CLAUDE.md
Instructions for vstorm-co/pydantic-ai-todo, covering claude.md, what this project is, commands, structure and core pattern.
nightshift AGENTS.md
Instructions for orwa-mahmoud/nightshift: AI-assisted contributions are welcome. The same correctness, security, licensing, testing, and quality standards apply regardless of which tools are used.
SeekMoney-ai CLAUDE.md
Instructions for zykooooooooo/SeekMoney-ai, covering claude.md, project overview, development commands, development and production.
Agent-Worlds CLAUDE.md
Instructions for hjl2004-10/Agent-Worlds, covering ai夸父 开发规范文档 (v2.0 - skill化重构), 架构总览:概念坐标系(先看这张图), 横向:子系统(业界术语 ↔ 本项目目录), 纵向:作用域分层(每个子系统内部都按此三层) and 正交二维(横×纵 = 网格,不是树).