NEW The New Era Edition Every tool says what it does ›

Your project,
known to Gemini.

A Gemini CLI extension and MCP server that also works in Google Antigravity. With it, Gemini starts every session knowing your project: the stack, the goal and who it's for, from your IANA-registered project.faf.

Install the extension Read the docs
gemini 
> /faf:setup
  ✓ created project.faf — starter, scored

> fill it in from this repo
  faf_auto · package.json, pyproject.toml,
  docker-compose, Makefile …
  ✓ filled the empty slots — facts from your files

> /faf:score
  score 100%  tier Trophy ✪
  slots 33 of 33 (populated or slotignored)

> /faf:export
  ✓ GEMINI.md + AGENTS.md — your own text kept

Get started in three steps

Works in Gemini CLI and Google Antigravity. Runs on Python through uvx.

1

Install the extension

One command adds the MCP server and the /faf commands to Gemini CLI.

2

Create your project.faf

Writes a starter file and scores it. Then ask Gemini to fill it in from your repo.

3

Check the score

See what's filled and what's missing, then take it to 100%.

Using another MCP client? Run uvx gemini-faf-mcp, or pip install gemini-faf-mcp.

Works in Google Antigravity

Antigravity reads one MCP config file, and it takes both modes. Read how it works ›

~/.gemini/config/mcp_config.json · local
{
  "mcpServers": {
    "gemini-faf": { "command": "uvx", "args": ["gemini-faf-mcp"] }
  }
}
~/.gemini/config/mcp_config.json · hosted
{
  "mcpServers": {
    "gemini-faf": { "serverUrl": "https://mcpaas.live/gemini/mcp/v1" }
  }
}

Antigravity expects serverUrl, not url or httpUrl.

Thirteen tools. You can see what each one does.

Reading tools never touch your files. Writing tools say so.

Read only
faf_readfaf_validatefaf_scorefaf_discover faf_contextfaf_stringifyfaf_modelfaf_about
Write without losing anything
faf_initfaf_autofaf_geminifaf_agents
Rewrites the file
faf_migrate

faf_init never overwrites. faf_auto fills empty slots only. faf_gemini and faf_agents update their own section of GEMINI.md and AGENTS.md and keep the rest. faf_migrate re-saves the file, so YAML comments are not kept.

100%Trophy

One score, everywhere

Always-33: every app is scored on the same 33 slots, the same number faf-cli gives. Slots that don't apply are marked slotignored, so they still count. Trophy ✪ = 100%: AI is optimized to code.

Stop re-explaining your project

.faf is read once at session start. Every prompt lands on a Gemini that already knows your project.

without FAF
You:    I'm using FastAPI with PostgreSQL,
        pytest, and…
Gemini: Got it. What's the codebase like?
You:    It's a REST API for…
        [5 minutes of re-explaining]
with FAF
You:    Add a /users/me endpoint
Gemini: [writes the code with your auth
         pattern and your test style]

Open. Checkable.

Every surface is public.

PyPIgemini-faf-mcp MCP Registryone.faf/gemini-faf-mcp Gemini CLI extensiongemini-extension.json IANA-registered formatapplication/vnd.faf+yaml Source · MITWolfe-Jam/gemini-faf-mcp

Your @handle is your namepoint on MCPaaS™. You're here, you're early.

Get yours
Share
Copied