oh-my-agent is a harness for checking whether coding agents actually completed their work by verifying tests, required artifacts, independent reviews, and recorded decisions. It is used across multiple agent runtimes to make workflow results auditable instead of relying on an agent's own report. The catalogue add-ons provide parts of its skills, agents, hooks, MCP integrations, instructions, and plugins.
Borrowing it
Nothing to install: this file belongs to first-fluke/oh-my-agent. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/first-fluke/oh-my-agent/main/AGENTS.mdgit clone --depth 1 https://github.com/first-fluke/oh-my-agentWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/first-fluke/oh-my-agent/agents-md)<a href="https://agentmods.dev/instructions/first-fluke/oh-my-agent/agents-md"><img src="https://agentmods.dev/badge/instructions/first-fluke/oh-my-agent/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/first-fluke/oh-my-agent/agents-md"><img src="https://agentmods.dev/badge/instructions/first-fluke/oh-my-agent/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00863 | $0.00863 |
| Opus 5.5 | $0.00345 | $0.00345 |
| Sonnet 5.5 | $0.00173 | $0.00173 |
| Haiku 4.5 | $0.00086 | $0.00086 |
Grade A, and why
oh-my-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 20d 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.
How it starts
The opening of the file, as written. The whole thing — 49 lines — stays where its author put it; the contents beside it link to each section on GitHub.
oh-my-agent
Follow .agents/skills/_shared/core/execution-policy.md for authorization, clarification, verification, and completion. System/developer instructions and the user's request take precedence over OMA defaults. Never build, compile, bundle, or package software unless the user explicitly requests a build.
- SSOT: Do not modify
.agents/definitions (skills, workflows, rules, agents, config) directly. Run outputs under.agents/results/and.agents/state/are generated artifacts and may be written. - Response language: Follow
languagein.agents/oma-config.yaml. - Skills: Read the relevant
.agents/skills/{name}/SKILL.mdwhen needed. - Subagents:
- codex: Same-vendor native dispatch via Codex custom agents in
.codex/agents/{name}.toml; cross-vendor fallback viaoma agent spawn - cursor:
@agent-name(defined in.cursor/agents/) - qwen: Same-vendor native dispatch via Qwen Code subagents in
.qwen/agents/{name}.md; cross-vendor fallback viaoma agent spawn - pi: pi has no native subagent API; use
oma agent spawn {agent} {prompt} {sessionId} --vendor pifor CLI subprocess dispatch
- codex: Same-vendor native dispatch via Codex custom agents in
Per-Agent Dispatch
Resolve each agent from .agents/oma-config.cue or .agents/oma-config.yaml, overlaid by .agents/oma-config.local.cue or .agents/oma-config.local.yaml when present. With model_preset: free, always use oma agent spawn so the subprocess receives the FreeLLMAPI route; free.model replaces per-agent model pins. Otherwise, explicit agents: overrides take priority. With model_preset: auto, follow the current vendor's native agent/model settings; use default_cli only when the runtime is unknown. Use native subagents when the target matches the current runtime; otherwise, or when native dispatch is unavailable, use oma agent spawn.
Code Search
Serena MCP is required for code search and discovery. Load deferred tools before use. Use find_file for paths, search_for_pattern for content, and find_symbol / get_symbols_overview for symbols. Native search is only for paths outside this project, ignored paths, or plain non-code content. The PreToolUse guard already allows searches confined to confirmed provider exclusions or paths outside this project.
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.
- 20d ago Changed · +49 tokens per session fff19bba7b48
- 1mo ago Changed · +18 tokens per session 2ff9664e787c
- 1mo ago Changed · -100 tokens per session 61707f178795
- 1mo ago Changed · +36 tokens per session 1f5fe37ff6c9
- 1mo ago Changed · +166 tokens per session 0e558000d8a1
- 1mo ago Changed · -58 lines · -1,091 tokens per session 9ed8cb580361
- 1mo ago First seen · 107 lines · 1,785 tokens per session scan A 61aa7fc00dd5
oh-my-agent AGENTS.md is an instructions file published in the GitHub repository first-fluke/oh-my-agent (1,352 stars, last pushed today), licensed MIT. It adds 863 tokens to every session, about $0.0035 per session on Opus 5.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.
Other instructions, from other repositories
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode copilot-instructions.md
Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).
deno copilot-instructions.md
Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.