# Faf Ide

> Use FAF context and IDE interop tools on this server — score, sync, platform formats; claim equals wire.

- Skill: `wolfe-jam-faf-mcp/faf-ide` (Agent Skill)
- Install (CLI): `npx skillmds add wolfe-jam-faf-mcp/faf-ide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wolfe-jam-faf-mcp/faf-ide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Wolfe-Jam (https://skillmd.com/u/wolfe-jam-faf-mcp)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/wolfe-jam-faf-mcp/faf-ide

---


# faf-ide

Product playbook for **faf-mcp** (`one.faf/faf-mcp`) — IANA `.faf` project context over MCP for Cursor, VS Code, Windsurf, Cline-class hosts.

**Transport:** local stdio (`npx` / `bunx faf-mcp`). Skills guide; tools act.

## Tools (call these)

| Tool | When |
|------|------|
| `faf_auto` | Zero → context in one shot (init, detect, sync, score) |
| `faf_init` | Create or enhance `project.faf` |
| `faf_score` | AI-readiness 0–100% + gaps |
| `faf_context` | Current project context snapshot |
| `faf_sync` | Sync `project.faf` ↔ human-readable guide |
| `faf_bi_sync` | Bi-directional context ↔ IDE format files |
| `faf_cursor` | Cursor / `.cursorrules` interop |
| `faf_agents` | `AGENTS.md` interop |
| `faf_gemini` | Gemini context interop |
| `faf_about` | What `.faf` is (format overview) |

Default `tools/list` is a curated Core set; more tools may exist when `FAF_TOOLS=all`. Only call tools this server lists.

## Rules

1. Prefer **structured `.faf`** over free-form chat memory for project facts.
2. **Claim equals wire** — only tools advertised by this server.
3. **No secrets** in skill text or tool args you do not own.
4. **Origin** — served by faf-mcp (`skills/*` + `resources/read`); not a remote install authority.

## Flow

```text
initialize → skills/list → resources/read(skill://faf-ide/SKILL.md) → tools/call
```