Learn what .faf format is

Quick explanation of .faf format

Check if project has project.faf

Calculate AI-readiness score (0-100%)

Re-ground on the live .faf — re-read + re-score the current project DNA, report drift vs your last-known score, and return the fresh context. The explicit re-grounding primitive for long sessions: drift → refresh → re-grounded. Built for Grok, by request.

Reload the latest structured memory (.fafm) for one or more souls into the current session. Returns a stamped delta by default (added/updated facts since last refresh or a given timestamp). Use verbatim: true to receive the full current .fafm content instead. Read-only. Always returns a content hash + timestamp stamp. Complements recall, load_soul, and etch — does not replace them.

Heavy orchestrator — given current substrate state, returns a structured recommendation about drift: which refresh to call (or no_action), why, how severe, and the underlying signals. ADVISORY ONLY — never auto-fires. Composes the full 1.5 substrate (drift detection · contradiction check · repeat-offender · take-a-hint · refresh history). Writes a recommendation receipt on every call (auditable trail, no silent decisions). Read-only WRT substrate state.

Introspect the effective orchestration policy WITHOUT running the orchestrator. Returns { tier, thresholds, source, overrides_applied } — what aggressiveness tier the next faf_orchestrate_recommendation call would use, and whether it came from defaults or a .faf:orchestration: override. No drift detection, no signals, no receipt — pure introspection. Read-only.

Baked-in two-intensity refresh (Cmd+R / Cmd+Shift+R analog). Fires BOTH refresh_faf + refresh_fafm in one call. mode: "blend" (default) = light .faf + delta .fafm — the everyday re-ground. mode: "nuke" = light .faf + verbatim .fafm — the hard reload for polluted session memory. Intensity matches drift rate per layer.

Create project.faf for a project

Validate project.faf integrity

Sync .faf with CLAUDE.md

Enhance .faf with AI optimization

Bi-directional sync between project.faf and CLAUDE.md. v4.5.0: Also sync to AGENTS.md, .cursorrules, GEMINI.md!

Clear caches, temporary files, and reset FAF state for a fresh start

Debug grok-faf-mcp environment - show working directory, permissions, and FAF CLI status

Read a file within the project root (cwd / FAF_ALLOWED_ROOTS). Paths that escape the project are refused.

Write a file within the project root (cwd / FAF_ALLOWED_ROOTS). Paths that escape the project are refused.

List directories and discover projects with project.faf files - Essential for FAF discovery workflow

Friday features — Chrome Extension detection, fuzzy matching

FAF MCP usage guide for Claude Desktop - Projects convention, path resolution, and UX patterns

Ask a question with RAG-enhanced context from xAI Collections. Uses LAZY-RAG cache for 100,000x speedup on repeated queries.

Get LAZY-RAG cache statistics - hits, misses, hit rate, cache size

Clear the LAZY-RAG cache to start fresh