FAF Foundation

Stewards of the Foundational AI-context Format

IANA-registered · Universal AI-Context for any AI, human, or team

IANA Registered MCP #2759 Chrome Approved 50K+ Downloads

"It's so logical if it didn't exist, AI would have built it itself."

"Should become the standard."
— Claude Code, Sep 18 (42 days later → IANA Registered Oct 30, 2025)

Latest News

RESEARCH Apr 2026

85% Voice AI Cost Breakthrough

FAF-Voice V2.0 reduces voice AI costs from $1.48 to $0.23 per episode. Championship test suite validates sustainable business model.

Try RadioFAF → Read research →

LAUNCH Mar 2026

MCPaaS SDK Shipped

npm install mcpaas — typed TypeScript client for AI context at the edge. Zero deps.

View on npm → mcpaas.live →

RECOGNITION Mar 2026

FAF is Awesome (x4)

Merged into 4 awesome-lists. In Rust We Trust — FAF goes all-in on Rust, Zig, and WASM compilers.

Why FAF Exists

The context problem that every developer faces

Modern development chaos - React, Node, AWS, Claude, Git, Dependencies, Errors, Stress - unified by .faf Project DNA for ANY AI

AI Tools Don't Share Context

Claude doesn't know what you told Gemini. Cursor doesn't know your ChatGPT history. Every tool starts from zero.

You Re-Explain Everything

Stack, conventions, architecture, rules. Every session. Every tool. The same context, typed again and again.

Context Drift is Silent

CLAUDE.md says one thing. Your team's mental model says another. No single source of truth.

The Solution

One format. Every AI. Authored once, works everywhere.

Before

29%

context understood

→

After .faf

99%

context understood

Setup time: 20+ minutes → under 3 seconds

"package.json wasn't built for this, .faf was."

"package.json gives me a list of dependencies, .faf shows me how to use them."
— .faf Inventor + Claude Code

How It Works

.faf sits at the center. Bidirectional conversion to any format.

CLAUDE.md

↔

.faf

↔

GEMINI.md

↕

conductor/

Your project DNA travels with you regardless of which AI you use.

project.faf file sitting alongside package.json and README.md in a project directory

project.faf sits alongside package.json and README.md

"Every project should have one."

— OpenAI Codex CLI (9/10)

Compatible With

Claude Gemini Grok Codex GitHub Cursor Chrome

Before .faf

Skills
Ephemeral

Projects
Session-scoped

MCP
Connection-only

Subagents
Isolated

No Foundation
Components floating independently. Context reinvented per session.

After .faf

Skills
Loads .faf

Projects
Serializes .faf

MCP
Returns .faf

Subagents
Shares .faf

.faf Format Foundation
IANA-Registered Persistent Universal

The Format

YAML-based project DNA that any AI can read

project.faf

faf: 3.0
name: my-project
description: AI-ready project DNA

stack:
  language: typescript
  framework: next.js
  runtime: node 20

conventions:
  - strict TypeScript
  - server components first
  - Tailwind for styling

ai_context:
  priority: performance
  avoid: any types

The 50/50 Philosophy

Half technical (YAML for AI), half human-focused (markdown for you). Balance by design.

01 Human-Readable

YAML format that developers can read and write. No special tooling required.

02 AI-Optimized

Structured data that AI systems parse instantly. No guessing, no hallucination.

03 Version-Controlled

Lives in your repo. Changes tracked with git. Team context always in sync.

Full Specification

"README evolution for AI era."
— Google Gemini CLI (9.5/10)

Adoption

Official implementations and ecosystem reach

Official Implementations

MCP

claude-faf-mcp

Anthropic MCP #2759

MCP

grok-faf-mcp

First MCP for xAI Grok

MCP

gemini-faf-mcp

Google Gemini MCP (PyPI)

CLI

faf-cli

21,000+ downloads

SDK

mcpaas

MCPaaS SDK — typed TypeScript client

EXT

Chrome Extension

Google approved

By the Numbers

50K+

Downloads

Packages

MCP Servers

Registries

Compilers

1,232

Tests passing

721

Namepoints

300+

Edge locations

.faf is a config file — developers use it, they don't announce it. Downloads are the signal.

Validation

1,232

Tests passing (faf-cli)

9.3/10

Average rating

<50ms

Processing time

Gold-Code*

100% AI-optimized, persistent project context. Full context. Zero drift. Best code possible.

Using FAF? Let us know to be featured here.

Our Mission

