Repomix Skill

Repomix packs entire repositories into single, AI-friendly files. Perfect for feeding codebases to LLMs like Claude, ChatGPT, and Gemini.

When to Use

Use when:

Packaging codebases for AI analysis Creating repository snapshots for LLM context Analyzing third-party libraries Preparing for security audits Generating documentation context Investigating bugs across large codebases Creating AI-friendly code representations Quick Start Check Installation repomix --version

Install

npm

npm install -g repomix

Homebrew (macOS/Linux)

brew install repomix

Basic Usage

Package current directory (generates repomix-output.xml)

repomix

Specify output format

repomix --style markdown repomix --style json

Package remote repository

npx repomix --remote owner/repo

Custom output with filters

repomix --include "src/*/.ts" --remove-comments -o output.md

Core Capabilities Repository Packaging AI-optimized formatting with clear separators Multiple output formats: XML, Markdown, JSON, Plain text Git-aware processing (respects .gitignore) Token counting for LLM context management Security checks for sensitive information Remote Repository Support

Process remote repositories without cloning:

Shorthand

npx repomix --remote yamadashy/repomix

Full URL

npx repomix --remote https://github.com/owner/repo

Specific commit

npx repomix --remote https://github.com/owner/repo/commit/hash

Comment Removal

Strip comments from supported languages (HTML, CSS, JavaScript, TypeScript, Vue, Svelte, Python, PHP, Ruby, C, C#, Java, Go, Rust, Swift, Kotlin, Dart, Shell, YAML):

repomix --remove-comments

Common Use Cases Code Review Preparation

Package feature branch for AI review

repomix --include "src/*/.ts" --remove-comments -o review.md --style markdown

Security Audit

Package third-party library

npx repomix --remote vendor/library --style xml -o audit.xml

Documentation Generation

Package with docs and code

repomix --include "src/,docs/,*.md" --style markdown -o context.md

Bug Investigation

Package specific modules

repomix --include "src/auth/,src/api/" -o debug-context.xml

Implementation Planning

Full codebase context

repomix --remove-comments --copy

Command Line Reference File Selection

Include specific patterns

repomix --include "src//.ts,.md"

Ignore additional patterns

repomix -i "tests/*,.test.js"

Disable .gitignore rules

repomix --no-gitignore

Output Options

Output format

repomix --style markdown # or xml, json, plain

Output file path

repomix -o output.md

Remove comments

repomix --remove-comments

Copy to clipboard

repomix --copy

Configuration

Use custom config file

repomix -c custom-config.json

Initialize new config

repomix --init # creates repomix.config.json

Token Management

Repomix automatically counts tokens for individual files, total repository, and per-format output.

Typical LLM context limits:

Claude Sonnet 4.5: ~200K tokens GPT-4: ~128K tokens GPT-3.5: ~16K tokens Security Considerations

Repomix uses Secretlint to detect sensitive data (API keys, passwords, credentials, private keys, AWS secrets).

Best practices:

Always review output before sharing Use .repomixignore for sensitive files Enable security checks for unknown codebases Avoid packaging .env files Check for hardcoded credentials

Disable security checks if needed:

repomix --no-security-check

Implementation Workflow

When user requests repository packaging:

Assess Requirements

Identify target repository (local/remote) Determine output format needed Check for sensitive data concerns

Configure Filters

Set include patterns for relevant files Add ignore patterns for unnecessary files Enable/disable comment removal

Execute Packaging

Run repomix with appropriate options Monitor token counts Verify security checks

Validate Output

Review generated file Confirm no sensitive data Check token limits for target LLM

Deliver Context

Provide packaged file to user Include token count summary Note any warnings or issues Reference Documentation

For detailed information, see:

Configuration Reference - Config files, include/exclude patterns, output formats, advanced options Usage Patterns - AI analysis workflows, security audit preparation, documentation generation, library evaluation Additional Resources GitHub: https://github.com/yamadashy/repomix Documentation: https://repomix.com/guide/ MCP Server: Available for AI assistant integration