Docs menu

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:

  1. Detects which coding agents you have
  2. Creates or continues a named session
  3. Starts its MCP server on a local port
  4. Writes its MCP config into each detected agent that supports it, and a short pointer block into each agent's rules file
  5. 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

PORTABLE

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.

LOCAL

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.

AGENT-AGNOSTIC

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

On fathym.com: fAI →

On this page