늘 켜 두는 내 Mac(호스트) 의 폴더에 Claude Code 에이전트를 하나씩 붙입니다. 맥북과 아이폰 어디서든 메신저처럼 시키고, 내 폰이 꺼져도 일은 계속됩니다.
설치 5분 · Claude Code CLI 로그인 필요
코딩 에이전트는 리포를 단위로 봅니다. Folder Bot 은 일하는 사람이 실제로 쓰는 단위 — 폴더를 봅니다.
| 코딩 에이전트 (Cursor · Claude Code 터미널) | Folder Bot | |
|---|---|---|
| 단위 | 리포지토리 | 폴더 — PARA(Inbox/Projects/Area/Resources/Archive) 같은 일하는 사람의 폴더 |
| 컨텍스트 | 코드 | 그 폴더의 CLAUDE.md(지침) · todo.md(할 일) · 자료 |
| 어디서 | 그 컴퓨터 앞에서 | 아이폰에서도 — 홈 화면 앱, 푸시 알림, 승인 카드 |
| 여러 개 | 탭 | 봇마다 세션, 오케스트레이터가 인박스·후보 폴더를 관제 |
폴더를 고르면 CLAUDE.md·todo.md 를 깔고 Claude Code 세션을 붙입니다. 파일을 읽고 쓰고, 정리하고, 문서를 만듭니다.
볼트 루트에 사는 봇. 인박스에 넣어 둔 파일·폴더를 규칙대로 옮기자고 제안하고(승인 뒤 실행, 되돌리기 가능), 다른 봇에게 일을 넘깁니다.
호스트(Mac mini 등)가 봇을 돌리고, 맥북·아이폰은 같은 화면을 봅니다. 승인이 필요하면 알림이 오고, 답이 끝나면 알려 줍니다.
어떤 도구를 몇 번 썼는지, 서브에이전트가 무엇을 하는지 한 줄씩 보입니다 — 답변은 크게, 실행 줄은 작게.
요구 사항: Apple Silicon Mac(호스트) · Claude Code CLI 로그인(Claude 구독 또는 API 키) · 아이폰과 맥북은 같은 Tailscale 네트워크(권장)
최신 DMG 를 받아 Applications 로 끌어 놓습니다.
«확인되지 않은 개발자» 가 뜨면 — 개발자 인증서 없이 ad-hoc 서명이라 그렇습니다. 터미널에 한 줄:
xattr -dr com.apple.quarantine "/Applications/Folder Bot.app"앱을 열고 이 맥에서 호스트 실행 → 볼트 폴더(PARA 루트)를 고릅니다. 그 안의 폴더들이 봇 후보가 되고, 오케스트레이터가 첫 인사를 합니다.
처음 한 번 권한 화면이 뜹니다 — 전체 디스크 접근, 알림. 켜고 돌아오면 자동으로 확인합니다.
맥북은 같은 앱을 설치하고 호스트 주소와 페어링 코드를 넣습니다. 아이폰은 Safari 로 호스트 주소를 열고 «홈 화면에 추가».
