V6 FAF New Era - The Standard for AI Context

faf-cli v6.0.10 — MCP Detection + Format 3.0

The biggest v6 release yet. MCP server detection, Python/Rust support, and format version 3.0.

MCP Server Detection

10 MCP frameworks architected. Your MCP server gets the right type, backend, and framework sub-type automatically:

#	Framework	Language	Projects
1	@modelcontextprotocol/sdk	TypeScript	claude-faf-mcp, grok-faf-mcp, faf-mcp
2	fastmcp	Python	gemini-faf-mcp (70% of MCP servers)
3	mcp (Python SDK)	Python	Official Anthropic SDK
4	rmcp	Rust	rust-faf-mcp
5-7	mcp-go, MCP .NET, FastMCP (TS)	Go, C#, TS	Signals ready

Real-World Results

Server	Before	After
claude-faf-mcp	44% cli	59% mcp
grok-faf-mcp	44% cli	59% mcp
gemini-faf-mcp	33% library	41% mcp

Also in This Release

• Format version 3.0 — all generated .faf files use faf_version: "3.0"
• Next.js over React — meta-frameworks supersede their base
• Python dep detection — FastAPI, Django, Flask, SQLAlchemy from pyproject.toml
• Cargo.toml dep detection — rmcp and Rust deps
• Project name from manifests — pyproject.toml and Cargo.toml, not folder name
• Sync never overwrites CLAUDE.md — stamps meta tag, preserves content
• Pre-commit lint hook — errors never reach CI

Numbers

• 375/375 tests — 27 new MCP WJTTC tests
• 95 KB package — 6 files
• 41 test files — 0 failures
• IANA registered — application/vnd.faf+yaml

Install

bunx faf-cli auto          # Bun
npx faf-cli auto           # npm
brew upgrade faf-cli       # Homebrew

---

FAF defines. AI consumes. 🏎️

v5.2.0 — FAFb WASM + Mk4 Renames + Tri-sync Topics

What's New

FAFb Compile/Decompile

• faf compile and faf decompile now live in the CLI
• Powered by faf-scoring-kernel (WASM) — no external binary needed
• .faf → .fafb binary compilation, .fafb → .faf decompilation

Mk4 Slot Renames (6)

• frontend→framework, css_framework→css, state_management→state
• api_type→api, database→db, package_manager→pkg_manager
• Full backward compatibility — 36k+ existing .faf files score identically
• WASM kernel bridge translates Mk4→old names for Rust kernel compat

Tri-sync Topic Files

• Claude Code native memory format with proper frontmatter
• 6 topic types: project, stack, context, preferences, key_files, state
• faf ram export and faf bi-sync --ram write topic files

Tests

• 1184/1184 passing (up from 1143)
• 52 test suites
• 21 new WJTTC Mk4 rename tests across 7 tiers
• 20 new topic writer tests
• FAFb verified with both old and Mk4 name sets

v5.1.0 — The FAFb Edition

The FAFb Edition

faf compile turns your .faf into a .fafb binary — CRC32 sealed, deterministic, portable. Same compiler that runs in the browser (322KB WASM) now runs from the CLI. YAML is source code. FAFb is the compiled output.

What's New

• faf compile — .faf → .fafb binary via WASM kernel (no external binary needed)
• faf decompile — .fafb → JSON inspection
• Mk4 Slot Renames — 6 canonical names aligned with Mk4 engine (full backward compat)
• Tri-sync Topic Files — Claude Code native memory format (6 topic types)
• README restructured — 684 → 164 lines, content moved to docs/

Numbers

• 1,184/1,184 tests passing (52 suites)
• v5.1.0 — from 5.0.6
• 855KB package size

Install

bunx faf-cli compile              # Bun
npx faf-cli compile               # npm
brew upgrade faf-cli && faf compile  # Homebrew

Links

• Blog: The Compiler is the Spec
• npm
• CHANGELOG

v5.0.6 — Bun Compiled Binaries

faf-cli v5.0.6 — Standalone Binaries

Zero runtime dependencies. One download, it works.

What's New

• bun build --compile produces standalone faf-cli binaries
• Same pattern as Claude Code — single executable, no Node/Bun required
• All Top 6 commands verified: init, git, auto, go, bi-sync, score
• 1,143/1,143 tests passing

Binaries

Platform	File	Size
macOS (Apple Silicon)	faf-darwin-arm64	60MB
macOS (Intel)	faf-darwin-x64	66MB
Linux (x64)	faf-linux-x64	102MB
Windows (x64)	faf-windows-x64.exe	113MB

Usage

# Download for your platform, then:
chmod +x faf-darwin-arm64   # macOS/Linux only
./faf-darwin-arm64 auto     # Run any faf command

Still Available

• npm install -g faf-cli (npm)
• brew install wolfe-jam/faf/faf-cli (Homebrew)
• bunx faf-cli auto (zero install)

Built with Bun 1.3.5. MIT License.

