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

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

🔧 Advanced

-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

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

🛠️ 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.