WHAT fAI IS
What is fAI?
fAI is a per-project MCP server that connects your coding agents to shared tools,
prompts and session context. You run fai in a project and leave it running.
While it runs, it:
- Detects which coding agents you have
- Creates or continues a named session
- Starts its MCP server on a local port
- Writes its MCP config into each detected agent that supports it, and a short pointer block into each agent's rules file
- Reads your agents' logs as you work, and captures them into the session
Then you open your agent the way you always do. The conversation happens there, not in fAI.
CORE IDEA
What fAI is, and isn't
fAI keeps a record of how you work and a synthesis of it, in plain files you can open, diff and delete. Every agent it detects is pointed at the synthesis, so each session builds on the last, and switching tools doesn't mean starting over.
Not a coding agent. It doesn't host your conversation, choose your framework or write your code. Your agent does that, with fAI's context in front of it.
Three things that make it yours
Travels with you
Your context lives in fAI's files, not inside one tool. Work in Claude Code, then open Cursor or Codex in the same project: each one is pointed at the same files.
Plain files, real git
Everything sits under ~/.fai/ on your machine as git repositories. Open it, diff it, push it to a remote you control, or delete it. Usage analytics are separate - see Privacy and Telemetry.
Works with the agent you use
fAI works with 15 coding agents: CLI tools, IDEs and extensions. Install another one it supports, and the next time you run fai, it detects it.
What fAI keeps
Three files, kept current as fAI synthesizes your work:
- FAI-SESSION.md - what you're working on now
- FAI-PROJECT.md - this project's decisions, patterns, context and vocabulary
- FAI-PERSONAL.md - how you work, across every project
How they're built, and why they compound: How fAI builds compounding intelligence.
THE SCALE JOURNEY
Where fAI sits
fAI is your personal workbench (YOU^AI). When your team's workbenches come together, that's OpenX, the workshop (TEAM^AI). Same architecture, personal scale.
Next steps
- → Get started - install, run, and work in your agent
- → Commands - what you actually type
- → How fAI builds compounding intelligence - the record, the synthesis, and what the next session gets
- → Examples - what it looks like on real work
- → Privacy and Telemetry - what fAI sends, and how to turn it off
On fathym.com: fAI →