filestoai 1.0.0

Export your codebase for AI consumption - CLI and Web Interface

FilesToAI

Instantly export your codebase to AI. Smart filtering, one-click copy, global hotkey.

Now available as both a CLI tool and Web Interface!

---

🚀 Quick Start

Option 1: Command Line (Instant)

# Install as a package
pip install -e .

# Use anywhere
filestoai .                      # Export current directory
filestoai /path/to/project -gi   # With gitignore
filestoai . --size 200           # Custom size limit (200 KB)
filestoai --server               # Start web interface

Option 2: Web Interface

git clone https://github.com/mystxcal/FilesToAI
cd FilesToAI
pip install -e .

# Start server (choose one):
filestoai --server        # Via CLI
# OR
pip install -r requirements.txt
python app.py             # Direct method

→ Open http://127.0.0.1:5023

---

💡 What It Does

CLI: Run filestoai . in any directory → Output copied to clipboard instantly

Web: Select files from your project → Generate AI-ready output → Copy with Ctrl+Shift+Space

Perfect for feeding context to ChatGPT, Claude, and other LLMs.

---

✨ Features

CLI Mode

• ⚡ Lightning Fast — Run filestoai . and get instant output
• 🎯 Flexible Flags — -gi for gitignore, --size for limits, -i for custom patterns
• 📋 Auto Copy — Output goes straight to clipboard
• 📁 File Output — Save to file with -o filename.txt
• 🔍 Preview Mode — --list-files to see what will be exported

Web Interface

• ✓ .gitignore + custom patterns (with live testing)
• ✓ Quick-select by extension
• ✓ Hide unwanted files (images, logs, minified)
• ✓ File size limits + real-time stats
• 🔥 Global Hotkey — Ctrl+Shift+Space copies from anywhere
• 🌓 Dark/Light Mode — Automatically themed
• 📜 Path History — Recent projects saved
• 💾 Persistent Config — Settings survive restarts

Both Modes

• files.txt — File contents concatenated
• project_map.txt — Directory structure
• Smart Filtering — Respect gitignore, size limits, custom patterns

🔜 Coming Soon

• 🐙 GitHub Integration — Export directly from GitHub repositories

---

📖 How To Use

CLI Mode

# Basic usage
filestoai .                              # Export current directory
filestoai /path/to/project              # Export specific directory

# With options
filestoai . -gi                         # Respect .gitignore
filestoai . --size 200                  # Max file size limit (200 KB)
filestoai . -i "*.log,node_modules/"    # Custom ignore patterns
filestoai . -o output.txt               # Save to file
filestoai . --list-files                # Preview files

# Combined
filestoai . -gi --size 150 -i "dist/,*.min.js" -v

# Start web interface
filestoai --server               # Default port 5023
filestoai --server --port 8000   # Custom port

See CLI_USAGE.md for all CLI options and examples.

Web Interface

Start the server:

filestoai --server   # Via CLI (recommended)
# OR
python app.py        # Direct method

Step	Action
1	Enter project path → Click Load
2	Configure filters & ignore patterns
3	Check files/folders in tree view
4	Click Generate Output or press Ctrl+Shift+Space
5	Copy or download results

Pro Tip: Keep the app running in the background and use Ctrl+Shift+Space to instantly copy your last selection from any window.

---

🔧 Advanced

CLI Options

-gi, --gitignore              # Respect .gitignore files
-s, --size KB                 # Max file size in KB (default: 100)
-i, --ignore PATTERNS         # Custom ignore patterns (comma-separated)
-o, --output FILE             # Save to file instead of clipboard
--no-copy                     # Don't copy to clipboard
--include-binary              # Include binary files as placeholders
--project-map-only            # Only generate project structure
--files-only                  # Only generate file contents
--list-files                  # List files without generating output
-v, --verbose                 # Enable verbose logging

Full CLI documentation: CLI_USAGE.md

Custom Ignore Patterns

Use .gitignore syntax for fine control:

node_modules/
*.log
__pycache__/
dist/**/*.map

CLI: filestoai . -i "node_modules/,*.log" Web: Test patterns in-app before applying

API Endpoints

RESTful API for automation:

• GET /api/browse — Directory structure
• POST /api/select — File selection
• POST /api/generate — Generate output
• POST /api/global_trigger_generate_and_copy — Hotkey endpoint

See app.py for full docs.

Global Hotkey (Web Only)

Press anywhere with app running:

1. Reads filestoai_config.json
2. Generates output from last selected files
3. Falls back to all files if none selected
4. Copies to clipboard instantly

---

🛠️ Tech Stack

Flask • Bootstrap • jQuery • Python 3.8+

---

📦 Dependencies

Flask>=2.3.0
keyboard>=0.13.5
pyperclip>=1.8.2
requests>=2.31.0

---

📄 License

MIT License

---

🤝 Contributing

PRs welcome! Open an issue for major changes.

---

Made for developers who ship with AI ⚡

⭐ Star this repo • 🐛 Report Bug • 💡 Request Feature