Borrowing it
Nothing to install: this file belongs to ammnt/angie. 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/ammnt/angie/main/AGENTS.mdgit clone --depth 1 https://github.com/ammnt/angieWrote 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/ammnt/angie/agents-md)<a href="https://agentmods.dev/instructions/ammnt/angie/agents-md"><img src="https://agentmods.dev/badge/instructions/ammnt/angie/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/ammnt/angie/agents-md"><img src="https://agentmods.dev/badge/instructions/ammnt/angie/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.01444 | $0.01444 |
| Opus 5.5 | $0.00578 | $0.00578 |
| Sonnet 5.5 | $0.00289 | $0.00289 |
| Haiku 4.5 | $0.00144 | $0.00144 |
Grade B, and why
angie AGENTS.md scanned grade B 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 2mo 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.
Asks for rootmediumPrivilege escalation
A mod that escalates privileges can change anything on the machine, not only the project.
USER root # Never run as root How it starts
The opening of the file, as written. The whole thing — 185 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md — AI Agent Instructions for Distroless Angie
🎯 Project Overview
Production-ready, security-hardened ANGIE image built from scratch with HTTP/3, QUIC, ECH, and PQC support.
- Base: Scratch (distroless)
- Builder: Alpine Linux (multi-stage)
- Compiler: Clang with
-fhardenedflags - User: 10001:10001 (rootless by design)
- Registry: ghcr.io/ammnt/angie, Docker Hub: ammnt/angie
🏗️ Build System
Key Technologies
- BuildKit with Docker Buildx for multi-stage builds
- Static compilation — no dynamic linking to system libraries
- Mint for image slimming (post-build optimization)
- UPX for binary compression (with careful exclusions)
- Cosign for signing and attestation
Build Arguments (from .env)
BASE_VERSION # Alpine base version
BASE_HASH # Alpine image digest
OPENSSL_VERSION # OpenSSL version
APP_VERSION # Angie version
VCS_REF # Git commit SHA
BUILD_DATE # Build timestamp
Critical Build Constraints
- ❌ NEVER add shell/package manager to final image
- ❌ NEVER add NJS module (security: libxml2/libxslt vulns)
- ❌ NEVER change user from 10001:10001
- ❌ NEVER add ENTRYPOINT scripts (only CMD)
- ✅ MUST compile with
-fhardenedflags - ✅ MUST strip binaries after compilation
- ✅ MUST include HEALTHCHECK
- ✅ MUST support TLS 1.3, QUIC, HTTP/3, ECH, PQC
📁 File Structure Conventions
Dockerfile.template
- Multi-stage:
builder(Alpine) →final(scratch) - Build phases: deps → build → strip → final
- Static linking with musl
- No unnecessary layers (chain RUN commands)
ANGIE Configuration
angie.conf— main configurationdefault.conf— default server blockexample.conf— reference for HTTP/3, ECH, PQC- Listen on 8080 (HTTP) and 8443 (HTTPS) by default
Security Scanning Matrix
- Hadolint → Dockerfile linting
- Trivy/Grype/Snyk/Clair → Vulnerability scanning
- Dockle → CIS benchmark validation
- Syft → SBOM generation (CycloneDX)
- Scout → Docker official scanning
- CodeQL → SAST analysis (separate workflow)
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.
- 2mo ago First seen · 185 lines · 1,444 tokens per session scan B ddb9b7a3fef7
angie AGENTS.md is an instructions file published in the GitHub repository ammnt/angie (13 stars, last pushed 4d ago), licensed BSD-2-Clause. It adds 1,444 tokens to every session, about $0.0058 per session on Opus 5.5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
angie AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| angie AGENTS.mdammnt/angie | Instructions file | 13 | 4d ago | BSD-2-Clause | B | 1,444 | 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 |