repo2txt

name	repo2txt
description	Convert code repositories to formatted text for LLM analysis. Use when the user wants to send code to Gemini, Claude, or other LLMs for debugging, code review, or analysis. Triggers on phrases like "convert code to text", "repo to text", "format code for LLM", "send code to Gemini", or when analyzing code structure and contents for LLM consumption.

Repo2txt

Overview

This skill converts local code repositories into a formatted text file suitable for sending to LLMs like Gemini, Claude, or ChatGPT. It's similar to https://repo2txt.simplebasedomain.com/ but runs locally, giving you full control over file selection and formatting.

Quick Start

Basic Usage

Convert a repository to text and display in terminal:

python3 scripts/repo2txt.py /path/to/repo

Save to a file:

python3 scripts/repo2txt.py /path/to/repo -o output.txt

Filter by Extensions

Only include specific file types:

python3 scripts/repo2txt.py /path/to/repo -e .py,.js,.ts

Exclude certain extensions:

python3 scripts/repo2txt.py /path/to/repo -x .test.js,.spec.ts

Common Scenarios

Debug a specific module:

python3 scripts/repo2txt.py ./src/components -e .tsx,.ts -o component_debug.txt

Analyze backend API:

python3 scripts/repo2txt.py ./src/api -e .py -o api_analysis.txt

Review configuration files:

python3 scripts/repo2txt.py . -e .json,.yaml,.yml,.toml -o config_review.txt

Output Format

The generated text file includes three sections:

1. Repository Summary: File counts, total lines, breakdown by file type
2. Directory Structure: Tree visualization of the file hierarchy
3. File Contents: Each file with its path, type, and full content

Example output structure:

================================================================================
REPOSITORY SUMMARY
================================================================================
Total Files: 42
Total Lines: 3,456
Total Size: 128.5 KB

Files by Type:
  TypeScript: 25
  JavaScript: 10
  JSON: 5
  CSS: 2

================================================================================
DIRECTORY STRUCTURE
================================================================================

└── src
    ├── components
    │   ├── Button.tsx
    │   └── Card.tsx
    └── utils
        └── helpers.ts

================================================================================
FILE CONTENTS
================================================================================

--------------------------------------------------------------------------------
File: src/components/Button.tsx
Type: React/TS
--------------------------------------------------------------------------------

[file content here]

Options Reference

Option	Description	Example
-o, --output	Output file path	-o analysis.txt
-e, --extensions	Include only these extensions	-e .py,.js
-x, --exclude-extensions	Exclude these extensions	-x .test.js
-i, --ignore	Additional ignore patterns	-i temp,*.bak
--no-tree	Skip directory tree	--no-tree
--no-summary	Skip summary section	--no-summary
--max-file-size	Max file size in bytes	--max-file-size 500000

Default Ignore Patterns

The following are automatically ignored:

• Version control: .git, .svn, .hg
• Dependencies: node_modules, vendor, __pycache__, virtual environments
• Build outputs: dist, build, target, .next, .nuxt
• IDE files: .idea, .vscode
• Lock files: package-lock.json, yarn.lock, poetry.lock, etc.
• Binary files: images, fonts, videos, archives
• Large data files: CSV, large JSON files

Resources

scripts/

• repo2txt.py: Main script for converting repositories to formatted text. Supports filtering by extensions, custom ignore patterns, and various output options.

Usage Tips

1. For Gemini/Claude: Most LLMs have context limits. If your repo is large, filter to specific directories or file types.

2. Focus on relevant code: Use -e to include only the file types relevant to your question.

3. Skip generated files: The default ignore patterns handle most build artifacts and dependencies.

4. Copy to clipboard (macOS):

   python3 scripts/repo2txt.py . -e .py | pbcopy
   

5. Copy to clipboard (Linux):

   python3 scripts/repo2txt.py . -e .py | xclip -selection clipboard