@faff/create/README.md

FAF format creator - MCP Anthropic approved, Chrome Extension Google approved - F1-inspired engineering, championship-grade testing

# @faff/create

**Create and configure FAF projects with one command**

Meta-installer for the FAF ecosystem - get started with FAF in seconds.

![FAF Logo](https://cdn.jsdelivr.net/npm/@faff/create@latest/assets/orange-smiley.svg)

---

## Quick Start

```bash
npm create faff@latest
```

Or using npx:

```bash
npx @faff/create
```

---

## What is FAF?

**FAF (.faf)** is the universal format that brings **Project DNA** to ANY AI in <50ms.

From Claude to OpenAI Codex to Gemini, from CLI to MCP to Chrome Extension, FAF makes AI understand your project instantly.

---

## What This Installer Does

Interactive CLI that helps you install:

- **FAF CLI** - Universal AI context generator (5,100+ downloads)
- **Claude FAF MCP** - Claude Desktop integration (3,600+ downloads, official Anthropic)
- **Both** - Complete FAF ecosystem
- **Info** - Learn about FAF before installing

---

## Available Packages

### faf-cli
Universal command-line tool for generating .faf files for any project.

```bash
npm install -g faf-cli
faf init
faf auto
faf score
```

### claude-faf-mcp
Official MCP server for Claude Desktop (approved and merged into Anthropic MCP registry).

```bash
npx -y claude-faf-mcp
```

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "faf": {
      "command": "npx",
      "args": ["-y", "claude-faf-mcp"]
    }
  }
}
```

---

## Features

- Interactive installation flow
- Automatic package detection
- Clear next-step instructions
- Championship-grade UX
- F1-inspired performance

---

## The @faff Organization

This is the official package from the [@faff npm organization](https://npmjs.com/org/faff).

**All @faff packages:**
- [@faff/create](https://npmjs.com/package/@faff/create) - This meta-installer
- More coming soon (core, engine, integrations)

---

## Resources

- **Website:** https://faf.one
- **npm Org:** https://npmjs.com/org/faff
- **CLI:** https://npmjs.com/package/faf-cli
- **MCP:** https://npmjs.com/package/claude-faf-mcp
- **Chrome Extension:** Search "FAF" in Chrome Web Store

---

## Stats (Verified)

- 8,700+ total downloads across all packages
- Official Anthropic MCP registry (PR #2759 MERGED)
- Google-approved Chrome extension (LIVE)
- 10,000+ projects tested
- <50ms processing time achieved

---

## License

MIT - Free forever

---

**Championship-grade engineering. F1-inspired performance. Built with 🧡 by [wolfejam.dev](https://wolfejam.dev)**