To steward FAF as an open, vendor-neutral standard that enables any AI to understand any project.

Open Standard

FAF is and will always be an open standard. The specification is MIT-licensed, allowing anyone to implement, extend, and build upon it without restriction.

Vendor Neutral

Works with Claude, GPT, Grok, Gemini, and any future AI. No lock-in, no proprietary extensions that fragment the ecosystem.

Community Driven

Evolution of the format is guided by real-world usage from developers, AI companies, and tool makers who use FAF daily.

Add FAF to Your Tool

Three paths to FAF integration

Read .faf Files

Parse project.faf to understand project context. Standard YAML - use any parser.

import yaml

with open('project.faf') as f:
    context = yaml.safe_load(f)

# Your AI now knows:
# - Project stack
# - Coding conventions
# - AI-specific instructions

Generate .faf Files

Analyze a codebase and output project.faf. Auto-detect stack, frameworks, patterns.

# Use faf-cli for reference
npx faf-cli init

# Or build your own detector
# following the FAF spec schema

Export to Formats

Convert .faf to platform-specific formats: CLAUDE.md, GEMINI.md, conductor/, etc.

# Export examples
faf claude export  # → CLAUDE.md
faf gemini export  # → GEMINI.md
faf cursor export  # → .cursorrules

Building an AI tool? We want to help.

Contact for Integration Support

Who It's For

One format, many use cases

For Developers

Write your project DNA once. Export to CLAUDE.md, GEMINI.md, or any format. Zero drift across sessions.

For AI Tools

Add FAF support to your product. IANA-registered format with official SDKs in TypeScript, Python, and Rust.

For Teams

Version-controlled project context. Onboard new devs instantly. Consistent AI interactions across your org.

Resources

Official SDKs, specifications, and tools

📄 Format Specification

The official FAF specification document with examples and validation rules.

Read Specification →

📚 Academic Whitepaper

Peer-citable research paper on CERN/Zenodo. DOI: 10.5281/zenodo.18251362

Read on Zenodo →

📰 Press Release

Overview of FAF format, the problem it solves, and adoption status.

Read Press Release →

🦀 Rust SDK

High-performance Rust implementation. Owns "ai-context" keyword on crates.io.

View on crates.io →

🐍 Python SDK

Full-featured Python implementation with validation. Published on PyPI.

View on PyPI →

📦 TypeScript SDK

Official TypeScript/JavaScript implementation via FAF CLI.

View on npm →

🔧 Claude MCP Server

Official MCP server for Claude Desktop integration. Anthropic MCP #2759.

View on npm →

🚀 Grok MCP Server

First MCP server for xAI Grok. Published on npm.

View on npm →

💎 Gemini MCP Server

MCP server for Google Gemini. Published on PyPI.

View on PyPI →

⚡ MCPaaS

MCP as a Service — The Endpoint for Context. Zig-WASM powered, 300+ edges.

Visit mcpaas.live →

💻 CLI Tool

Command-line interface for creating and validating FAF files.

Visit fafcli.dev →

Ecosystem

16 packages across 3 registries — all open source

Star faf-cli on GitHub

The CLI that started it all

MCP Servers

claude-faf-mcp npm

Anthropic MCP #2759

grok-faf-mcp npm

First MCP for xAI Grok

gemini-faf-mcp PyPI

Google Gemini MCP

faf-mcp npm

Core FAF MCP server

WJTTC npm

MCP server certification

CLI & SDKs

faf-cli npm + Homebrew

Universal CLI — 21,000+ downloads

mcpaas npm

MCPaaS SDK — typed TypeScript client

faf-rust-sdk crates.io

Rust SDK — owns "ai-context" keyword

faf-python-sdk PyPI

Python SDK with validation

Infrastructure

MCPaaS Cloudflare

MCP as a Service — 300+ edges, 721 namepoints

faf-wasm-sdk npm

Browser WASM runtime — 281KB

xai-faf-zig WASM

Mk4 Zig scoring engine — 3.9KB

xai-faf-rust Rust

FAFb compiler + Mk4 engine

~41.5K

npm

~8.2K

PyPI

~460

crates.io

Full breakdown on faf.one/downloads →

Governance

How the Foundation operates

Open Governance

Transparent, community-driven, and focused on long-term sustainability. Decisions are made in the open, on GitHub, with input from the community.

Key governance areas:

Specification evolution and versioning
Official SDK maintenance
IANA registration stewardship
Community standards and best practices
Enterprise licensing guidance

Licensing

