faf-cli — The Copilot Edition

Persistent AI Context Standard

Persistent Project Context for AI.

Define once. Run anywhere.

FAF defines. MD instructs. AI codes.

project/
├── package.json     ← npm reads this
├── project.faf      ← AI reads this
├── README.md        ← humans read this
└── src/

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

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

faf is shorthand for faf-cli auto — same behavior, fewer keystrokes.

Nelly Never Forgets

Run faf with no arguments:

faf

v6.15 — The Copilot Edition

FAF now writes the file GitHub Copilot reads.

faf export --copilot     # → .github/copilot-instructions.md (every Copilot surface reads it)
faf git owner/repo       # instant scored .faf from any GitHub repo (now injection-hardened)

faf export --copilot emits GitHub Copilot's repository-wide instruction file — the widest-surface one, read by default across web chat, code review, VS Code, JetBrains, the CLI, and the coding agent. faf git is now hardened against URL command injection (no-shell execFileSync + a strict allowlist). Shipped with an exemplary WJTTC Git suite that adopts the full five tiers — BRAKE · ENGINE · AERO · TYRE · PIT.

v6.14 — The Loop Edition

faf loop drives any repo to 🏆 100% or the honest human wall — sourcing every slot it can with provenance, asking only what only you know, never inventing.

faf loop    # init → auto → score, then ask only the human-only gaps

The loop sources what detection can, then stops at one of three honest terminals: done (🏆 100%), needs-human (it asks only the slots only you can answer), or stuck (it sourced everything sourceable and nothing's left for a human to add). It never fabricates a slot to reach 100% — sourced 6Ws now carry provenance ({value, source, confidence}), so every seeded value is a confirm-or-edit suggestion, never an auto-confirmed guess.

v6.13 — The Dart Edition

faf now understands Dart and Flutter projects. Content-aware pubspec.yaml classification — Flutter app vs reusable package · Dart server (Serverpod / Dart Frog / Shelf) / CLI / MCP — pure Dart stays Dart. The single-source engine faf-python-sdk and the MCPs compose, parity-tested across languages.

faf

Popularity

What's Inside

README

faf-cli — The Copilot Edition

Install

Nelly Never Forgets

v6.15 — The Copilot Edition

v6.14 — The Loop Edition

v6.13 — The Dart Edition

Confidence

Similar Plugins

claude-leverage

ai-native-toolkit

ai-workflow

aide

autonomous-dev

claudio

More by Wolfe-Jam

faf

faf

faf-memory