Contributing to Repomix

Thank you for your interest in Repomix! 🚀 We'd love your help to make it even better. This guide will help you get started with contributing to the project.

How to Contribute

• Star the Repository: Show your support by starring the repository!
• Create an Issue: Spot a bug? Have an idea for a new feature? Let us know by creating an issue.
• Submit a Pull Request: Found something to fix or improve? Jump in and submit a PR!
• Spread the Word: Share your experience with Repomix on social media, blogs, or with your tech community.
• Use Repomix: The best feedback comes from real-world usage, so feel free to integrate Repomix into your own projects!
• Sponsor: Support the development of Repomix by becoming a sponsor.

Development Setup

Prerequisites

• Node.js ≥ 22.0.0
• Git
• npm
• Docker (optional, for running the website or containerized development)

Local Development

To set up Repomix for local development:

# Clone repository
git clone https://github.com/yamadashy/repomix.git
cd repomix

# Install dependencies
npm install

# Run CLI
npm run repomix

Nix Development

If you have Nix with flakes enabled, you can enter a reproducible development shell with Node.js 24 and Git pre-installed:

nix develop

Inside the shell, the standard npm workflow works as expected:

npm ci
npm run build
npm run test
npm run lint

Note: This shell is for working on Repomix itself, not for installing it as a CLI.

Docker Development

You can also run Repomix using Docker:

# Build image
docker build -t repomix .

# Run container
docker run -v ./:/app -it --rm repomix

Project Structure

The project is organized into the following directories:

src/
├── cli/          # CLI implementation
├── config/       # Configuration handling
├── core/         # Core functionality
│   ├── file/     # File handling
│   ├── metrics/  # Metrics calculation
│   ├── output/   # Output generation
│   ├── security/ # Security checks
├── mcp/          # MCP server integration
└── shared/       # Shared utilities
tests/            # Tests mirroring src/ structure
website/          # Documentation website
├── client/       # Frontend (VitePress)
└── server/       # Backend API

Development Commands

# Run CLI
npm run repomix

# Run tests
npm run test
npm run test-coverage

# Lint code
npm run lint

Testing

We use Vitest for testing. To run the tests:

# Run tests
npm run test

# Test coverage
npm run test-coverage

# Linting
npm run lint-biome
npm run lint-ts
npm run lint-secretlint

Code Style

• Use Biome for linting and formatting
• Dependency injection for testability
• Keep files under 250 lines
• Add tests for new features

We use Biome for linting and formatting. Please make sure your code follows the style guide by running:

npm run lint

Pull Request Guidelines

Before submitting a Pull Request, please ensure:

1. Your code passes all tests: Run npm run test
2. Your code adheres to our linting standards: Run npm run lint
3. You have updated relevant documentation
4. You follow the existing code style

Website Development

The Repomix website is built with VitePress. To run the website locally:

# Prerequisites: Docker must be installed on your system

# Start the website development server
npm run website

# Access the website at http://localhost:5173/

When updating documentation, you only need to update the English version first. The maintainers will handle translations to other languages.

Release Process

For maintainers and contributors interested in the release process:

1. Update version

npm version patch  # or minor/major

2. Run tests and build

npm run test-coverage
npm run build

3. Publish

npm publish

New versions are managed by the maintainer. If you think a release is needed, open an issue to discuss it.

Need Help?

• Open an issue
• Join Discord