Repomix

# Command Line Options ## Basic Options - `-v, --version`: Show version information and exit ## CLI Input/Output Options - `--verbose`: Enable detailed debug logging (shows file processing, token counts, and configuration details) - `--quiet`: Suppress all console output except errors (useful for scripting) - `--stdout`: Write packed output directly to stdout instead of a file (suppresses all logging) - `--stdin`: Read file paths from stdin, one per line (specified files are processed directly) - `--copy`: Copy the generated output to system clipboard after processing - `--token-count-tree [threshold]`: Show file tree with token counts; optional threshold to show only files with ≥N tokens (e.g., --token-count-tree 100) - `--top-files-len <number>`: Number of largest files to show in summary (default: 5, e.g., --top-files-len 20) ## Repomix Output Options - `-o, --output <file>`: Output file path (default: repomix-output.xml, use "-" for stdout) - `--style <style>`: Output format: xml, markdown, json, or plain (default: xml) - `--parsable-style`: Escape special characters to ensure valid XML/Markdown (needed when output contains code that breaks formatting) - `--compress`: Extract essential code structure (classes, functions, interfaces) using Tree-sitter parsing - `--output-show-line-numbers`: Prefix each line with its line number in the output - `--no-file-summary`: Omit the file summary section from output - `--no-directory-structure`: Omit the directory tree visualization from output - `--no-files`: Generate metadata only without file contents (useful for repository analysis) - `--remove-comments`: Strip all code comments before packing - `--remove-empty-lines`: Remove blank lines from all files - `--truncate-base64`: Truncate long base64 data strings to reduce output size - `--header-text <text>`: Custom text to include at the beginning of the output - `--instruction-file-path <path>`: Path to file containing custom instructions to include in output - `--include-empty-directories`: Include folders with no files in directory structure - `--include-full-directory-structure`: Show entire repository tree in the Directory Structure section, even when using --include patterns - `--no-git-sort-by-changes`: Don't sort files by git change frequency (default: most changed files first) - `--include-diffs`: Add git diff section showing working tree and staged changes - `--include-logs`: Add git commit history with messages and changed files - `--include-logs-count <count>`: Number of recent commits to include with --include-logs (default: 50) ## File Selection Options - `--include <patterns>`: Include only files matching these glob patterns (comma-separated, e.g., "src/**/*.js,*.md") - `-i, --ignore <patterns>`: Additional patterns to exclude (comma-separated, e.g., "*.test.js,docs/**") - `--no-gitignore`: Don't use .gitignore rules for filtering files - `--no-default-patterns`: Don't apply built-in ignore patterns (node_modules, .git, build dirs, etc.) ## Remote Repository Options - `--remote <url>`: Clone and pack a remote repository (GitHub URL or user/repo format) - `--remote-branch <name>`: Specific branch, tag, or commit to use (default: repository's default branch) ## Configuration Options - `-c, --config <path>`: Use custom config file instead of repomix.config.json - `--init`: Create a new repomix.config.json file with defaults - `--global`: With --init, create config in home directory instead of current directory ## Security Options - `--no-security-check`: Skip scanning for sensitive data like API keys and passwords (use with caution; may expose secrets in output) ## Token Count Options - `--token-count-encoding <encoding>`: Tokenizer model for counting: o200k_base (GPT-4o), cl100k_base (GPT-3.5/4), etc. (default: o200k_base) ## MCP Options - `--mcp`: Run as Model Context Protocol server for AI tool integration ## Examples ```bash # Basic usage repomix # Custom output file and format repomix -o my-output.md --style markdown repomix -o my-output.json --style json # Output to stdout repomix --stdout > custom-output.txt # Send output to stdout, then pipe into another command (for example, simonw/llm) repomix --stdout | llm "Please explain what this code does." # Custom output with compression repomix --compress # Process specific files with patterns repomix --include "src/**/*.ts,*.md" --ignore "*.test.js,docs/**" # Remote repository with branch repomix --remote https://github.com/user/repo/tree/main # Remote repository with commit repomix --remote https://github.com/user/repo/commit/836abcd7335137228ad77feb28655d85712680f1 # Remote repository with shorthand repomix --remote user/repo # Using stdin for file list find src -name "*.ts" -type f | repomix --stdin git ls-files "*.js" | repomix --stdin echo -e "src/index.ts\nsrc/utils.ts" | repomix --stdin # Git integration repomix --include-diffs # Include git diffs for uncommitted changes repomix --include-logs # Include git logs (last 50 commits by default) repomix --include-logs --include-logs-count 10 # Include last 10 commits repomix --include-diffs --include-logs # Include both diffs and logs # Token count analysis repomix --token-count-tree repomix --token-count-tree 1000 # Only show files/directories with 1000+ tokens ```