Командная строка

devbroom переносит сканирование приложения в терминал: те же вердикты, те же причины. Сканирование ничего не удаляет, не перемещает и не меняет; очистка выполняется отдельной командой.

Командная строка бесплатна. Сканирование только читает. devbroom clean делает то же, что кнопка «Очистить» в приложении: сначала показывает элементы «Готово», спрашивает, а затем перемещает их в Корзину. Защиты, заданные в приложении, действуют и здесь.

Установка

devbroom входит в приложение; дополнительно ничего устанавливать не нужно. Нажмите «Подключить devbroom» в Настройки › Агенты и интеграции, и команда будет связана как ~/.local/bin/devbroom. Если приложение лежит не в папке «Программы», сначала переместите его туда, иначе ссылка сломается. Затем откройте новый терминал и проверьте версию.

Терминал

$ devbroom --versiondevbroom 0.1.0

Если ~/.local/bin нет в PATH вашей оболочки, запускайте команду по полному пути или добавьте эту папку в PATH.

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

devbroom [scan] [ПУТЬ...] [параметры]devbroom clean [ПУТЬ...] [--dry-run] [--delete] [--include-review ПУТЬ]... [--yes] [--json]devbroom status [--json]devbroom mcpdevbroom compat

Без пути сканируется текущая папка. Можно указать несколько путей. Данные агентов в вашей домашней папке входят в каждое сканирование.

Примеры

$ devbroom                        # текущая папка$ devbroom ~/projects ~/work      # несколько папок$ devbroom ~/projects --details   # со всеми причинами$ devbroom ~/projects --all       # все элементы, а не только крупнейшие

Параметры

Параметр	Что делает
`-d, --details`	Показывает все причины каждого вердикта.
`-a, --all`	Выводит все найденные элементы, а не только крупнейшие.
`--json`	Выводит весь отчёт в формате JSON.
`--no-color`	Отключает цвета. Цвета не используются и тогда, когда задана `NO_COLOR`.
`-h, --help`	Показывает справку.
`-V, --version`	Показывает версию.
`--`	Всё, что после него, считается путём: `devbroom -- -odd-folder`

Неизвестный параметр считается ошибкой, и ничего не сканируется.

Очистка

devbroom clean сканирует, составляет свежий план из элементов «Готово», показывает его и только после вашего согласия перемещает эти папки в Корзину. Выполненное появляется в Истории приложения; если в приложении уже идёт очистка, команда не ждёт, а завершается.

Терминал

$ devbroom clean ~/projects --dry-run   # только показать$ devbroom clean ~/projects             # показать, спросить, переместить в Корзину

Параметр	Что делает
`-n, --dry-run`	Показывает план и ничего не меняет.
`--delete`	Удаляет навсегда вместо перемещения в Корзину. Недоступен, если ваша организация отключила удаление навсегда.
`--include-review ПУТЬ`	Добавляет в план элемент «Проверить»; аналог «Всё равно включить» в приложении. Запрашивает подтверждение в терминале и не сочетается с `--yes`. Можно указать несколько раз.
`-y, --yes`	Очищает без вопросов.
`--json`	Выводит план и результат в формате JSON.

Без пути используются папки, выбранные в приложении, или текущая папка, если приложение ещё не настраивалось. clean очищает только папки сборки, временные папки агентов и кеши; worktree и данные агентов очищаются в приложении.

Когда спросить в терминале некого или указан --yes, команда строже: элементы, которые получили «Готово» только благодаря собственному .devbroom.toml проекта, в план не попадают, ведь этот файл мог написать агент. Без терминала и без --yes ничего не меняется.

Состояние

devbroom status показывает последнее сканирование приложения, не сканируя заново: сколько готово к очистке, сколько минут назад было сканирование и крупнейшие элементы «Готово». --json выдаёт то же в формате JSON. Если приложение ещё не сканировало, это ошибка.

MCP для агентов

devbroom mcp это MCP-сервер. Claude Code, Codex или Cursor могут прочитать последнее сканирование, спросить, почему папка получила «Готово» или «Заблокировано», и попросить вас об очистке; запрос приходит вам в приложение, и сам сервер никогда ничего не очищает. Настройка описана на странице Интеграции.

