HN Showcase
Back to browse
GitHub Repository

Persistent Project Context for Claude — IANA-registered .faf format · 32 tools + 1 prompt · MCP Registry #2759

17 starsJavaScript

I got tired of syncing Claude/Gemini/AGENTS.md and .cursorrules

by wolfejam·Feb 27, 2026·2 points·11 comments
Visit ProjectView on HN

AI Analysis

●●SolidSolve My ProblemBig Brain

IANA-registered .faf format with bi-sync, but only solves for power-users juggling 4+ tools.

Strengths
  • •Single source of truth (project.faf) syncs to CLAUDE.md, .cursorrules, AGENTS.md, GEMINI.md automatically
  • •61 MCP tools + 351 tests + IANA media-type registration shows genuine depth and polish
  • •Anthropic MCP approval and Chrome extension distribution indicates real adoption pathway
Weaknesses
  • •Only relevant to developers actively maintaining separate configs across 4+ AI tools — tiny TAM
  • •Assumes all tools support identical context needs; format translation complexity hidden in 'bundled parsers'
  • •Risk that Anthropic or competitors bake this directly into their platforms, obsoleting it overnight
Target Audience

Engineers using multiple AI coding tools simultaneously and wasting time on config sync

Similar To

Anthropic MCP servers · Cursor configuration management

Post Description

I use Claude, Codex, Cursor, and Gemini on different projects. Each one has its' own md file in its own format. CLAUDE.md, AGENTS.md, .cursorrules, GEMINI.md. Four files saying roughly the same thing, four chances to get out of sync!

I kept forgetting to update one, then wondering why Cursor was hallucinating my project structure while Claude had it right.

So I built an MCP server that reads a single YAML file (project.faf) and generates all four formats. 7 bundled parsers handle the differences between them. You edit one file, and bi-sync keeps everything current.

It's an MCP server, so Claude Desktop can use it directly. 61 tools, 351 tests, no CLI dependency.

Try it: npx claude-faf-mcp

Source: https://github.com/Wolfe-Jam/claude-faf-mcp

The .faf format itself is IANA-registered (application/vnd.faf+yaml).

Curious if others are dealing with this multi-AI config problem, or if there's a simpler approach I'm not seeing.

Similar Projects