Faf CLI

faf-cli
CONTEXT, versioned.

The context every AI coding agent reads — authored from your repo, never guessed.

One .faf file → AGENTS.md · CLAUDE.md · GEMINI.md · .cursorrules,
detected from your real stack, scored, and versioned with your code. No drift. No re-explaining.

 · across npm, PyPI and crates.io · IANA-registered · Anthropic-merged (#2759)

⭐ Star it on GitHub: bookmarks it for you, helps other devs find it too.

FAF defines. AGENTS.md instructs. AI codes.
Every building requires a foundation. FAF is AI's foundational layer.
You have a package.json. AI needs you to add a project.faf. Done.

Git-Native. project.faf versions with your code — every clone, every fork, every checkout gets full AI context.
No setup, no drift, no re-explaining.

Install
faf with no arguments shows your project's score; faf auto detects and fills.

Quick Start

Nelly Never Forgets

Run faf with no arguments:
faf-cli dogfoods itself — project.faf is source DNA; CLAUDE.md and GEMINI.md are authored from it via faf. AGENTS.md is the BETTER ops briefing (hand-kept for agents; faf export --agents still authors AGENTS.md for other repos).

Commands

Run faf --help for the full command set and options.

Memory (.fafm) — new in 7.2.0

Portable agent memory in the IANA-registered .fafm format. Same INTEROP as claude-fafm-sdk 1.0.

What's New in v8.7.0 — The Receipts Edition

Your Test Receipts, in your terminal: faf taf receipts shows them, taf setup writes the recipe for JavaScript (Jest, Vitest, Bun), Python and Go, and every test run on your default branch gets one, red ones too.

A Test Receipt is one line of proof that your tests ran: when, the result, passed/total. faf-taf-git appends one to .taf on a taf-receipts branch for every CI run, so the record stays in git after the CI logs…