The FAF specification and reference implementations are MIT-licensed, providing maximum flexibility for adoption.

Enterprise options available for organizations requiring:

Priority support and SLAs
Custom integrations
Training and consultation
Roadmap influence

How Changes Happen

Suggest

Open issue or discussion

→

Discuss

Community feedback

→

Implement

PR and review

→

Release

Version bump

All major decisions go through github.com/Wolfe-Jam/faf

Milestones

Key moments in FAF history

Aug 08 2025

First .faf Created

The very first .faf file was created in fafdev.tools.

Sep 2025

Format Created

FAF specification v1.0 published. Initial TypeScript implementation.

Oct 17 2025

Anthropic MCP

FAF MCP server approved and merged into Anthropic's official MCP ecosystem.

Oct 2025

IANA Registration

application/vnd.faf+yaml registered with IANA. Official MIME type established.

Nov 2025

First MCP for Grok/xAI LIVE

grok-faf-mcp published — first Model Context Protocol server for xAI Grok.

Jan 14 2026

20,000 Downloads

FAF ecosystem surpasses 20,000 npm downloads across faf-cli, claude-faf-mcp, faf-mcp, and grok-faf-mcp.

Jan 14 2026

Academic Whitepaper Published DOI

Peer-citable research paper published on Zenodo. Repository used by NASA, NIH, and major universities.

Jan 15 2026

MCPaaS™ USPTO Filing TM

MCPaaS trademark filed with USPTO (Serial No. 99596802). The Endpoint for Context.

Feb 7 2026

Browser WASM Runtime

faf-wasm-sdk published. Parse and score .faf files in the browser — no server needed.

Feb 21 2026

RadioFAF LIVE

radiofaf.com launches. "Don't follow. Tune in." — the consumer face of FAF.

Feb 24 2026

AGENTS.md Interop v4.5.0

faf-cli and claude-faf-mcp v4.5.0. Define once in .faf, export to CLAUDE.md, AGENTS.md, .cursorrules, GEMINI.md.

Feb 27 2026

30,000 Downloads

Milestone reached across npm, PyPI, and crates.io.

Mar 2026

MCPaaS SDK Shipped

npm install mcpaas — typed TypeScript client for the MCPaaS platform. Zero deps.

Mar 2026

Bun Migration

faf-cli migrates to Bun. 1,232 tests, 0 skip, 0 fail. Jest removed.

Apr 2026

50,000 Downloads NEW

16 packages across npm, PyPI, and crates.io. 5 MCP servers registered.

Founding Sponsors

Building the foundation together

The FAF Foundation is in formation.

We're seeking founding sponsors who believe in open AI context standards. Early supporters shape the roadmap and get prominent recognition as the foundation grows.

Become a Founding Sponsor Join the Discussion

50K+

Downloads

IANA

Registered

Platforms

FAF Foundation

Latest News

85% Voice AI Cost Breakthrough

MCPaaS SDK Shipped

FAF is Awesome (x4)

From the Blog

Why FAF Exists

AI Tools Don't Share Context

You Re-Explain Everything

Context Drift is Silent

How It Works

Before .faf

After .faf

The Format

01 Human-Readable

02 AI-Optimized

03 Version-Controlled

Adoption

Official Implementations

By the Numbers

Validation

Our Mission

Open Standard

Vendor Neutral

Community Driven

Add FAF to Your Tool

Read .faf Files

Generate .faf Files

Export to Formats

Who It's For

For Developers

For AI Tools

For Teams

Resources

📄 Format Specification

📚 Academic Whitepaper

📰 Press Release

🦀 Rust SDK

🐍 Python SDK

📦 TypeScript SDK

🔧 Claude MCP Server

🚀 Grok MCP Server

💎 Gemini MCP Server

⚡ MCPaaS

💻 CLI Tool

Ecosystem

MCP Servers

CLI & SDKs

Infrastructure

Governance

Open Governance

Licensing

How Changes Happen

Roadmap

2026 Priorities

How to Influence

Contribute

Milestones

First .faf Created

Format Created

Anthropic MCP

IANA Registration

First MCP for Grok/xAI LIVE

20,000 Downloads

Academic Whitepaper Published DOI

MCPaaS™ USPTO Filing TM

Browser WASM Runtime

RadioFAF LIVE

AGENTS.md Interop v4.5.0

30,000 Downloads

MCPaaS SDK Shipped

Bun Migration

50,000 Downloads NEW

Founding Sponsors

Join the Foundation

Building in Public