faf-cli

The package.json for AI Context

[](https://github.com/Wolfe-Jam/faf-taf-git) [](https://github.com/Wolfe-Jam/faf-cli/actions/workflows/ci.yml) [](https://www.npmjs.com/package/faf-cli) [](https://www.npmjs.com/package/faf-cli) [](https://github.com/Wolfe-Jam/homebrew-faf) [](https://faf.one) [](https://opensource.org/licenses/MIT) [](https://bun.sh) [](https://github.com/Wolfe-Jam/faf)

project/
├── package.json     ← npm reads this
├── project.faf      ← AI reads this
└── src/

**Every building requires a foundation. `project.faf` is AI's foundation.**

You have a `package.json`. 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

bunx faf-cli auto                  # Bun — zero install, fastest path
npx faf-cli auto                   # npm — works everywhere
brew install faf-cli && faf auto   # Homebrew

---

Nelly Never Forgets

Run `faf` with no arguments:

---

v6.0 — Built with Bun

v6 is a ground-up rewrite. All-in on Bun — same toolchain as Claude Code.

	Claude Code	faf-cli v6
Runtime	Bun	Bun (bunx)
Test	Bun	bun test
Build	Bun	bun build
Language	TypeScript	TypeScript
Compile	Bun bytecode	bun build --compile

312 tests in ~10s. 290KB bundle in 2.4s. Single portable binary, 4 platforms. npx backward-compatible.

26 commands. 312 tests. 5,292 lines. 93% smaller than v5.

commands → interop → core → wasm

The WASM scoring kernel (`faf-scoring-kernel` 2.0.0) does the math. Bun does the delivery.

---

Commands

#	Command	One-liner
1	faf init	Create .faf from your local project
2	faf git	Instant .faf from any GitHub repo — no clone

...