Как читать вывод

Отчёт выводится на английском и состоит из четырёх частей. Каждая строка начинается с вердикта элемента.

devbroom ~/projects

$ devbroom ~/projectsDevbroom scan (read-only) ~/projects in 22.4sAgent data on this Mac  Claude Code 2.1.288   37.8 GB  297 sessions, 2 running  Codex 0.159.2          746 MB  41 sessions  Orca 1.4.215           528 MBCleanup potential  READY    19.7 GB  56 items  every check passed  REVIEW   16.9 GB  39 items  worth a look before cleaning  BLOCKED  19.1 GB   5 items  in use or holding work

Agent data on this Mac: Агенты на этом Mac: версия, занятое место, число сессий, сколько из них для папок, которых больше нет, и сколько запущено.
Cleanup potential: Общий размер и число элементов для каждого вердикта.
Worktrees: Предлагаемое действие для каждого worktree (remove, prune, repair) и его вердикт.
Largest items: Крупнейшие элементы с причинами. --all показывает все.

Вердикты

Командная строка использует те же четыре вердикта, что и приложение, заглавными буквами и на английском.

В выводе	Что означает
READYГотово	Все проверки для этого действия пройдены.
REVIEWПроверить	Известный риск или решение, которое можете принять только вы; например, игнорируемый файл `.env`.
BLOCKEDЗаблокировано	Используется, защищено или хранит работу, которую git откажется выбросить.
UNKNOWNНеизвестно	Недостаточно данных. Никогда не считается «Готово».

Вывод JSON

--json выводит весь отчёт; это удобно для скриптов и непрерывной интеграции. Версия формата задаётся полем schema_version, сейчас это 1. Когда запрошен JSON, строка прогресса не выводится.

Терминал

$ devbroom ~/projects --json > report.json$ head -3 report.json{  "schema_version": 1,  …

Совместимость

devbroom compat показывает, какие версии агентов проверены в Devbroom и какие установлены на вашем Mac.

devbroom compat

Claude Code  tested: 2.1.0 to 2.1.292     here: 2.1.288 · verifiedCodex        tested: 0.115.0 to 0.159.2   here: 0.159.2 · verifiedCursor       tested: none yet             here: not on this MacOpenCode     tested: none yet             here: not on this MacOrca         tested: 1.4.0 to 1.4.221     here: 1.4.215 · verified

Если ваша версия вне проверенного диапазона, но файлы агента в ожидаемом формате, Devbroom работает и отмечает её как «ещё не проверена». Если формат не совпадает, данные этого агента только читаются, и ничего из них не считается готовым к очистке.

Коды выхода

Код	Значение
`0`	Готово.
`1`	Ошибка.
`2`	Неверное использование: неизвестный параметр или путь, который не является папкой.
`3`	`clean`: не подтверждено, ничего не изменено.
`4`	`clean`: выполнено частично.
`5`	`clean`: уже идёт другая очистка.
`6`	`clean`: запрещено политикой вашей организации.
`130`	Отменено (Ctrl-C).

Ctrl-C останавливает сканирование; повторное Ctrl-C сразу завершает команду.

Переменные окружения

Переменная	Действие
`NO_COLOR`	Если задана, вывод без цветов.
`CLAUDE_CONFIG_DIR`	Если папка настроек Claude Code находится не в `~/.claude`, она читается отсюда.
`CLAUDE_CODE_TMPDIR`	Если вы перенесли временную папку Claude Code, она читается отсюда.
`CODEX_HOME`	Если папка Codex находится не в `~/.codex`, она читается отсюда.
`CURSOR_CONFIG_DIR`	Если папка Cursor находится не в `~/.cursor`, она читается отсюда.
`XDG_DATA_HOME`, `XDG_CACHE_HOME`, `OPENCODE_DB`	Если данные и база данных OpenCode лежат в другом месте, они читаются оттуда.

НазадПравила ДалееИнтеграции

Обновлено: 7 октября 2026 г.