명령줄

devbroom은 앱의 스캔을 터미널로 가져옵니다. 같은 판정, 같은 근거입니다. 스캔은 아무것도 지우거나 옮기거나 바꾸지 않으며, 정리는 별도의 명령입니다.

설치

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       # 큰 것만이 아니라 전부

옵션

알 수 없는 옵션은 오류이며, 아무것도 스캔하지 않습니다.

정리

devbroom clean은 스캔하고, 준비됨 항목으로 새 계획을 만들어 보여 준 뒤, 승인을 받고 나서야 해당 폴더를 휴지통으로 옮깁니다. 수행한 작업은 앱의 기록에 나타납니다. 앱에서 이미 정리가 진행 중이면 기다리지 않고 종료합니다.

$ devbroom clean ~/projects --dry-run   # 보여 주기만 함$ devbroom clean ~/projects             # 보여 주고, 묻고, 휴지통으로 이동

경로를 지정하지 않으면 앱에서 고른 폴더를 사용하고, 앱을 설정한 적이 없으면 현재 폴더를 사용합니다. clean은 빌드 폴더, 에이전트의 임시 폴더, 캐시만 정리합니다. 워크트리와 에이전트 데이터는 앱에서 정리합니다.

물어볼 터미널이 없거나 --yes를 지정하면 더 엄격해집니다. 프로젝트 자체의 .devbroom.toml 때문에만 준비됨인 항목은 계획에서 빠집니다. 그 파일은 에이전트가 썼을 수도 있기 때문입니다. 터미널도 없고 --yes도 없으면 아무것도 바뀌지 않습니다.

상태

devbroom status는 다시 스캔하지 않고 앱의 마지막 스캔 결과를 보여 줍니다. 정리할 준비가 된 용량, 몇 분 전에 스캔했는지, 가장 큰 준비됨 항목입니다. --json은 같은 내용을 JSON으로 출력합니다. 앱이 아직 스캔하지 않았다면 오류입니다.

에이전트를 위한 MCP

devbroom mcp는 MCP 서버입니다. Claude Code, Codex, Cursor가 마지막 스캔 결과를 읽고, 어떤 폴더가 왜 준비됨이나 차단됨인지 묻고, 정리를 요청할 수 있습니다. 요청은 앱에서 사용자에게 전달되며, 스스로 정리하는 일은 절대 없습니다. 설정 방법은 연동 페이지에 있습니다.

출력 읽기

보고서는 영어로 작성되며 네 부분으로 이루어집니다. 각 줄은 항목의 판정으로 시작합니다.

$ 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로 전부 볼 수 있습니다.

판정

명령줄은 앱과 같은 네 가지 판정을 대문자로 씁니다.

JSON 출력

--json은 전체 보고서를 출력하며, 스크립트와 지속적 통합(CI)에 적합합니다. 형식은 schema_version 필드로 버전이 관리되며, 현재는 1입니다. JSON을 요청하면 진행 상황 줄은 출력하지 않습니다.

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

호환성

devbroom compat는 Devbroom이 테스트한 에이전트 버전과 Mac에 설치된 버전을 보여 줍니다.

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은 동작하며 “아직 테스트되지 않음”으로 표시합니다. 형식이 맞지 않으면 그 에이전트의 데이터는 읽기만 하며, 어느 것도 정리 준비됨으로 간주하지 않습니다.

종료 코드

Ctrl-C는 스캔을 멈추고, 한 번 더 누르면 즉시 종료합니다.

환경 변수

최종 업데이트: 2026년 10월 7일