Implementations#
Tools, SDKs, and servers that implement the FAF specification.
YAML .faf files follow SPECIFICATION.md and the live human spec at faf.one/spec.
FAFb wire v2 is specified in faf-rust BINARY-FORMAT.md. The BINARY-FORMAT.md in this repo is a retired v1 pointer.
CLI#
| Package | Version | Registry | Install |
|---|---|---|---|
| faf-cli | v8.10.1 | npm · Homebrew | npm i -g faf-cli · brew install wolfe-jam/faf/faf-cli |
npx faf-cli auto writes or refreshes project.faf. faf compile emits a .fafb via the WASM kernel. Live totals: faf.one/downloads.
MCP Servers#
| Package | Platform | Registry | Install |
|---|---|---|---|
| claude-faf-mcp | Anthropic | npm | npm i -g claude-faf-mcp |
| faf-mcp | Universal | npm | npm i -g faf-mcp |
| grok-faf-mcp | xAI | npm | npm i -g grok-faf-mcp |
| gemini-faf-mcp | PyPI | pip install gemini-faf-mcp | |
| rust-faf-mcp | Rust, any MCP client | crates.io · npm | cargo install rust-faf-mcp |
| MCPaaS | Infrastructure | SaaS | mcpaas.live |
Memory and agent cards#
| Package | Version | Formats | Registry | Install |
|---|---|---|---|---|
| faf-cli | v8.10.1 | .fafm (faf memory), .fafa (faf cards reads agent.fafa) | npm | npm i -g faf-cli |
| claude-fafm-sdk | 2.2.0 | .fafm (knowledge profile) | PyPI | pip install claude-fafm-sdk |
| grok-faf-voice | 0.6.0 | .fafm (voice profile; reads knowledge too) | PyPI | pip install grok-faf-voice |
| faf-agent-mcp | 0.1.4 | .fafa (publishes its own agent.fafa) | PyPI | pip install faf-agent-mcp |
Compilers & Runtimes#
The brick is FAFb v2. These emit or read that layout:
| Component | Language | Output | Link |
|---|---|---|---|
| faf-fafb | Rust | FAFb v2 brick | crates.io · faf-rust |
| faf-cli | TypeScript + WASM | faf compile via faf-scoring-kernel | npm |
| faf-wasm-sdk | Rust→WASM | same v2 engine | crates.io |
| faf-rust-sdk | Rust | facade over kernel + faf-fafb | crates.io |
v1 ROMs (numeric section types, version_major = 1) are not this format. A v2 reader rejects them. Recompile from .faf.
Browser#
AI Interop#
faf-cli authors the instruction files from one project.faf:
| Format | Platform | Command |
|---|---|---|
AGENTS.md | Codex, Cursor, Goose, OpenCode, Warp and others | faf export --agents |
GEMINI.md | Google Gemini | faf export --gemini |
.cursorrules | Cursor | faf export --cursor |
CLAUDE.md | Anthropic Claude | faf sync |
.github/copilot-instructions.md | GitHub Copilot | faf export --copilot |
| All of the above | — | faf export --all |
Try it#
- In the browser: devtools.faf.one
- Any public GitHub repo, no install:
npx faf-cli git https://github.com/facebook/react(writes./project.fafwith the tech slots filled) - Your own project:
npx faf-cli init, thennpx faf-cli gofor the goal and six W’s
Find more#
Add Your Implementation#
Built something that reads or writes .faf files? Open a PR to add it here.