Skip to main content

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#

PackageVersionRegistryInstall
faf-cliv8.10.1npm · Homebrewnpm 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#

PackagePlatformRegistryInstall
claude-faf-mcpAnthropicnpmnpm i -g claude-faf-mcp
faf-mcpUniversalnpmnpm i -g faf-mcp
grok-faf-mcpxAInpmnpm i -g grok-faf-mcp
gemini-faf-mcpGooglePyPIpip install gemini-faf-mcp
rust-faf-mcpRust, any MCP clientcrates.io · npmcargo install rust-faf-mcp
MCPaaSInfrastructureSaaSmcpaas.live

Memory and agent cards#

PackageVersionFormatsRegistryInstall
faf-cliv8.10.1.fafm (faf memory), .fafa (faf cards reads agent.fafa)npmnpm i -g faf-cli
claude-fafm-sdk2.2.0.fafm (knowledge profile)PyPIpip install claude-fafm-sdk
grok-faf-voice0.6.0.fafm (voice profile; reads knowledge too)PyPIpip install grok-faf-voice
faf-agent-mcp0.1.4.fafa (publishes its own agent.fafa)PyPIpip install faf-agent-mcp

Compilers & Runtimes#

The brick is FAFb v2. These emit or read that layout:

ComponentLanguageOutputLink
faf-fafbRustFAFb v2 brickcrates.io · faf-rust
faf-cliTypeScript + WASMfaf compile via faf-scoring-kernelnpm
faf-wasm-sdkRust→WASMsame v2 enginecrates.io
faf-rust-sdkRustfacade over kernel + faf-fafbcrates.io

v1 ROMs (numeric section types, version_major = 1) are not this format. A v2 reader rejects them. Recompile from .faf.

Browser#

ToolPlatformLink
FAF Chrome ExtensionChrome Web StoreInstall
faf.oneWebfaf.one

AI Interop#

faf-cli authors the instruction files from one project.faf:

FormatPlatformCommand
AGENTS.mdCodex, Cursor, Goose, OpenCode, Warp and othersfaf export --agents
GEMINI.mdGoogle Geminifaf export --gemini
.cursorrulesCursorfaf export --cursor
CLAUDE.mdAnthropic Claudefaf sync
.github/copilot-instructions.mdGitHub Copilotfaf 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.faf with the tech slots filled)
  • Your own project: npx faf-cli init, then npx faf-cli go for 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.