Repomix

^{Special thanks to:}

Warp, built for coding with multiple AI agents
Available for MacOS, Linux, & Windows

Tuple, the premier screen sharing app for developers on macOS and Windows.

🏆 Номинация на Open Source Awards ​

Мы польщены! Repomix был номинирован в категории Powered by AI на JSNation Open Source Awards 2025.

Это было бы невозможно без всех вас, кто использует и поддерживает Repomix. Спасибо!

Что такое Repomix? ​

Repomix — это мощный инструмент, который упаковывает всю вашу кодовую базу в один файл, удобный для ИИ. Работаете ли вы над код-ревью, рефакторингом или получаете помощь ИИ в вашем проекте — Repomix упрощает передачу контекста всего репозитория инструментам ИИ.

Быстрый старт ​

После создания упакованного файла (repomix-output.xml) с помощью Repomix вы можете отправить его ИИ-ассистенту (например, ChatGPT, Claude) с промптом вроде:

Этот файл содержит все файлы репозитория, объединённые в один.
Я хочу провести рефакторинг кода, поэтому сначала проверьте его.

ИИ проанализирует всю вашу кодовую базу и предоставит комплексную информацию:

При обсуждении конкретных изменений ИИ может помочь с генерацией кода. С такими функциями, как Claude Artifacts, вы можете получить несколько взаимосвязанных файлов:

Успешного кодирования! 🚀

Почему Repomix? ​

Сила Repomix заключается в способности работать с любым сервисом подписки, таким как ChatGPT, Claude, Gemini, Grok, не беспокоясь о расходах, при этом предоставляя полный контекст кодовой базы, что устраняет необходимость в исследовании файлов — делая анализ быстрее и зачастую точнее.

Имея всю кодовую базу в качестве контекста, Repomix позволяет выполнять широкий спектр задач, включая планирование реализации, исследование багов, проверки безопасности сторонних библиотек, генерацию документации и многое другое.

Использование CLI-инструмента ​

Repomix можно использовать как инструмент командной строки с мощными функциями и опциями настройки.

CLI-инструмент имеет доступ к приватным репозиториям, так как использует ваш локально установленный git.

Быстрый старт ​

Вы можете сразу попробовать Repomix в директории вашего проекта без установки:

npx repomix@latest

Или установите глобально для многократного использования:

# Установка с помощью npm
npm install -g repomix

# Альтернативно с помощью yarn
yarn global add repomix

# Альтернативно с помощью bun
bun add -g repomix

# Альтернативно с помощью Homebrew (macOS/Linux)
brew install repomix

# Затем запустите в любой директории проекта
repomix

Готово! Repomix создаст файл repomix-output.xml в текущей директории, содержащий весь ваш репозиторий в формате, удобном для ИИ.

Использование ​

Для упаковки всего репозитория:

repomix

Для упаковки конкретной директории:

repomix path/to/directory

Для упаковки конкретных файлов или директорий с использованием glob-паттернов:

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

Для исключения конкретных файлов или директорий:

repomix --ignore "**/*.log,tmp/"

Для упаковки удалённого репозитория:

# Используя сокращённый формат
npx repomix --remote yamadashy/repomix

# Используя полный URL (поддерживает ветки и конкретные пути)
npx repomix --remote https://github.com/yamadashy/repomix
npx repomix --remote https://github.com/yamadashy/repomix/tree/main

# Используя URL коммита
npx repomix --remote https://github.com/yamadashy/repomix/commit/836abcd7335137228ad77feb28655d85712680f1

Для создания нового файла конфигурации (repomix.config.json):

repomix --init

После создания упакованного файла вы можете использовать его с генеративными ИИ-инструментами, такими как Claude, ChatGPT и Gemini.

Использование Docker ​

Вы также можете запустить Repomix с помощью Docker 🐳 Это полезно, если вы хотите запустить Repomix в изолированной среде или предпочитаете контейнеры.

Базовое использование (текущая директория):

docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix

Для упаковки конкретной директории:

docker run -v .:/app -it --rm ghcr.io/yamadashy/repomix path/to/directory

Обработка удалённого репозитория с выводом в директорию output:

docker run -v ./output:/app -it --rm ghcr.io/yamadashy/repomix --remote https://github.com/yamadashy/repomix

Форматы вывода ​

Выберите предпочтительный формат вывода:

# Формат XML (по умолчанию)
repomix --style xml

# Формат Markdown
repomix --style markdown

# Формат JSON
repomix --style json

# Простой текст
repomix --style plain

Настройка ​

Создайте файл repomix.config.json для постоянных настроек:

{
  "output": {
    "style": "markdown",
    "filePath": "custom-output.md",
    "removeComments": true,
    "showLineNumbers": true,
    "topFilesLength": 10
  },
  "ignore": {
    "customPatterns": ["*.test.ts", "docs/**"]
  }
}

Реальные сценарии использования ​

Рабочий процесс генерации кода с LLM ​

Разработчик делится тем, как он использует Repomix для извлечения контекста кода из существующих кодовых баз, а затем использует этот контекст с LLM, такими как Claude и Aider, для постепенных улучшений, код-ревью и автоматической генерации документации.

Создание пакетов знаний для LLM ​

Авторы используют Repomix для упаковки своего письменного контента — блогов, документации и книг — в форматы, совместимые с LLM, что позволяет читателям взаимодействовать с их экспертизой через системы вопросов и ответов на основе ИИ.

Узнать больше о сценариях использования →

Руководство для продвинутых пользователей ​

Repomix предлагает мощные функции для продвинутых сценариев использования. Вот некоторые важные руководства для опытных пользователей:

• MCP-сервер — Интеграция Model Context Protocol для ИИ-ассистентов
• GitHub Actions — Автоматизация упаковки кодовой базы в CI/CD-процессах
• Сжатие кода — Интеллектуальное сжатие на основе Tree-sitter (~70% сокращение токенов)
• Использование как библиотеки — Интеграция Repomix в ваши Node.js-приложения
• Пользовательские инструкции — Добавление собственных промптов и инструкций в вывод
• Функции безопасности — Встроенная интеграция Secretlint и проверки безопасности
• Лучшие практики — Оптимизация рабочих процессов с ИИ с помощью проверенных стратегий

Дополнительные примеры ​