Borrowing it
Nothing to install: this file belongs to ForkPoint/agent-lighthouse. 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/ForkPoint/agent-lighthouse/main/AGENTS.mdgit clone --depth 1 https://github.com/ForkPoint/agent-lighthouseWrote 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/forkpoint/agent-lighthouse/agents-md)<a href="https://agentmods.dev/instructions/forkpoint/agent-lighthouse/agents-md"><img src="https://agentmods.dev/badge/instructions/forkpoint/agent-lighthouse/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/forkpoint/agent-lighthouse/agents-md"><img src="https://agentmods.dev/badge/instructions/forkpoint/agent-lighthouse/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.03844 | $0.03844 |
| Opus 5.5 | $0.01538 | $0.01538 |
| Sonnet 5.5 | $0.00769 | $0.00769 |
| Haiku 4.5 | $0.00384 | $0.00384 |
Grade C, and why
agent-lighthouse AGENTS.md scanned grade C with 1 finding 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 12d 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.
Hidden instructionshighPrompt injection
Directives inside HTML comments, invisible characters or bidirectional overrides are read by the model and not by the person reviewing the file.
line that counts a different set with `<!-- registry-ignore -->`. Do not How it starts
The opening of the file, as written. The whole thing — 279 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Working in this repository
Agent Lighthouse scans a website and reports whether AI agents can discover, read, cite and act on it. This file is the contributor guide for anyone — human or agent — changing the code.
One rule sits above the rest, and everything below is a consequence of it:
An audit may only claim what a source documents. If no vendor documents a consumer, the check does not affect a site's score. Ever.
Layout
| Package | What it is |
|---|---|
packages/core |
The audit registry, the scan orchestrator, the gatherer layer. Everything else consumes it. |
packages/cli |
npx @forkpoint/agent-lighthouse <url> |
packages/report |
Terminal, HTML, JSON and Markdown renderers |
packages/mcp |
MCP server exposing a scan as a tool |
packages/server |
Task server: runs scans as tasks and streams progress over SSE (agent-lighthouse serve) |
packages/website |
The Astro site, built from the registry and docs/evidence/ at build time |
Audits live in packages/core/src/audits/<category>/<slug>.ts, one of eight
categories: access-crawl-control, agent-interfaces, agentic-commerce,
answer-readiness, content-extraction, machine-discovery,
operability-safety, structured-data. An audit's id is category/slug,
capped at 64 characters by packages/core/src/schemas.ts.
Central audit index
Start with docs/evidence/audit-map.json for audit discovery. Its readingGuide
explains each field. Select audits[] by exact ID or feature tag instead of loading
all dossiers. The index includes purpose, feature tags, current page-type scope,
evidence requirements, scoring metadata and source/test/dossier paths, all read
from audit metadata. docs/evidence/audit-map.md has field definitions and jq
examples. Read the source and dossier before changing behavior. Regenerate with
pnpm build:audit-map; CI runs pnpm check:audit-map to reject stale output.
Do not hand-edit generated active records.
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.
- 12d ago Changed fd9ba92d7fcc
- 14d ago Changed · +16 lines · +249 tokens per session scan A → C b27e41425705
- 15d ago Changed · -2 lines · +3 tokens per session f202b65672ae
- 17d ago Changed · +3 lines · +80 tokens per session 2a35480af517
- 18d ago Changed · +1 lines · +27 tokens per session 3423e606089d
- 20d ago Changed · -2 lines · +4 tokens per session 6ff3b033ce18
- 26d ago Changed · +59 lines · +1,000 tokens per session abf34d3d2017
- 1mo ago Changed · +15 lines · +226 tokens per session f14cf5101254
- 2mo ago Changed · +26 lines · +452 tokens per session d884ed330d7c
- 2mo ago First seen · 163 lines · 1,803 tokens per session scan A 16f85880350b
agent-lighthouse AGENTS.md is an instructions file published in the GitHub repository ForkPoint/agent-lighthouse (17 stars, last pushed yesterday), licensed Apache-2.0. It adds 3,844 tokens to every session, about $0.0154 per session on Opus 5.5. A static security scan graded it C with 1 finding (hidden instructions). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
agent-lighthouse AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| agent-lighthouse AGENTS.mdForkPoint/agent-lighthouse | Instructions file | 17 | yesterday | Apache-2.0 | C | 3,844 | Codex, OpenCode |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | yesterday | MIT | A | 7,461 | Codex, OpenCode |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | yesterday | MIT | A | 4,680 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 5,516 | GitHub Copilot |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 274k | 2d ago | MIT | A | 4,313 | Codex, OpenCode |