AI Code Packer

What Does This Tool Do?

AI Code Packer combines all your code files into one organized text file that you can share with AI assistants like ChatGPT, Claude, or Gemini. Instead of copying and pasting files one by one, you get everything packaged neatly in seconds.

Quick Start Guide

1. Upload: Click "Choose Project Folder" and select your project's main folder
2. Filter: Pick a preset (like "Code Only") or manually choose which files to include
3. Export: Copy the result and paste it into your AI chat, or download it as a file

What Are "Tokens"?

Tokens are how AI assistants measure text. Think of them like "chunks of words" - roughly 1 token = 4 characters, or about 750 tokens per page of text.

Why they matter: Every AI has a context limit - a maximum amount of text it can read at once. If your packed code has too many tokens, the AI won't be able to read all of it.

Common AI Context Limits (as of 2025):

• ChatGPT (GPT-4): 32K-128K tokens depending on version
• Claude (Sonnet/Opus): 200K tokens
• Gemini Pro: 32K-128K tokens

Token Color Guide

• Green (Under 8K) - Perfect! Works with any AI
• Yellow (8K-32K) - Good for most projects
• Orange (32K-100K) - Large project, check your AI's limit
• Red (100K+) - Too big for most AIs, filter more files

Tips for Best Results

• Start with presets: Use "Code Only" or "Code + Docs" to exclude unnecessary files
• Watch the token count: Keep it under your AI's limit (check the Filter tab)
• Text files only: Images and media will be listed but their content won't be included
• Use Simple Text format: It works with all AI assistants (recommended for beginners)
• Paste directly: After copying, just paste into your AI chat - it's ready to go!

Common Questions

Q: Can I use this with any AI?
A: Yes! The Simple Text format works with ChatGPT, Claude, Gemini, and any other AI assistant.

Q: What if my project is too big?
A: Use the Filter tab to uncheck folders like tests, documentation, or config files you don't need.

Q: Is my code uploaded anywhere?
A: No! Everything happens in your browser. Your code never leaves your computer unless you choose to copy/download it.

Custom Exclusion Patterns - Complete Guide

Exclusion patterns let you filter out files using flexible matching rules called "glob patterns". Think of them like search terms with wildcards.

Basic Symbols

• * - Matches any characters in a single file/folder name (but not slashes)
• ** - Matches any number of folders deep
• ? - Matches exactly one character

Pattern Examples (Step-by-Step)

*.log
Excludes all files ending with .log anywhere in your project
Examples: error.log, debug.log, app.log

*.min.js
Excludes all minified JavaScript files
Examples: jquery.min.js, app.min.js

test/**
Excludes the entire "test" folder and everything inside it
Examples: test/unit.js, test/helpers/mock.js, test/data/sample.json

**/test/**
Excludes any "test" folder at any level in your project
Examples: src/test/file.js, lib/utils/test/helper.js

**/backup/*
Excludes all files directly inside any "backup" folder (but not subfolders)
Examples: backup/old.js, src/backup/data.json

**/*.backup
Excludes all .backup files anywhere in your project
Examples: config.backup, src/utils/helper.backup

temp-*
Excludes any file or folder starting with "temp-"
Examples: temp-data.json, temp-backup/

draft?.txt
Excludes files like draft1.txt, draft2.txt, draftA.txt (one character after "draft")
Examples: draft1.txt, draft9.txt, draftX.txt

How to Use

1. Go to the Filter tab
2. Scroll to Custom Exclusion Patterns
3. Type one pattern per line in the text box
4. Click Apply Patterns
5. Check the file tree to see what got excluded

Real-World Examples

To exclude logs, caches, and temporary files:

*.log
*.cache
**/temp/**
**/.DS_Store
**/Thumbs.db

To exclude all test and build output files:

**/test/**
**/tests/**
**/dist/**
**/build/**
**/*.test.js
**/*.spec.js