Command Line Options

Basic Options

• -v, --version: Show tool version

Output Options

• -o, --output <file>: Output file name (default: repomix-output.txt)
• --style <type>: Output style (plain, xml, markdown) (default: xml)
• --parsable-style: Enable parsable output based on the chosen style schema (default: false)
• --compress: Perform intelligent code extraction, focusing on essential function and class signatures while removing implementation details. For more details and examples, see Code Compression Guide.
• --output-show-line-numbers: Add line numbers (default: false)
• --copy: Copy to clipboard (default: false)
• --no-file-summary: Disable file summary (default: true)
• --no-directory-structure: Disable directory structure (default: true)
• --remove-comments: Remove comments (default: false)
• --remove-empty-lines: Remove empty lines (default: false)
• --header-text <text>: Custom text to include in the file header
• --instruction-file-path <path>: Path to a file containing detailed custom instructions
• --include-empty-directories: Include empty directories in the output (default: false)

Filter Options

• --include <patterns>: Include patterns (comma-separated)
• -i, --ignore <patterns>: Ignore patterns (comma-separated)
• --no-gitignore: Disable .gitignore file usage
• --no-default-patterns: Disable default patterns

Remote Repository Options

• --remote <url>: Process remote repository
• --remote-branch <name>: Specify the remote branch name, tag, or commit hash (defaults to repository default branch)

Configuration Options

• -c, --config <path>: Custom config file path
• --init: Create config file
• --global: Use global config

Security Options

• --no-security-check: Disable security check (default: true)

Token Count Options

• --token-count-encoding <encoding>: Specify token count encoding (e.g., o200k_base, cl100k_base) (default: o200k_base)

Other Options

• --top-files-len <number>: Number of top files to show (default: 5)
• --verbose: Enable verbose logging
• --quiet: Disable all output to stdout

Examples

# Basic usage
repomix

# Custom output
repomix -o output.xml --style xml

# Custom output with compression
repomix --compress

# Process specific files
repomix --include "src/**/*.ts" --ignore "**/*.test.ts"

# 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