Plumb CLI
Хуки git и скилл Claude Code собирают решения из коммитов и переписок с агентом и возвращают их в спецификацию и тесты.
- 148 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Диффы и переписки агентов отправляются выбранному поставщику модели.
- Хуки git меняют поведение коммитов и могут остановить их.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/plumbОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Диффы и переписки агентов отправляются выбранному поставщику модели.
- Хуки git меняют поведение коммитов и могут остановить их.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Plumb, CLI на Python, следит, чтобы спецификация, тесты и код не расходились при работе с ИИ-агентом. Он читает изменения в индексе git и переписки агентов, находит принятые решения, например выбор кэша или смену контракта API, и записывает их в журнал только на добавление. Есть два режима. В режиме проверки коммит останавливается, пока пользователь не утвердит, отклонит или проигнорирует каждое решение. В режиме записи коммит проходит сразу, а решения извлекает фоновый процесс. Команда `plumb sync` вносит утвержденные решения в спецификацию и тесты.
Для кого. Разработчикам, которые коммитят вместе с Claude Code или Codex и замечают, что спецификация отстает от кода и решения остаются в чате.
Подходит, если
- Агент часто коммитит, и спецификация перестает отражать код.
- Перед спорным решением нужно посмотреть записанные прежние решения через `plumb search`.
- Команда держит спецификацию как договор и сверяет с ней каждый коммит.
- Тесты покрывают уже не то поведение, которое договорились сделать.
Не подходит, если
- Проект без письменной спецификации и без тестов.
- Нельзя отправлять диффы и переписки агента внешнему поставщику модели.
- Нужен зрелый продукт: сам автор называет Plumb ранней альфой.
Пример запроса к агенту
Установи Plumb, запусти `plumb init`, выбери режим записи и после следующей серии коммитов покажи журнал решений через `plumb log`.Ограничения
Автор описывает инструмент как демонстрацию с ранней стадией разработки. По умолчанию анализ идет через модель Haiku от Anthropic и требует `ANTHROPIC_API_KEY`; другого поставщика задают командой `plumb model`. Диффы и переписки уходят выбранному поставщику. Хуки pre-commit и post-commit меняют обычный ход коммита. Состояние в `.plumb/` советуют коммитить вместе с кодом. Качество найденных решений зависит от выбранной модели и от того, насколько подробно агент объяснял выбор в переписке.
Как отключить. Удалите хуки git, блок Plumb в `CLAUDE.md` и `AGENTS.md`, скилл `.claude/skills/plumb` и каталог `.plumb/`, затем снимите пакет `plumb-dev`.
Частые вопросы
Чем режим проверки отличается от режима записи?
Первый блокирует коммит, пока нет решения по каждому пункту. Второй ничего не блокирует: решения извлекает фоновый процесс уже после коммита.
Что создает `plumb init`?
Каталог `.plumb/` для состояния, хуки pre-commit и post-commit, блок в `CLAUDE.md` и `AGENTS.md`, скилл Claude Code и файл `.plumbignore`.
Какую модель использует?
По умолчанию Haiku от Anthropic с ключом `ANTHROPIC_API_KEY`. Другого поставщика выбирают командой `plumb model`, тогда нужен его ключ.
С какими агентами работает?
README называет Claude Code, Codex, Pi и Copilot CLI. Скилл в репозитории написан для Claude Code.
Как отключить блокировку коммитов?
Переключите режим командой `plumb mode record`: тогда коммит никогда не блокируется. Агенты могут задать режим на один запуск через переменную `PLUMB_MODE`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПлагин для Claude Code: вы читаете одну спецификацию, параллельные агенты реализуют ее до коммита с зелеными тестами.
CLI хранит спецификацию, задачи и доказательства готовности в git, чтобы Claude, Codex, Grok и Cursor передавали работу друг другу
Скилл Claude Code ведет сложную задачу по циклу исследования, плана, исполнения и разбора, записывая каждое решение на диск.
Плагин из трех скиллов для крупных задач разработки: анализ проекта, разбивка на фазы с задачами в GitHub Issues, параллельные агенты и ревью кода
Плагин Claude Code для разработки с разделением ролей: спецификация, ревью, TDD, QA и верификация разными агентами
Методы для агента в одном CLI: сравнение вариантов, разбор проблем и правки кода по шагам, всего 20 слэш-команд.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Plumb (эта карточка) | нет | 148 | |
| OpenSpec | нет | 74 784 | ведет разработку от предложения и требований к коду; Plumb собирает решения из уже сделанных коммитов и вносит их обратно в спецификацию |
| Autospec | нет | 148 | ведет разработку по спецификации от описания до реализации; Plumb следит за расхождением спецификации и кода после коммитов |
Коротко о README
Plumb иллюстрирует идею треугольника спецификации, тестов и кода. Решения извлекаются из диффов и переписок, а журнал решений хранится в репозитории.