|
1 | | -# 🚀 FAF - Fast AF AI Context Extraction |
| 1 | +# 🚀 FAF Chrome Extension - Fast AF Context Extraction |
2 | 2 |
|
3 | | -> **Extract perfect AI context in 0.3 seconds. Stop FAFfing About.** |
| 3 | +> **Grab any codebase as .txt in one click. GitHub, Monaco, StackBlitz, GitLab—every dev's dream when you need it.** |
4 | 4 |
|
5 | | -FAF is a lightning-fast Chrome extension and emerging open standard for AI context extraction. It intelligently analyzes codebases, documentation, and development environments to generate structured `.faf` files that provide AI assistants with the perfect context for your project. |
| 5 | +Google-approved Chrome extension that extracts code context from ANY development environment. Monaco editor? React sandbox? GitHub repo? One click → perfect .txt context → ready for Claude, Cursor, or any AI. |
6 | 6 |
|
7 | | -[](https://github.com/Wolfe-Jam/faf-production) |
8 | | -[](LICENSE) |
9 | | -[](https://chrome.google.com/webstore) |
| 7 | +[](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm) |
| 8 | +[](LICENSE) |
| 9 | +[](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm) |
| 10 | +[](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm) |
10 | 11 |
|
11 | | -## ✨ What is FAF? |
| 12 | +## 🎯 Why This Exists |
12 | 13 |
|
13 | | -FAF (**F**ast **A**F) solves the universal problem every developer faces: **providing AI assistants with the right context**. Instead of manually copying and pasting code snippets, file structures, and project details, FAF: |
| 14 | +**The Problem:** You're testing something in StackBlitz, you need to ask Claude about it, but copying code manually is a pain. |
14 | 15 |
|
15 | | -- 🔍 **Intelligently analyzes** your codebase across 15+ platforms (GitHub, Monaco, CodeMirror, etc.) |
16 | | -- 📊 **Scores context quality** from 0-100% based on completeness and relevance |
17 | | -- 📋 **Copies structured context** directly to your clipboard in seconds |
18 | | -- 🎯 **Works everywhere** - any website, any development environment |
19 | | -- ⚡ **Blazing fast** - Full extraction in under 300ms |
| 16 | +**The Solution:** One click. Entire codebase → clipboard as clean .txt. Works on GitHub, Monaco editor, React playgrounds, GitLab, anywhere. |
20 | 17 |
|
21 | | -## 🎯 Quick Start |
| 18 | +**My Story:** Built it for myself while testing. Needed it. Google approved it. Success. Nine downloads. Zero reviews. But it's **top-notch** as you'd expect—when you need it, you NEED it. |
22 | 19 |
|
23 | | -### 1. Install the Chrome Extension |
| 20 | +**The Format:** The .txt output is a **pre-cursor to .faf**—any FAF tool gobbles it up like an appetizer. It's the universal handoff format for AI context. |
24 | 21 |
|
| 22 | +## ✨ What It Does |
| 23 | + |
| 24 | +- 🔍 **Works on 15+ platforms** - GitHub, Monaco, CodeMirror, StackBlitz, GitLab, Replit |
| 25 | +- 📋 **One-click extraction** - Entire codebase → clipboard in <300ms |
| 26 | +- 🎯 **Clean .txt format** - Human-readable, AI-ready, .faf-compatible |
| 27 | +- ⚡ **Zero config** - Install, click icon, done |
| 28 | +- 🛡️ **Google Approved** - Passed security review, live in Chrome Web Store |
| 29 | + |
| 30 | +## 🚀 Quick Start |
| 31 | + |
| 32 | +### 1. Install from Chrome Web Store |
| 33 | + |
| 34 | +**[→ Install FAF Extension](https://chromewebstore.google.com/detail/lnecebepmpjpilldfmndnaofbfjkjlkm)** |
| 35 | + |
| 36 | +Or build from source: |
25 | 37 | ```bash |
26 | | -# Clone and build locally (Chrome Web Store submission pending) |
27 | | -git clone https://github.com/Wolfe-Jam/faf-production.git |
28 | | -cd faf-production |
29 | | -npm install |
30 | | -npm run build |
| 38 | +git clone https://github.com/Wolfe-Jam/faf-chrome-extension.git |
| 39 | +cd faf-chrome-extension |
| 40 | +npm install && npm run build |
31 | 41 | ``` |
32 | 42 |
|
33 | | -Then load `dist/` as an unpacked extension in Chrome. |
| 43 | +### 2. Use It |
34 | 44 |
|
35 | | -### 2. Extract Context Instantly |
| 45 | +1. Open any GitHub repo, Monaco editor, StackBlitz, etc. |
| 46 | +2. Click FAF extension icon 🚀 |
| 47 | +3. Click "Extract Context" |
| 48 | +4. Context copied to clipboard as clean .txt |
| 49 | +5. Paste into Claude, Cursor, or any AI |
36 | 50 |
|
37 | | -1. **Navigate** to any GitHub repo, CodeSandbox, or development site |
38 | | -2. **Click** the FAF extension icon ⚡ |
39 | | -3. **Hit** "Extract AI Context" |
40 | | -4. **Paste** the perfect context into ChatGPT, Claude, or any AI assistant |
41 | | - |
42 | | -### 3. Get Better AI Responses |
| 51 | +### 3. Real Example |
43 | 52 |
|
| 53 | +**Without FAF:** |
| 54 | +``` |
| 55 | +You: "Help with this React component" |
| 56 | +AI: "Which component? Show me the code" |
| 57 | +You: [manually copies files one by one] |
44 | 58 | ``` |
45 | | -🤖 Instead of: "Help me with my React app" |
46 | | -✅ With FAF: [Pastes comprehensive .faf context with file structure, dependencies, platform details] |
47 | 59 |
|
48 | | -Result: AI instantly understands your project structure, tech stack, and current context. |
| 60 | +**With FAF:** |
| 61 | +``` |
| 62 | +You: [pastes FAF .txt] "Help with this React component" |
| 63 | +AI: "I see you're using React 18 with Vite, here's what I'd change in Button.tsx..." |
49 | 64 | ``` |
50 | 65 |
|
51 | 66 | ## 📋 Supported Platforms |
|
0 commit comments