repo2txt
💡 Looking for the classic version? Check out repo2txt-classic
Convert repositories to plain text for LLM prompts
Fast, browser-based tool for AI-assisted development
🔗 Try it now →
✨ Features
🔌 Multiple Sources
GitHub - Public and private repositories with token supportLocal Files - Directory picker for your local projectsZip Upload - Drag & drop zip filesGitLab (Beta) - GitLab repository supportAzure DevOps (Beta) - Azure Repos integration
🎯 Smart Filtering
Extension Filter - Select/deselect by file typeGitignore Support - Automatically respect .gitignore patternsCustom Patterns - Add your own ignore patternsDirectory Selection - Cherry-pick specific foldersFile Tree Preview - Visual file selection with virtual scrolling
🚀 Performance
Virtual Scrolling - Handle repositories with 10,000+ filesCode Splitting - Lazy-loaded providers for optimal bundle sizeWeb Workers - Tokenization runs in background threadsProgressive Loading - Stream file contents as they loadSmart Caching - Efficient memory usage for large repos
🎨 Modern UX
Dark Mode - System, light, and dark themesResponsive Design - Works on desktop, tablet, and mobileToken Counter - Real-time GPT token countingFile Statistics - Per-file token and line countsProgress Indicators - Clear feedback during loading
🔒 Privacy First
100% Browser-Based - No server uploads, all processing is localNo Tracking - Your code never leaves your deviceSecure - GitHub tokens stored in sessionStorage onlyOpen Source - Fully auditable codebase
🚀 Quick Start
Use Online
Visit abinthomas.in/repo2txt - no installation needed!
Run Locally
hljs language-bash
Copy
git clone https://github.com/abinthomasonline/repo2txt.git
cd repo2txt
npm install
npm run dev
Build for Production
hljs language-bash
Copy npm run build
📖 Usage
GitHub Repository
Paste a GitHub URL: https://github.com/facebook/react
Optionally add a personal access token for:
Private repositories
Higher rate limits (5000 vs 60 requests/hour)
Click "Load Repository"
Select files using the tree or extension filters
Click "Generate Output"
Copy to clipboard or download as .txt
Supported URL formats:
https://github.com/owner/repo (default branch)https://github.com/owner/repo/tree/branch-namehttps://github.com/owner/repo/tree/branch-name/path/to/folderBranch names with slashes: feature/test/branch-name ✓
Local Files
Switch to "Local" provider
Choose "Directory" or "Zip File"
Select your project folder or upload a zip
Same filtering and export options as GitHub
🛠️ Tech Stack
Framework : React 19 + TypeScriptBuild Tool : Vite 5Styling : Tailwind CSS 3State Management : ZustandFile Handling : JSZipTokenization : gpt-tokenizerVirtual Scrolling : TanStack VirtualTesting : Vitest + PlaywrightCI/CD : GitHub Actions
📊 Project Stats
Bundle Size : ~330KB main chunk (gzipped)First Load : < 2s on 3GTest Coverage : 100% E2E test pass ratePerformance : Lighthouse 95+ across all metricsCompatibility : Chrome 90+, Firefox 88+, Safari 14+, Edge 90+
🤝 Contributing
We welcome contributions! Please see:
Quick Contribution Guide
hljs language-bash
Copy
git clone https://github.com/YOUR_USERNAME/repo2txt.git
git checkout -b feature/amazing-feature
npm run test :unit
npm run test :e2e
git commit -m "Add amazing feature"
git push origin feature/amazing-feature
📝 License
MIT License - see LICENSE for details
🙏 Acknowledgments
🔗 Links
⭐ Star History
If you find this project helpful, please consider giving it a star! It helps others discover the tool.
Made with 🤖 for AI developers
