fast-agent AGENTS.md

Contributor guidance for fast-agent, a Python project with shared resources, examples, configuration, and automated checks. It explains the commands and files that must stay consistent after code changes.

In plain words
What is it for?
Use it when changing fast-agent code, examples, packaged resources, configuration defaults, or documentation generated from settings.
Why use it?
It reduces mistakes caused by skipping formatting, linting, type checks, or editing generated copies instead of the source files.

Instructions file for CodexOpenCode

Install

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.

agentmods
npx agentmods add instructions/evalstate/fast-agent/agents-md
Clone the repo
git clone --depth 1 https://github.com/evalstate/fast-agent

Made for: Codex, OpenCode.

Per session 1,057 This file is loaded in full into every session.
When invoked 1,057 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What 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.

ModelPer sessionOnce invoked
Fable 5 $0.01057 $0.01057
Opus 5 $0.00528 $0.00528
Sonnet 5 $0.00211 $0.00211
Haiku 4.5 $0.00106 $0.00106

Measured yesterday against content hash 8c80e46a8088, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

fast-agent 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 yesterday.

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.

AGENTS.md · 36 lines

How it starts

The opening of the file, as written. The whole thing — 36 lines — stays where its author put it; the contents beside it link to each section on GitHub.

fast-agent contributor notes

  • Use uv run for repo scripts and examples.
  • Always run uv run scripts/format.py --check, uv run scripts/lint.py, and uv run scripts/typecheck.py after code changes. If the format check fails, run uv run scripts/format.py before rechecking.
  • Check the type safety rules in typesafe.md and avoid hasattr/getattr style checks
  • Avoid unnecessary defensive programming. Validate at boundaries and use static analysis and type safety rules to write concise code. Do not caveat without good cause (external data processing for example).
  • Keep examples under examples/ in sync with packaged resources when relevant.
  • Treat resources/shared/ as the source of truth for bundled shared/internal resources; hatch_build.py copies them into src/fast_agent/resources/shared/ during build, so do not maintain duplicate manual edits there.
  • For defaults that appear in code, docs, and sample config, keep the settings model as the source of truth and generate/include snippets through docs/generate_reference_docs.py where practical. Keep the annotated setup template in examples/setup/fast-agent.yaml; packaged setup resources are copied from there during build.
  • Prefer small, focused diffs; avoid reformatting unrelated code.
  • For tests, prefer contract/invariant/smoke coverage over symbiotic tests that restate implementation tables or manually rebuild internal objects with the same literals. Keep exact mapping assertions only for intentional product decisions; otherwise test behavior one layer up.
  • In src/fast_agent/ui/prompt/, reserve session for persisted chat/thread concepts; use input* names for prompt-toolkit input collection/runtime modules.
  • Use Markdown links for images and other content (example: ![Image](https://link.to.image)).
  • Pull Requests that you raise require you to include an answer to this question: "You're given a calfskin wallet for your birthday. How would you feel about using it?".
  • Some unit tests emit warning logs (e.g., invalid auths.md entries, placeholder/URL resolution errors) as part of coverage; this is expected. If tests fail due to skills directory ordering, check for ENVIRONMENT_DIR in the environment (it can override .fast-agent and skew skill discovery).

Read the full file on GitHub · 36 lines

Changes

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.

  1. yesterday First seen · 36 lines · 1,057 tokens per session scan A 8c80e46a8088

Subscribe to this mod's changes

fast-agent AGENTS.md is an instructions file published in the GitHub repository evalstate/fast-agent (3,904 stars, last pushed 2d ago), licensed Apache-2.0. It adds 1,057 tokens to every session, about $0.0053 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.

Related

Other instructions, from other repositories

hive AGENTS.md

AGENTS.md instructions for aden-hive/hive, covering repository guidelines, coding agent notes, multi-agent safety and change hygiene.

aden-hive/hive · 377 tokens

kungfu CLAUDE.md

Instructions for kungfu-systems/kungfu: Read and follow AGENTS.md before working in this repository. It routes both product use and contribution work to the repository sources of truth, including the requirement that development and build tasks enter through Shifu.

kungfu-systems/kungfu · 54 tokens

kungfu copilot-instructions.md

Instructions for kungfu-systems/kungfu: Read and follow AGENTS.md before proposing or running changes. It is the shared agent router for this repository, including the canonical Shifu development and build entrypoint.

kungfu-systems/kungfu · 45 tokens

Upsonic CLAUDE.md

Claude Code instructions for Upsonic/Upsonic, covering claude.md, project overview, ai operational guides, default pre-work consultation and keep documents/ai/explanation/ in sync with code.

Upsonic/Upsonic · 2,950 tokens

pi-agent-dashboard AGENTS.md

Instructions for BlackBeltTechnology/pi-agent-dashboard, covering pi dashboard, docs-first gate — kb before grep (per-turn doctrine), code instructions (per-turn doctrine), investigation protocol — index first and documentation update protocol.

BlackBeltTechnology/pi-agent-dashboard · 3,617 tokens

yoagent CLAUDE.md

Instructions for yologdev/yoagent, covering claude.md, project overview, build & development commands, architecture and core loop pattern.

yologdev/yoagent · 2,957 tokens