v1.4.1

This maintenance release focuses on improving the --remote option reliability.

Improvements ⚡

Remote Repository Processing (#777, #806)

The --remote option now automatically detects the default branch instead of assuming main:

• Works with repositories using main, master, or custom default branches
• No longer fails on repositories with non-standard default branch names

How to Update

npm update -g repomix

---

As always, if you have any issues or suggestions, please let us know on GitHub issues or our Discord community.

v1.4.0

This release introduces git commit history integration and enhanced binary file detection, making Repomix more informative for AI analysis and user visibility!

What's New 🚀

Git Commit History Integration (#793)

Added the powerful --include-logs option that includes git commit history in the output to help AI systems understand development patterns and file change relationships.

# Include last 50 commits (default)
repomix --include-logs

# Include specific number of commits
repomix --include-logs --include-logs-count 10

# Via configuration file
{
  "output": {
    "git": {
      "includeLogs": true,
      "includeLogsCount": 25
    }
  }
}

Binary File Detection Reporting (#752, #798)

Repomix now reports files detected as binary by content inspection, providing better visibility into excluded files.

📄 Binary Files Detected:
─────────────────────────
3 files detected as binary by content inspection:
1. config/corrupted.txt
2. data/malformed.json  
3. logs/output.log

These files have been excluded from the output.
Please review these files if you expected them to contain text content.

This helps users understand why files with text extensions might be excluded when they contain binary data.

Improvements ⚡

Security Enhancements (#774)

• Secured git command execution with enhanced safety measures

Special thanks to @szepeviktor for these important security improvements!

Internal Changes 🔧

CI/CD Improvements (#778)

• Schema updates on main branch

Special thanks to @BBboy01 for their first contribution with schema updates!

Website Enhancements 🌐

URL Parameter Support (#764, #775)

The Repomix website now supports URL query string parameters, allowing users to:

• Bookmark configurations with preset options
• Share links with predefined settings

Example URLs with preset configurations:

• https://repomix.com/?format=markdown&include=**%2F*.ts&ignore=**%2F*.test.ts
• https://repomix.com/?repo=yamadashy%2Frepomix&format=markdown&include=**%2F*.ts&ignore=**%2F*.test.ts

This makes the web interface more user-friendly and shareable.

How to Update

npm update -g repomix

---

As always, if you have any issues or suggestions, please let us know on GitHub issues or our Discord community.

v1.3.0

This release introduces token count analysis tools and MCP server enhancements, making it easier to analyze and optimize your codebase processing.

What's New 🚀

Token Count Summarization (#747)

Added the powerful --token-count-tree option that displays token usage in a hierarchical tree view! This feature helps identify which files and directories consume the most tokens, making it easier to optimize your Repomix output.

repomix --token-count-tree

Displays a tree structure showing token usage:

🔢 Token Count Tree:
────────────────────
├── tsconfig.json (177 tokens)
├── typos.toml (80 tokens)
├── vitest.config.ts (89 tokens)
├── .agents/ (2874 tokens)
│   └── rules/ (2874 tokens)
│       ├── base.md (1988 tokens)
│       ├── browser-extension.md (453 tokens)
│       └── website.md (433 tokens)

You can also set a minimum threshold to only show files above a certain token count:

repomix --token-count-tree 1000

Special thanks to @gudber for this incredibly useful feature!

MCP Server: Attach Packed Output Tool (#756)

Added the attach_packed_output tool to the MCP server, enabling AI assistants to import and analyze previously generated Repomix XML files.

This tool accepts either a directory containing repomix-output.xml or a direct path to an XML file, providing the same structured analysis capabilities as freshly packed repositories without the need to reprocess the codebase.

For detailed MCP documentation, see:
https://github.com/yamadashy/repomix?tab=readme-ov-file#available-mcp-tools

Special thanks to @petrarca for this valuable MCP enhancement!

How to Update

npm update -g repomix

---

As always, if you have any issues or suggestions, please let us know on GitHub issues or our Discord community.

v1.2.1

This release focuses on critical performance improvements and memory management optimization for large codebases.

Improvements ⚡️

Memory Management & Performance Optimization (#749, #748)

Comprehensive memory management overhaul for better performance with large codebases and long-running processes. Particularly beneficial when using Repomix as a library in applications that process multiple repositories.

• Worker process isolation: All heavy operations (file search, processing, metrics calculation) now run in isolated child processes to prevent memory accumulation
• Comprehensive resource cleanup: Improved worker pool management and automatic resource disposal across all operations

Error Handling Improvements (#739, #746)

Enhanced error handling and performance optimizations to improve reliability:

• Better error messages and debugging information
• Improved template compilation error handling for large files

How to Update

npm update -g repomix

---

As always, if you have any issues or suggestions, please let us know on GitHub issues or our Discord community.

v1.2.0

This release brings token optimization and MCP Structured Output support, making Repomix more efficient and reliable for AI integration!

What's New 🚀

Automatic Base64 Data Truncation for Token Savings (#733)

The new truncateBase64 option automatically shortens long Base64-encoded data like embedded images.

# Enable the option
repomix --truncate-base64

# Enable in config file
{
  "output": {
    "truncateBase64": true
  }
}

This feature significantly reduces token usage when processing repositories containing data URI images and other binary data.

• Data URI: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAB...
• Base64 strings: VGhlIHF1aWNrIGJyb3duIGZveCBqdW1w...

Special thanks to @hand-dot for this contribution! 🎉

MCP Structured Output Support (#719)

Now supports the MCP Structured Output specification.

• Tool outputs are now strictly defined with JSON Schema, ensuring AI models can parse structured data reliably

Documentation 📚

Real-world Use Cases

Added "Real-World Use Cases" to the website. Features practical scenarios for actual development environments including bug investigation, security audits, documentation generation, and new member onboarding.

https://repomix.com/guide/use-cases

How to Update

npm update -g repomix

---

As always, if you have any questions or suggestions, please let us know on GitHub Issues or our Discord community.

v1.1.0

This release brings Bun runtime support to Repomix!

What's New 🚀

Bun Runtime Support (#716)

Repomix now officially supports Bun runtime! You can now use bunx repomix@latest to run Repomix with Bun's superior performance.

# Run with Bun
bunx repomix@latest

# Or explicitly with bun command
bun --bun repomix@latest

# Traditional: Run with Node.js
npx repomix@latest

We've also migrated from Piscina to Tinypool for worker thread management, achieving a 700KB reduction in bundle size while maintaining full API compatibility and performance.

How to Update

# With npm
npm update -g repomix

# With Bun
bun add -g repomix

---

As always, if you have any issues or suggestions, please let us know on GitHub issues or our Discord community.

v1.0.0

We're excited to announce the v1.0 release! 🎉

While v1.0 may seem like a major milestone, this release is actually no different from our regular version updates.
We've reached a point where core functionality is complete, performance is stable, and we have no plans for breaking changes—making this the right time for a major version.

Version 1.0 doesn't mean Repomix is perfect or complete.
We've received many feature requests and still have significant features planned for future releases.
None of this would have been possible without our contributors, users, and sponsors.
Thank you, and we look forward to continuing this journey together!

New Features 🚀

Enhanced stdin Support (#648, #650, #653, #680)

A new --stdin flag allows you to process file lists directly from the command line.
This enables more flexible integration with shell pipelines and scripts.

# Select files with find command
find src -name "*.ts" -type f | repomix --stdin

# Get tracked files with git
git ls-files "*.ts" | repomix --stdin

# Search files with specific content using ripgrep
rg -l "TODO|FIXME" --type ts | repomix --stdin

# Interactive file selection with fzf
find . -name "*.ts" -type f | fzf -m | repomix --stdin

• Read file lists from stdin with the --stdin flag
• Apply include/ignore pattern filtering to stdin file lists

For more details, see the documentation: https://repomix.com/guide/usage#file-list-input-stdin

Remote Repository Processing (--remote) Improvements (#658)

GitHub repository processing is now more reliable.

• Introduced archive download priority with git clone fallback mechanism
• Archive downloads work in environments without git commands and make --remote processing faster

Improvements ⚡

Conditional Summary Display (#682)

• Summary purpose display can now be conditionally controlled based on file selection

Special thanks to @eriknygren for this contribution!

Performance Optimizations (#645, #654)

• Optimized token counting for top files display by calculating only the necessary files based on file size instead of processing all files

Security Enhancements (#678)

• Stopped outputting secretlint results to the terminal. This prevents key leakage when coding agents and similar tools use repomix

Bug Fixes 🐛

Remote Repository Processing (#673, #684)

• Prevented unnecessary file copying in stdout mode and improved processing efficiency

Breaking Changes ⚠️

Node.js Requirements Update (#698)

• Ended support for Node.js 18, now requires Node.js 20 or higher
  • This enables more stable operation and the use and addition of modern features

Internal Changes 🔧

Security and Maintenance Improvements (#651)

• Enhanced security by pinning GitHub Actions to commit SHAs
  • Mitigated supply chain attack vectors and improved workflow reliability

Special thanks to @LordMelkor for this contribution!

Dependency and Build Improvements (#649)

• Added git-up and @secretlint/types to fix pnpm build errors

Special thanks to @sztu-wtr for this contribution!

Performance Optimizations (#677)

• Reduced overhead by using node --run instead of npm run

Special thanks to @yoshi-taka for this contribution!

How to Update

npm update -g repomix

Or use the latest version directly:

npx repomix@latest

---

If you have any questions or suggestions, please let us know on GitHub issues or our Discord community.

v0.3.9

This release brings important improvements to CLI reliability and enhanced documentation for power users.

What's New 🚀

CLI Exit Code Enhancement (#632)

Repomix now properly sets exit codes when operations fail, significantly improving CI/CD integration and error handling workflows. This enhancement ensures that build pipelines and automation scripts can correctly detect and respond to Repomix failures.

Special thanks to @sakamossan for implementing this important feature!

How to Update

npm update -g repomix

---

As always, if you have any issues or suggestions, please let us know on GitHub issues or our Discord community.

v0.3.8

This release brings major updates including browser extension support, extensive multilingual expansion, and enhanced mobile experience.

What's New 🚀

Browser Extension (#612)

Introducing a browser extension that provides instant access to Repomix from any GitHub repository! The Chrome extension adds a convenient "Repomix" button to GitHub repository pages.

Installation

• Chrome Extension: Repomix - Chrome Web Store
• Firefox Add-on: Repomix - Firefox Add-ons

Key Features

• One-click access to any GitHub repository
• More exciting features coming soon!

Website: Open with your app (#616)

📱 You can now send Repomix output directly to Claude or Gemini on mobile!

Perfect when you're on the go and need to analyze a GitHub repo fast — just tap "Open with your app" to share it to your favorite chat app.

Try it on repomix.com!

repomix-open-with-your-app.mp4

.jsonc and .json5 Configuration File Support (#620)

Added support for .jsonc and .json5 configuration file extensions with priority ordering.

// repomix.jsonc or repomix.json5
{
  // Comments are now supported!
  "include": ["src/**"],
  "exclude": ["**/*.test.js"]
}

Documentation 📚

Multilingual Support Expansion (#602, #603, #607)

Added three new languages to the website:

• Indonesian (id): Bahasa Indonesia support
• Vietnamese (vi): Tiếng Việt support
• Hindi (hi): हिन्दी support

This brings our total language support to 12 languages.

How to Update

npm update -g repomix

---

As always, if you have any issues or suggestions, please let us know on GitHub issues or our Discord community.

v0.3.7

This release brings major enhancements to the MCP (Model Context Protocol) server and improved remote repository handling.

What's New 🚀

MCP Tool Grep Functionality (#590)

We've added a powerful grep_repomix_output tool to the Repomix MCP server! This feature enables AI assistants to perform advanced searches within packaged codebases. Additionally, the read_repomix_output tool now supports partial content retrieval.

This functionality allows AI assistants to efficiently search for specific patterns in codebases and retrieve results with surrounding context.
By combining the grep_repomix_output and read_repomix_output tools, repository analysis is now possible without fetching the entire output, making it particularly useful for analyzing medium to large-scale repositories.

For MCP setup instructions, see:
https://github.com/yamadashy/repomix?tab=readme-ov-file#mcp-server-integration

Improvements ⚡

CLI Help Group Feature Implementation (#578)

The CLI help display has been improved. Options are now organized into logical groups for better usability:

$ repomix -h
Usage: repomix [options] [directories...]

Repomix - Pack your repository into a single AI-friendly file

Arguments:
  directories                        list of directories to process (default: ["."])

Basic Options
  -v, --version                      show version information

Output Options
  -o, --output <file>                specify the output file name
  --stdout                           output to stdout instead of writing to a file
  --style <type>                     specify the output style (xml, markdown, plain)
  --parsable-style                   by escaping and formatting, ensure the output is parsable as a
                                     document of its type
  --compress                         perform code compression to reduce token count
  
Filter Options
  --include <patterns>               list of include patterns (comma-separated)
  -i, --ignore <patterns>            additional ignore patterns (comma-separated)

...

Enhanced Remote Repository Reference Handling (#583, #592)

Remote repository processing has become more robust with improved URL handling:

• The --remote option now handles URLs more precisely by reading refs to correctly distinguish between branch names and folder paths
• Proper identification and processing of remote branches and tags
• Better handling of repository paths and subdirectories

How to Update

npm update -g repomix

---

As always, if you have any issues or suggestions, please let us know on GitHub issues or our Discord community.