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™

🎉 MAJOR UPDATE v2.2.0 - FREE for all Developers!

No pricing, no subscriptions, 100% FREE & Open Source CLI

🆓 FREE & Open Source AI Context Management

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

🚀 Get Started • 📚 Documentation • 🎮 Live Demo

🧡 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 (3 seconds AI, 2:57 human clicking 😉)
🏎️ <50ms processing time
🎯 154+ formats validated and supported
🔄 Eternal-Sync™ keeps context always current

🏆 Real Achievements

🆓 100% FREE - Open source CLI tool
📦 800+ Weekly Downloads - Growing community
📝 MCP Integration - Works with Claude Desktop
✅ TypeScript Strict Mode - Zero violations
✅ Battle Tested - 20 extreme stress tests passed
🏎️ Championship Grade - <50ms performance

🚀 Quick Start

Install the FREE CLI

# 100% FREE - No credit card required
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              # Smart .faf generation with instant scoring
faf score --details   # See your AI-readiness percentage
faf trust            # View trust dashboard & achievements

📦 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

📊 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

📦 Dependencies (Lean & Mean)

Production Dependencies (6 only!):

@faf/engine (local) - Our core engine
chalk (^4.1.2) - Terminal colors
commander (^9.5.0) - CLI framework
glob (^11.0.3) - File patterns
inquirer (^12.9.4) - Interactive prompts
yaml (^2.4.1) - The .faf language (YAML & 🍜 noodles)

✅ Cleanup Complete:

Removed openai - Not used
Removed enquirer - Duplicate
Moved @types/inquirer to devDependencies
33% reduction achieved! (9 → 6 dependencies)

🏎️ 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 PR Submitted - #2759 (pending review)
⭐ 9.3/10 AI Rating - Highest in category
🚀 ProductHunt - Coming soon
📰 Press Coverage - View Press Kit

📞 Support & Contact

📦 NPM Package: npmjs.com/package/faf-cli
🐛 Issues: GitHub Issues
📧 Email: support@faf.one
📚 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 • 💎 Founder $9/month

Made with 🧡 by the .faf Team