faf-cli

The CLI

v8.1.0

Detects your stack, fills project.faf, scores context, authors AGENTS.md / CLAUDE.md / GEMINI.md from one source.

  • Stack and format detection
  • Raw project files to structured context
  • Core loop: init, auto, go
  • Bi-sync and tri-sync, no drift
  • Bun-native, strict TypeScript
npm install -g faf-cli
brew install wolfe-jam/faf/faf-cli

FAF Specification

The standard

IANA

The .faf format specification. IANA-registered, IETF Internet-Draft, Zenodo papers.

  • 3 IANA media types: .faf, .fafm, .fafa
  • IETF Internet-Draft active
  • Zenodo papers published
  • Open, community-contributable

claude-faf-mcp

Anthropic-merged (#2759)

v7.0.1

MCP server for Claude Desktop and Claude Code. Loads project.faf context every session.

  • In the official Anthropic MCP registry
  • Loads project.faf context
  • 2,052+ downloads / month
  • stdio and Streamable HTTP
npx claude-faf-mcp

faf-mcp

Cursor, IDEs, VS Code

v4.0.0

The FAF MCP server for IDEs. Works with any MCP-compatible AI client.

  • Cursor, Windsurf, VS Code
  • Standard MCP protocol
  • 2,989+ downloads / month
  • In the official MCP registry
npx faf-mcp

grok-faf-mcp

xAI Grok

v2.0.0

Persistent project context for xAI Grok. MCP server on a URL.

  • Built for xAI Grok
  • MCP server on a URL
  • In the official MCP registry
  • IANA-registered .faf format
npx grok-faf-mcp

gemini-faf-mcp

Google Gemini

PyPI

Persistent project context for Google Gemini. MCP server plus a Cloud Run REST API.

  • Built for Google Gemini
  • Unifies CLAUDE.md, GEMINI.md, AGENTS.md
  • IANA-registered .faf format
  • Published on PyPI
pip install gemini-faf-mcp

rust-faf-mcp

Rust MCP clients

crates.io

MCP server for .faf built in Rust with the rmcp SDK.

  • Rust plus the rmcp SDK
  • MCP tools for .faf operations
  • IANA-registered .faf format
  • Published on crates.io
cargo install rust-faf-mcp

faf-agent-mcp

Voice of FAF

PyPI

FAF Agent, the Voice of FAF. MCP server and a live A2A peer.

  • MCP server (uvx / PyPI)
  • Live A2A peer, protocol 1.0
  • Discoverable from the Agent Card
  • Listed on the A2A partners page
uvx faf-agent-mcp

faf-python-sdk

Python SDK

PyPI

Parse, validate, and score .faf files in Python. The foundation for Python FAF tools.

  • Parse, validate, score .faf
  • Foundation for Python FAF tools
  • IANA-registered .faf format
  • Published on PyPI
pip install faf-python-sdk

faf-rust-sdk

Rust SDK

crates.io

The facade over faf-kernel (parse, validate, score) plus the FAFb binary format.

  • Parse, validate, score .faf
  • FAFb binary format (v2)
  • IANA-registered .faf format
  • Published on crates.io
cargo add faf-rust-sdk

faf-wasm-sdk

Browser and edge

npm

Persistent project context in the browser. IANA-registered .faf format, WASM runtime.

  • Runs in the browser and at the edge
  • WASM runtime for .faf scoring
  • IANA-registered .faf format
  • Published on npm
npm i faf-wasm-sdk

claude-fafm-sdk

Portable memory

PyPI

Portable, cross-vendor AI memory in .fafm. Offline-first, your file, your soul.

  • .fafm Permanent Memory Layer
  • Cross-vendor and offline-first
  • IANA-registered .fafm format
  • Published on PyPI
pip install claude-fafm-sdk

faf-plugins

Claude Code marketplace

Marketplace

The FAF Foundation plugin marketplace for Claude Code. The faf and faf-memory plugins.

  • One-command install via /plugin
  • faf: persistent project context
  • faf-memory: Permanent Memory Layer
  • Wraps the FAF MCP servers

WJTTC

MCP test certification

v1.4.1

Championship-grade test certification for MCP servers. Pass WJTTC, ship with receipts.

  • MCP test suite plus a GitHub Action
  • In the official MCP registry
  • Homebrew installable
  • Beacon tests
npx wjttc

FAF Dev Tools

Browser authoring

Beta

Browser-based .faf context authoring. No install. The first FAF engine.

  • Zero install, runs in the browser
  • Drag-and-drop interface
  • Authors .faf in the browser
  • The Mk1 engine

Chrome Extension

Browser integration

Live

Author .faf context directly from your browser. Approved by Google.

  • One-click context extraction
  • Works on any GitHub repo
  • Copy context to clipboard
  • Approved by Google, live in the Web Store

faf.one

The format authority

Live

The official FAF format authority. Docs, blog, downloads, format examples.

  • Complete documentation
  • Format examples
  • Live download counter
  • The canonical home for .faf

By the numbers

Live npm downloads and versions. Built Oct 4, 2026.

13,881+
npm downloads, last 30 days
17
tools in this list
3
IANA media types
100%
open source

Get started

Developers

Install the CLI and initialize your project.

npm install -g faf-cli
faf init

Claude users

Run the MCP server for Claude Desktop.

npx claude-faf-mcp

Try it first

Score any public GitHub repo. No install.

Try FAF