/codebase-pack

/codebase-pack

Собрать concise representation репозитория в один файл — для передачи во внешние LLM-инструменты (ChatGPT, Gemini, агенты с ограниченным доступом к ФС).

Use-case (важно): эта команда не предназначена для consumption Claude Code-агентами. Claude Code уже работает с ФС нативно через Read/Glob/Grep с lazy loading — упаковывать репо в один артефакт и грузить его в контекст агента = впустую тратить токены. Команда оправдана только когда:

• нужно скопировать снимок репо в чат с другой LLM (ChatGPT, Claude.ai web-интерфейс, Gemini)
• репо передаётся коллеге для анализа без доступа к ФС
• готовится prompt для CI/security-скана через сторонний LLM-инструмент

Внутри Claude Code-сессии (включая агентов архитектуры) используй вместо неё /codebase-summary и /codebase-graph — они дают сфокусированный контекст без раздувания токенов.

Goal: Получить один файл-артефакт с упакованным содержимым репозитория, готовый к копированию в external LLM prompt.

Output: Путь к собранному артефакту + метрики (примерное число токенов, размер файла, что включено/исключено).

Scenarios:

• По умолчанию: repomix со встроенной tree-sitter compression + markdown-формат
• --output path — кастомный путь файла
• --include glob / --exclude glob — переопределить дефолтные фильтры
• Если repomix не установлен — вывести инструкцию (npm install -g repomix или npx -y repomix) без попыток ручного fallback (для одного файла из всего репо ручная сборка нерациональна)

Constraints:

• Не упаковывать node_modules, bin, obj, dist, .git, *.lock, бинарники по умолчанию
• Если репозиторий > 100k LoC и пользователь не передал --include — предупредить про размер артефакта и предложить сузить scope
• Не запускать repomix без подтверждения, если он создаст файл > 5MB
• Не предлагать команду как часть архитектурного workflow — для контекста репо у Claude Code есть Read/Glob/Grep