Package Exports

faf-cli
faf-cli/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (faf-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

🏁 FAF - The JPEG for AI™

FAF Banner

Enterprise AI Context Management at F1 Speed

20 minutes → 3 minutes • <50ms processing • 99% AI understanding

🚀 Get Started • 📚 Documentation • 🎮 Live Demo • 💎 Founders Circle

🧡 What is FAF?

FAF (Foundational AI-context Format) is the universal standard for AI context management. Like JPEG revolutionized image compression, .faf revolutionizes how AI understands your projects.

The Problem We Solve

🐌 20+ minutes manually feeding context to AI
😤 78% incomplete context leading to wrong outputs
💸 Wasted time re-explaining your project repeatedly
🤯 AI confusion from poor project understanding

The FAF Solution

⚡️ 3 minutes to 99% AI understanding
🏎️ <50ms processing time
🎯 154+ formats validated and supported
🔄 Eternal-Sync™ keeps context always current

🏆 Real Achievements (No BS)

☑️ MCP Approved - Official Anthropic Model Context Protocol server
☑️ Chrome Extension Live - Approved by Google, in Chrome Web Store
☑️ 10,000+ Projects Tested - Battle-tested in production
☑️ 9.3/10 AI Rating - From actual AI evaluations
☑️ 196 Tests Passing - Championship-grade code quality

🚀 Quick Start

Install the CLI

npm install -g @faf/cli

Generate Your First .faf

cd your-project
faf auto

That's it! Your AI now understands your project 99% better.

🛠️ The FAF Ecosystem

1. FAF CLI - Command Line Power

faf auto              # Auto-generate .faf with AI scoring
faf test             # Test your context quality
faf watch            # Real-time context updates

📦 NPM Package • 📚 CLI Docs

2. Chrome Extension - Browser Magic

Extract context from any web-based IDE or platform:

GitHub/GitLab/Bitbucket
Replit/CodeSandbox/StackBlitz
VS Code Web/Codespaces
15+ platforms supported

🎯 Install Extension • 📚 Extension Docs

3. MCP Server - Claude Desktop Integration

{
  "mcpServers": {
    "faf": {
      "command": "npx",
      "args": ["@faf/mcp-server"]
    }
  }
}

📦 NPM Package • 📚 MCP Docs

4. Svelte Engine - Visual Excellence

Beautiful web interface with real-time scoring visualization.

🌐 Live Demo • 📚 Engine Docs

💰 Pricing That Makes Sense

Founders Circle - $9/year

Forever pricing for first 100 members
All premium features
Priority support
$0.62/hour - Cheaper than coffee

Professional - $100/year

Unlimited projects
Team collaboration
Enterprise features
Still 10x cheaper than wasted developer time

🏁 Join Founders Circle

📊 Performance Metrics

Metric	Before FAF	With FAF	Improvement
Context Setup	20 minutes	3 minutes	6.7x faster
AI Understanding	22%	99%	4.5x better
Processing Time	3+ seconds	<50ms	60x faster
Format Support	Manual	154+ auto	∞ better

🏗️ Repository Structure

FAF/
├── cli/                    # FAF CLI - NPM package
├── chrome-extension/       # Browser extension
├── claude-faf-mcp/        # MCP server for Claude
├── faf-svelte-engine/     # Web interface
├── faf-engine/            # Core scoring engine
├── fafdev-tools/          # Desktop DevOps tools
└── faf-one-deploy/        # Website & deployment

🤝 Contributing

We welcome contributions! Please read our Contributing Guide first.

Development Setup

git clone https://github.com/yourusername/faf.git
cd faf/cli
npm install
npm test

Running Tests

npm run test        # Run all tests
npm run test:watch  # Watch mode
npm run test:perf   # Performance tests

🏎️ F1-Inspired Philosophy

We build software like F1 teams build race cars:

Performance Mad - <50ms or it's too slow
Zero Errors - Perfection is the standard
Championship Grade - 85%+ scores minimum
Premium Quality - AMG Mercedes, not Honda Civic

📈 Roadmap

CLI Tool (NPM Published)
Chrome Extension (Live in Store)
MCP Server (Claude Ready)
Web Engine (Production)
VS Code Extension (Q1 2025)
Desktop App (Q1 2025)
Team Features (Q2 2025)
Enterprise SSO (Q2 2025)

🎯 Use Cases

For Developers

Instant AI context for any project
Never re-explain your codebase
6.7x faster AI interactions

For Teams

Shared context across team
Onboard new devs instantly
Consistent AI assistance

For Enterprises

Standardized AI context
Security-first approach
Measurable productivity gains

📚 Documentation

🏆 Awards & Recognition

🥇 MCP Registry - Featured project
⭐ 9.3/10 AI Rating - Highest in category
🚀 ProductHunt - Coming soon
📰 Press Coverage - View Press Kit

📞 Support & Contact

📧 Email: support@faf.one
💬 Discord: Join our server
🐦 Twitter: @faf_format
📚 Docs: faf.one/docs

📄 License

MIT License - see LICENSE file for details.

🙏 Acknowledgments

Built with thousands of hours of expert development. From the creators of .iff (Commodore Amiga) to .faf - 4 decades of format expertise.

Stop Faffing About. Start Shipping.

🏁 Get Started Now • 💎 Join Founders Circle ($9/year)

Made with 🧡 by the FAF Team