.FAF Context
Writes AGENTS.md, CLAUDE.md and .cursorrules from one project.faf file, locally
- Pricing
- Open source
- Platforms
- CLI, vscode, self-hosted
- Runs
- Locally
- Version
- 4.2.0
- Listing updated
- 3 days ago
About .FAF Context
.FAF Context is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
FAF keeps a project's context in a single YAML file, project.faf, and generates each tool's own file from it: AGENTS.md, .cursorrules, GEMINI.md and CLAUDE.md. Each is scored so you can see where the context is thin. This server runs locally over stdio on the same faf-cli the terminal uses.
Version 4.2.0 changed who fills in the human slots: faf_go shows each suggested goal or answer with its source, such as the README or package.json, and only what you confirm is written. faf_init and faf_auto leave them empty and report how many suggestions wait, so a new file scores honestly low. faf_write refuses to overwrite existing context files without overwrite: true and never touches the .faf-dna birth certificate.
The project is MIT-licensed and the media type is registered with IANA.
Install
Run in a terminal
claude mcp add faf-mcp -- npx -y faf-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"faf-mcp": {
"command": "npx",
"args": [
"-y",
"faf-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"faf-mcp": {
"command": "npx",
"args": [
"-y",
"faf-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"faf-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"faf-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"faf-mcp": {
"command": "npx",
"args": [
"-y",
"faf-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"faf-mcp": {
"command": "npx",
"args": [
"-y",
"faf-mcp"
]
}
}
}Tools this server provides (11)
Taken from the project documentation; the running server may differ.
- faf_go
- Offers sourced suggestions for goal and answers; writes only confirmed ones.
- faf_init
- Creates a new project.faf.
- faf_auto
- Automatic setup leaving human slots empty.
- faf_readme
- Suggests README content without writing.
- faf_sync
- Updates name and stack from package.json.
- faf_claude
- Writes CLAUDE.md and chained files.
- faf_write
- Writes files with overwrite guards.
- faf_dna
- Handles the birth certificate.
- faf_git
- Writes the goal from the GitHub description.
- faf_doctor
- Explains why context is incomplete.
- faf_score
- Shows what is missing.
What it does
- One source file
- project.faf drives every tool's context file.
- Confirm before writing
- Suggested goals are shown with sources; only confirmed ones are saved.
- Context scoring
- Scores show what is missing.
- Overwrite guards
- Existing files need explicit overwrite.
- Local stdio
- Runs on your machine via npm.
Good for
- Keep CLAUDE.md and .cursorrules in sync
- Bootstrap context for a new repo
- Find gaps in project context
- Give an editor's AI a project summary
Pricing
Open source
Prices change. Check faf.one before you buy.
.FAF Context FAQ
Which files does it generate?
AGENTS.md, .cursorrules, GEMINI.md and CLAUDE.md.
Does the AI write my project goal?
Not since 4.2.0; suggestions are shown and only your confirmed answers are written.
How do I install it?
npm package faf-mcp, stdio.
Licence?
MIT.
Is .FAF Context free?
Yes. .FAF Context is open source, so you can use and self-host it for free.
How do I add .FAF Context to Claude Code?
Run this command in your terminal: claude mcp add faf-mcp -- npx -y faf-mcp
What are the best alternatives to .FAF Context?
The closest alternatives to .FAF Context are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to .FAF Context

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools