Командний рядок

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 PATH`	Додає до плану елемент Перевірити; це «Однаково включити» із застосунку. Просить підтвердження в терміналі й не працює разом із `--yes`. Можна вказати кілька разів.
`-y, --yes`	Очищає без запитання.
`--json`	Записує план і результат у форматі JSON.

Без шляху використовуються папки, вибрані в застосунку, або поточна папка, якщо застосунок ще не налаштовано. clean очищає лише папки збірки, тимчасові папки агентів і кеші; робочі дерева й дані агентів очищаються в застосунку.

Коли немає термінала, щоб спитати, або задано --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: Запропонована дія для кожного робочого дерева (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 р.