v5.0.1 - The RAM Edition

v5.0.1

Changed

• README rewritten for v5.0.0 RAM Edition — added 3Ws/6Ws teaching, tri-sync section, sync comparison table, blog link
• Core commands table updated with tri-sync, ram, pro
• 6Ws sections reordered to canonical order (WHO, WHAT, WHY, WHERE, WHEN, HOW)
• Added grok-faf-mcp and gemini-faf-mcp to Ecosystem and CLI vs MCP table
• Three AI platforms, one format

Blog post: https://faf.one/blog/ram-edition

v4.3.0 - GH API Truth + Slot-Ignore Fixes

• New function: extractFromLanguages() in faf-git-generator.ts

• Slot-Ignore System Fixed - Scoring now works correctly

  • Corrected formula: (filled + ignored) / 21 * 100
  • Fixed: Slots are 'slotignored' only when truly non-applicable to project type
  • Previously: Everything undetected was marked 'slotignored' (inflated scores)
  • Now: Accurate scoring that reflects what's actually filled vs ignored
  • New utility: src/utils/slot-counter.ts

• Clean Output Format - No synthetic scores, just honest status

  • Shows "No .faf file" instead of synthetic baseline score
  • Clear transformation: None → AI-ready with complete context
  • Defensible, provable, honest

📈 Results

Universal language support (achieved):

• React (JavaScript): 100% 🏆 Trophy
• Vue (JavaScript): 100% 🏆 Trophy
• Next.js (Full-stack): 100% 🏆 Trophy
• whisper.cpp (C++): 100% 🏆 Trophy
• Works across ALL languages and ecosystems

📚 Documentation

• README - Added project.faf screenshot showing file in context
  • Visual explainer: "just another file helping you code"
  • Positioned near top for immediate understanding
  • Shows project.faf alongside package.json and README.md

🎯 Positioning

FAF GIT is the killer feature:

• Primary workflow: npx faf-cli git <url> (no install needed)
• Pro workflow: npm install -g faf-cli then faf git <url>
• Works on ANY public GitHub repo
• 2 seconds to AI-ready context
• No cloning, no setup, just instant results

[4.2.2] - 2026-02-08 — Context Quality Edition 🎯

🎯 Slot-Ignore System (Documentation)

The perfect way to handle app-types - Now properly documented.

✨ What's New

• Slot-ignore mechanism - Comprehensive documentation added
  • Full specification in docs/SLOT-IGNORE.md
  • Quick reference in docs/SLOT-IGNORE-QUICK-REF.md
  • Like .gitignore for files, slot-ignore for context slots
  • Formula: (Filled + Ignored) / 21 = 100%

✨ Improvements

• 6 Ws extraction - Transformed human context extraction
  • WHO: Checks package.json author first (TIER 1 authoritative)
  • WHAT: package.json description now TIER 1 (was TIER 2)
  • WHY: Targets Mission sections, uses keywords as fallback
  • WHERE: npm packages → "npm registry + GitHub" (authoritative)

v4.1.0 — Gemini Native Handshake

🔷 Zero-Config Google AI Integration

FAF now auto-detects Gemini CLI and creates native bridges automatically.

✨ What's New

• --gemini flag - Explicit Gemini CLI integration
• Auto-detection - Detects Gemini CLI even without flag
  • Checks: gemini command, ~/.gemini, GEMINI_API_KEY, gcloud
• Native bridge - Creates .gemini/context.yaml pointing to project.faf
• Symlink - .gemini/project.faf → project.faf for direct access
• gemini: section - Added to project.faf with integration config

🎯 The Native Handshake

Every faf init is now Gemini-aware. If Gemini CLI is installed, FAF automatically:

1. Detects the installation
2. Creates .gemini/ directory
3. Writes context bridge config
4. Links to project.faf

Zero config. Native integration. Just works.

---

npm install -g faf-cli@4.1.0
# or
brew upgrade faf-cli

v3.4.8 - BI-SYNC 2.0: Context Intelligence

See CHANGELOG.md for details

v3.4.4

What's New

Boris-Flow - 12/12 integration tests for publish readiness. Championship-grade validation.

faf demo sync - Live bi-sync demonstration. Show your team how .faf <-> CLAUDE.md sync works.

See CHANGELOG.md for full details.

v3.4.3

[3.4.3] - 2026-01-07

Added

• Boris-Flow Integration Tests - 12-test suite for publish readiness validation
  • Version check, init, auto, score, non-TTY safety
  • Full Claude Code structure detection
  • ./tests/boris-flow.test.sh - run before any publish
• boris-ready.sh - Quick pre-publish verification script
• Turbo-cat Improvements - Enhanced format discovery and tests

Changed

• Sync command improvements for better reliability
• Compiler updates for more accurate scoring
• Removed deprecated Discord release workflow

---

Full Changelog: https://github.com/Wolfe-Jam/faf-cli/blob/main/CHANGELOG.md