repo2txt-extension is a privacy-first browser extension that converts GitHub repositories and local folders into plain text optimized for LLM prompts. Whether you're analyzing code with ChatGPT, Claude, or any other AI assistant, this tool gets your codebase ready in seconds — without ever uploading your code to a server.
🔒 100% Client-Side • 🚀 One-Click Conversion • 🌐 GitHub + Local Files
- GitHub — Public and private repositories with personal access token support
- Local Files — Native directory picker for projects on your machine
- Zip Upload — Drag and drop zip files for instant conversion
- Extension Filter — Select and deselect by file type in one click
- Gitignore Support — Automatically respects
.gitignorepatterns - Custom Patterns — Add your own ignore rules on the fly
- Directory Selection — Cherry-pick specific folders from the tree
- File Tree Preview — Visual file selection with virtual scrolling
- Virtual Scrolling — Handles repositories with 10,000+ files smoothly
- Code Splitting — Lazy-loaded providers for optimal bundle size
- Web Workers — Tokenization runs in background threads
- Progressive Loading — Streams file contents as they load
- Smart Caching — Efficient memory usage for large repositories
- Dark Mode — System, light, and dark themes
- Responsive Design — Works on desktop, tablet, and mobile
- Token Counter — Real-time GPT token counting
- File Statistics — Per-file token and line counts
- Progress Indicators — Clear visual feedback during loading
- GitHub Integration — "Convert to Text" button injected on GitHub repo pages
- 100% Client-Side — No server uploads, all processing is local
- No Tracking — Your code never leaves your device
- Encrypted Storage — GitHub tokens encrypted with per-install keys
- Open Source — Fully auditable codebase
This is the quickest way to get started — no coding or terminal required.
-
Download the latest
.zipfrom the Releases page -
Unzip the file to a folder on your computer
-
Open your browser's extensions page — type one of the following into your address bar:
Browser URL Chrome chrome://extensionsEdge edge://extensionsBrave brave://extensionsOpera opera://extensionsVivaldi vivaldi://extensionsArc chrome://extensions -
Enable "Developer mode" — toggle the switch in the top-right corner of the extensions page
-
Click "Load unpacked" — select the unzipped folder
-
Pin the extension to your toolbar — click the puzzle piece icon 🧩 and pin repo2txt
💡 Tip: This extension works on all Chromium-based browsers. If your browser isn't listed above, try
chrome://extensions— it often works as a fallback.
# Clone the repository
git clone https://github.com/michael-farah/repo2txt-extension.git
cd repo2txt-extension
# Install dependencies
bun install
# Build the extension
bun run build
# Then load the dist/ folder as an unpacked extension (see steps 3–6 above)bun run build:crxCreates:
release/repo2txt-v{version}.zip— for self-hosted distributionrelease/repo2txt-v{version}.crx— for direct installation
- Click the extension icon in your toolbar
- Paste a GitHub URL:
https://github.com/facebook/react - Optionally add a personal access token for:
- Private repositories
- Higher rate limits (5,000 vs 60 requests/hour)
- Click "Load Repository"
- Select files using the tree or extension filters
- Click "Generate"
- Copy to clipboard or download as
.txt
Pro tip: Visit any GitHub repo page and click the "Convert to Text" button injected into the page header.
https://github.com/owner/repo (default branch)
https://github.com/owner/repo/tree/branch-name (specific branch)
https://github.com/owner/repo/tree/branch-name/path (subfolder)
✓ Branch names with slashes (e.g., feature/test/branch-name) are fully supported.
- Switch to the "Local" provider tab
- Choose "Directory" or "Zip File"
- Select your project folder or upload a zip
- Use the same filtering and export options as GitHub
| Category | Technology |
|---|---|
| Framework | React 19 + TypeScript |
| Build Tool | Vite 5 |
| Styling | Tailwind CSS 3 |
| State Management | Zustand |
| File Handling | JSZip |
| Tokenization | gpt-tokenizer (Web Worker) |
| Virtual Scrolling | TanStack Virtual |
| Testing | Vitest + Playwright |
| Browser | Status | Notes |
|---|---|---|
| Chrome | ✅ Supported | Manifest V3, service workers, chrome.storage.local |
| Edge | ✅ Supported | Compatible with Chrome extensions |
| Brave | ✅ Supported | Compatible with Chrome extensions |
| Opera | ✅ Supported | Compatible with Chrome extensions |
| Vivaldi | ✅ Supported | Compatible with Chrome extensions |
| Arc | ✅ Supported | Compatible with Chrome extensions |
| Firefox | 📋 Planned | Requires browser-polyfill and MV3 adjustments |
| Safari | 📋 Planned | Requires Xcode project and App Store distribution |
Contributions for cross-browser support are welcome!
Support for additional Git hosting platforms is under consideration:
- GitLab — API authentication, self-hosted instances, different rate limits
- Bitbucket — API authentication, different repository structure
- Gitea/Forgejo — Self-hosted instances, API versioning
To contribute a new provider, extend BaseProvider and implement fetchTree, fetchFile, validateUrl, and parseUrl. See src/features/github/GitHubProvider.ts for reference.
See CONTRIBUTING.md for the development guide and architecture details.
git clone https://github.com/michael-farah/repo2txt-extension.git
cd repo2txt-extension
bun install
bun run test:unit
bun run buildThis extension forks repo2txt by Abin Thomas. The original web version lives at abinthomas.in/repo2txt. Core architecture, provider system, and UI design come from the original project.