시작하기

설정은 몇 분이면 끝납니다. 첫 스캔은 읽기만 합니다. 무엇을 찾았는지, 왜 그렇게 판정했는지 보여 주며, 확인하기 전에는 아무것도 건드리지 않습니다.

다운로드와 설치

다운로드 페이지에서 .dmg를 받아 열고, Devbroom을 응용 프로그램 폴더로 드래그하세요. 앱은 그곳에서 실행합니다.

Devbroom은 새 버전을 스스로 확인합니다. 실행 8초 후 한 번, 저희가 게시하는 latest.json 파일을 읽습니다. 새 버전이 있으면 먼저 묻고, “설치”를 누르면 서명을 확인한 뒤 설치합니다. 사용자에 관한 정보는 보내지 않습니다. 자세한 내용은 개인정보 페이지를 참고하세요.

폴더 고르기

처음 실행하면 Devbroom이 프로젝트가 어디 있는지 묻습니다. 코드가 있는 폴더를 고르거나 끌어다 놓으세요. 나중에 설정 › 폴더에서 추가하거나 뺄 수 있습니다.

에이전트 전용 폴더는 추가할 필요가 없습니다. 홈 폴더에 있는 에이전트 폴더(~/.claude, ~/.codex 등)는 모든 스캔에 포함됩니다.

전체 디스크 접근 권한

데스크탑, 문서, 다운로드처럼 macOS가 보호하는 폴더를 읽을 수 없으면 Devbroom이 “폴더 1개에 전체 디스크 접근 권한이 필요합니다.”라고 알려 줍니다. 버튼을 누르면 시스템 설정 › 개인정보 보호 및 보안 › 전체 디스크 접근 권한으로 이동하며, 그곳에서 Devbroom을 켜면 됩니다. 이 권한은 선택 사항입니다. 권한이 없으면 Devbroom은 해당 폴더를 읽지 못할 뿐입니다.

첫 스캔

폴더를 고르면 스캔이 시작됩니다. 스캔은 읽기만 합니다. git 저장소와 워크트리, 에이전트 폴더, 빌드 결과물, 개발 도구 캐시를 찾고, 각각이 디스크에서 실제로 차지하는 공간을 측정하며, 아직 실행 중인 에이전트를 확인합니다.

버블 읽기

저장 공간 화면에서는 찾은 것이 모두 차지하는 공간만 한 크기의 버블이 됩니다. 버블마다 판정이 붙고 해당 무더기로 모입니다.

버블을 클릭하면 판정의 근거를 볼 수 있습니다. 어느 에이전트의 것인지, 사용 중인지, 저장되지 않은 작업이 있는지. 내부 보기로 폴더 내용을 볼 수 있습니다. 모든 판정은 판정 페이지에 있습니다.

정리

1. 정리를 누르세요. Devbroom이 선택한 항목을 곧바로 다시 확인합니다: “항목 27개를 다시 확인하는 중.”
2. 미리 보기에 무슨 일이 일어날지 표시됩니다: “항목 27개를 휴지통으로 이동”, 전체 크기, 각 항목. 선택했지만 확인을 통과하지 못한 항목은 “제외됨” 아래에 이유와 함께 나열됩니다.
3. 확인하면 항목이 휴지통으로 이동합니다. 스캔 이후 바뀐 것이 있으면 그대로 두고, 왜 건너뛰었는지 알려 줍니다.
4. 휴지통으로 옮긴 공간은 휴지통을 비울 때까지 디스크에 남습니다. Devbroom도 이렇게 알려 줍니다: “휴지통으로 이동함 · 휴지통을 비우면 공간이 확보됩니다”.

마음이 바뀌면 되돌리기로 모두 되돌릴 수 있고, 나중에도 기록에서 항목을 하나씩 되돌릴 수 있습니다. 영구 삭제는 별도의 선택이며, 버튼을 길게 눌러 확인합니다.

워크트리는 휴지통으로 가지 않습니다. git으로 제거하며, 먼저 HEAD를 복구용 ref에 저장하고, 브랜치는 남습니다.

자동 관리

설정 › 자동 관리에서 Devbroom이 스스로 스캔할 시점(끔, 매일, 매주)과, 몇 GB가 준비되면 알려 줄지 정할 수 있습니다. 자동 스캔은 읽기만 합니다.

“90일보다 오래된 빌드 폴더” 같은 규칙도 추가할 수 있습니다. 규칙은 기본적으로 먼저 묻습니다. “알아서 실행”을 고르면 준비됨 항목만, 휴지통으로만 옮기며, 하나하나 되돌릴 수 있습니다. 이 기능을 켜지 않는 한 Devbroom은 승인 없이 아무것도 바꾸지 않습니다. 자동 관리는 Pro에 포함됩니다.

세션

세션 탭은 에이전트의 세션 기록을 폴더별로 보여 줍니다. 어떤 세션이 실행 중인지, 공간을 얼마나 차지하는지, 폴더가 더 이상 없는 세션은 무엇인지, 그리고 지난 30일을 포함해 사용한 토큰을 API 정가로 환산한 예상 금액을 보여 줍니다. 이 수치는 Mac에서만 계산됩니다.

• 검색: 세션에서 오간 내용을 검색합니다. 로그는 그 순간 읽으며 색인을 만들지 않습니다. 비밀 정보처럼 보이는 문자열은 결과에서 가려집니다.
• 대화 보관: 폴더의 Claude Code 대화를 보관 파일로 묶고 검증한 뒤, 원본을 휴지통으로 옮깁니다. 프로젝트의 메모리는 그대로 남습니다. 보관된 대화는 다시 열기 전까지 claude --resume으로 열 수 없으며, 기록에서 다시 열 수 있습니다.

사용량과 비용, 검색, 보관은 Pro에 포함됩니다.

메뉴 막대

Devbroom은 메뉴 막대에도 있습니다. 마지막 스캔 후 정리할 준비가 된 용량과, 스캔 중에는 진행 상황을 보여 주며, 그곳에서 다시 스캔하거나 스캔을 멈출 수 있습니다. 창을 닫으면 Devbroom은 Dock에서 사라지고 메뉴 막대에서 계속 실행됩니다. 완전히 종료하려면 ⌘Q를 누르세요.

Pro

스캔, 판정, 정리, 되돌리기, 명령줄, MCP는 무료입니다. 자동 관리, 분석, 세션 도구는 Pro에 포함됩니다. 처음 14일 동안은 Pro 전체가 켜져 있으며, 카드도 계정도 이메일도 필요 없습니다. 체험 기간이 끝나도 아무것도 삭제되지 않습니다. 규칙은 일시 중지되고 기록은 남습니다. Pro는 Mac 2대에 $29 일회성 결제입니다. 자세한 내용은 가격 페이지를 참고하세요.

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