코딩 에이전트가 승인받은 계획대로 구현하고, 테스트 근거를 남기는 개발 도구입니다.
One Roof: Mac에서 AI 코딩 에이전트 함께 관리
여러 세션, 승인 요청, 실행 한도가 있는 반복 작업을 한곳에서 확인하세요.
One Roof는 무엇을 하는 서비스인가요?
One Roof는 AI 코딩 에이전트를 한곳에 모아 관리하는 무료 Mac 앱입니다. Claude Code, Codex, Gemini CLI, Kimi, Antigravity의 실제 명령줄 도구가 실행되며 일반 셸도 열 수 있습니다. 어떤 작업이 진행 중이고 무엇이 내 답변을 기다리는지 확인하는 관리 공간입니다.
웹사이트는 제품 소개와 데모, 다운로드를 제공합니다. 실제 사용은 설치한 앱에서 이루어집니다. 계획, 구현, 코드 검토를 다른 에이전트에 나누거나 여러 저장소의 작업을 함께 살펴보는 개발자에게 유용합니다.
답변이 필요한 세션을 Inbox에서 찾기
Inbox는 세션의 요청을 모으고, 작업을 멈추게 하는 질문을 위에 표시합니다. 에이전트가 제공한 원래 선택지로 응답하거나 터미널에 직접 입력할 수 있습니다. 승인 여부는 사용자가 결정합니다.
Sessions에는 상태, 에이전트, 계정, 폴더가 표시됩니다. 백그라운드 서비스 roofd는 앱을 닫아도 실행 중인 세션을 유지합니다. Home은 야간 실패와 다음 할 일을 요약하며 History는 중요한 이벤트와 결정 내용을 30일 동안 보관하고 검색하게 해 줍니다.
검사 결과를 기준으로 반복 작업 실행
Loops에서 저장소, 에이전트, 목표, 검사 명령과 한도를 정합니다. 명령을 먼저 테스트하고 첫 실행 미리보기를 확인하세요. 테스트가 통과할 때까지 버그를 수정하는 작업이 한 예입니다.
처음 검사에서 통과하면 에이전트를 시작하지 않습니다. 실패하면 별도 Git worktree에서 작업하고 매 라운드 뒤 다시 검사합니다. 성공하거나 시간, 횟수, 반복 실패 제한에 도달하면 멈춥니다. 결과는 사용자 검토를 기다리며 스스로 push, 병합, 배포하지 않습니다.
기본 제공 반복 작업은 처음에는 꺼져 있습니다. 앱을 닫고 예약 실행하려면 관련 설정을 켜고 Mac을 깨어 있게 해야 합니다. 자세한 조건은 공식 Loops 안내를 확인하세요.
설치하고 첫 세션 시작하기
Apple silicon Mac, macOS 14 이상, Git, 설치와 인증이 완료된 에이전트 CLI가 하나 이상 필요합니다.
- Releases에서 ZIP을 받아 압축을 풀고 One Roof를 응용 프로그램 폴더로 옮깁니다.
- 초기 설정에서 roofd를 허용하고 코드 저장소가 들어 있는 폴더를 선택합니다.
- ⌘N으로 구체적인 작업을 입력하고 에이전트와 저장소를 고른 뒤 ⌘Return으로 시작합니다.
- 질문이 생기면 ⌘I로 Inbox를 열어 답합니다. 완료 후 변경 내용과 실제 결과를 검토합니다.
메모리 그래프와 보호 한도의 차이
Resources는 세션 및 프로세스 트리의 CPU와 메모리, 최근 10분 그래프를 보여 줍니다. 기본 1 GB 경고와 2 GB 종료 기준은 세션을 유지하는 프로세스 자체에 적용됩니다. 모든 자식 프로세스의 메모리 합계를 제한하는 수치는 아니며 환경 설정에 따라 달라질 수 있습니다.
무료 범위, 권한과 코드 접근
2026년 11월 5일 확인 기준 앱은 무료이며 MIT 라이선스로 공개됩니다. 에이전트 구독과 API 비용은 별도이고 반복 작업, 선택적 리뷰와 평가는 자신의 사용량을 소비할 수 있습니다.
새 설치에서는 각 에이전트가 Manual 모드로 시작합니다. 다른 모드는 CLI에 따라 다르며 사용자 지정 인수가 설정을 덮어쓸 수 있습니다. 에이전트가 선택 폴더 아래 파일을 읽을 수 있으므로 코드 전용 폴더를 고르세요. 로컬 화면이 모든 연결 모델의 오프라인 실행을 보장하지는 않습니다.
선택 기능과 현재 개발 단계
Linear 연결에는 자신의 API 키가 필요합니다. OpenCode와 Goose는 자체 자격 증명 및 예산 예약 한도로 호스팅 모델을 사용할 수 있습니다. 선택적인 소형 로컬 모델은 레이블과 설명을 돕습니다. roof 키트는 공통 규칙과 작업 폴더를 구성하며 roof install --dry-run으로 미리 보고 roof doctor로 검사합니다. Evals는 명시적으로 초안 상태입니다.
자주 묻는 질문
앱이 무료면 AI 사용료도 무료인가요?
무료인 것은 앱입니다. 연결한 에이전트와 모델 API를 무제한으로 쓸 수 있는 공통 사용량은 포함하지 않습니다.
어떤 Mac에서 실행할 수 있나요?
공개 요구 사항은 Apple silicon과 macOS 14 이상입니다. Windows/Linux GUI나 Intel 버전은 확인되지 않았습니다.
어떤 코딩 에이전트를 지원하나요?
Claude Code, Codex, Gemini CLI, Kimi, Antigravity와 일반 셸입니다. OpenCode와 Goose는 추가 설정이 필요합니다.
