모든 에이전트를 위한 단일 받은 편지함

저는 보통 여러 개의 코딩 에이전트들을 동시에 운영합니다: 한 터미널에서는 Claude Code를, 다른 터미널에서는 Codex를, 그리고 서버에 몇 개 더 배치해 둡니다. 이들은 모두 권한 프롬프트가 꺼진 상태로 실행되므로(Claude Code의 경우 --dangerously-skip-permissions, Codex의 경우 --yolo), 빠르게 움직입니다.

느린 부분은 바로 저였습니다. 어떤 에이전트가 대기 중인지, 어떤 것이 완료되었는지, 그리고 어떤 결정이 필요한지 알기 위해 터미널들을 왔다 갔다 확인해야 했죠.

이제는 에이전트들이 제게 옵니다. 모든 질문, 결정 사항, 그리고 '완료' 메시지가 데스크톱이나 휴대폰의 단일 받은 편지함에 도착하며, 해당 에이전트와 프로젝트 이름으로 라벨링되어 있습니다. 제가 답변하면, 에이전트는 작업을 계속 진행합니다.

handup을 사용한 34초: 실제 앱입니다.

받은 편지함에 들어오는 것들

handup을 사용한 처음 10일 동안, 22개 프로젝트를 거치면서 제 에이전트들은 저에게 약 1,700개의 요청을 보냈습니다 (그중 일부는 제가 직접 테스트한 것입니다). 이는 제가 올바른 터미널을 찾아다닐 필요가 없었다는 의미입니다:

• 절반은 업데이트였습니다:

각 요청에는 다른 것을 열어보지 않고도 제가 결정하는 데 필요한 모든 것이 담겨 있습니다. 정확한 명령어, diff(차이점), Markdown, 이미지, 비디오, 오디오, PDF 또는 전체 파일 묶음일 수 있습니다. 저는 그중 어떤 것이든 바로 미리 볼 수 있거나, 양쪽 장치에서 다른 앱으로 열어볼 수도 있습니다. 배너를 보고 나서 배너를 선택하고, 명령을 읽은 후에 배포(deploy)를 승인합니다.

답변은 요청한 에이전트에게 곧바로 돌아가고, 대화는 계속됩니다. 업데이트에 후속 조치가 필요할 때는 그 아래에 답글("좋아 보여, 이제 문서를 작성해 줘")을 타이핑하면, 에이전트는 그것을 다음 지침으로 받아들입니다.

많은 일이 벌어질 때, 저는 에이전트별 또는 요청 유형별로 받은 편지함(inbox)을 필터링하거나 프로젝트, 브랜치 또는 세션별로 검색합니다. 다른 기기에 있는 에이전트들도 같은 목록에 표시되며, 각각 해당 컴퓨터의 이름으로 태그가 붙습니다.

매주 필요한 의사결정 감소시키기

빠르게 답변하는 것은 절반에 불과합니다. 진정한 목표는 답변할 필요 자체를 줄이는 것입니다. 모든 결정은 제 피드백과 함께 기록되므로, 받은 편지함은 제가 가진 에이전트들이 스스로 해결하지 못한 모든 것의 로그 역할을 합니다.

• 제가 무언가를 거부하면 그 이유를 말합니다("운영 환경(prod) 대신 스테이징 환경(staging)을 사용하세요"). 에이전트는 단순히 '아니요'가 아니라 이 이유와 함께 거절당합니다.
• 같은 종류의 질문에 두 번 답변할 경우, 답변은 해당 에이전트의 스킬 또는 프로젝트의 AGENTS.md 파일로 들어가 다음번에는 스스로 결정하게 됩니다.
• 제가 항상 승인하는 사항들은 규칙(rules)이 되어 자동으로 처리하며, 제가 읽지 않는 업데이트는 무시되거나 음소거됩니다.
• 가끔씩 저는 에이전트에게 제 결정 기록(handup log)을 다시 읽게 하여 다음에 자동화해야 할 것을 제안받습니다.

이 받은 편지함은 피드백 루프입니다. 모든 결정은 현재 에이전트를 막는 장애물을 제거하거나, 혹은 같은 질문을 하지 않도록 가르치는 역할을 합니다. 시간이 지남에 따라 남는 것은 정말로 저의 도움이 필요한 것들뿐입니다.

에이전트가 무엇을 보낼지 아는 방법

handup은 각 에이전트에게 몇 가지 MCP 도구를 제공합니다: 업데이트 및 완료된 작업을 위한 notify, 제가 할 수 있는 선택지에 대한 질문을 위한 ask_question, 그리고 중요한 조치 전에 승인을 요청하기 위한 request_approval입니다. handup prompt는 사용자의 AGENTS.md 또는 CLAUDE.md에 어떤 에이전트가 언제 어떤 도구를 사용할지 알려주는 짧은 지침을 출력합니다. 그 외의 모든 것은 그냥 수행합니다.

handup setup   # handup 시작 및 감지된 모든 에이전트에 연결
handup prompt  # AGENTS.md 또는 CLAUDE.md에 대한 지침 출력
handup pair    # 휴대폰을 페어링하기 위한 QR 코드

사용자의 휴대폰은 Tailscale을 통해 연결됩니다. 권한 프롬프트를 켜 놓으면, handup은 동일한 받은 편지함에서 Claude Code 및 Codex 프롬프트에도 응답할 수 있습니다.

에이전트가 느린 부분은 결코 아니었습니다. 에이전트를 찾는 것이 문제였고, 같은 질문에 두 번 답하는 것이 문제였습니다.

관련 자료

• handup 다운로드
• Claude Code 설정 가이드
• Codex 설정 가이드
• 문서: MCP 도구
• 문서: Tailscale을 통한 휴대폰 접근