← 제작기

Agent Monitor

Agent Monitor: 여러 에이전트를 화면 끝에서 지켜보기

code404·2026년 11월 19일·읽는 데 약 4분

code404에서는 한 작업에 AI 에이전트 여럿이 함께 움직입니다. 그러다 보니 지금 누가 무엇을 하고, 누가 내 답을 기다리는지 놓치는 일이 잦았습니다. Agent Monitor는 그 불편을 풀려고 만든 Mac 앱이고, 이 글은 만들면서 무엇을 어떻게 정했는지 적은 기록입니다.

왜 만들었나

Claude Code가 코드를 쓰다가 검토를 맡기려고 Codex를 실행하고, 조사가 필요하면 agy를 부릅니다. 터미널과 데스크톱 앱 창이 여러 개 열려 있으면 어느 창이 멈춰서 승인을 기다리는지 하나씩 열어 봐야 했습니다.

처음 판은 Swift로 만든 메뉴 막대 앱이었습니다. 이후 Tauri와 React로 새 앱을 만들었는데, 예전 앱에 기능을 옮겨 붙이지 않고 별도 앱으로 두기로 한 것은 운영자의 결정입니다. 지금 내려받을 수 있는 것은 이 새 앱입니다.

상태는 hook으로 듣습니다

세 에이전트는 모두 일을 시작하고, 도구를 쓰고, 마칠 때마다 정해 둔 명령을 실행하는 hook을 지원합니다. Agent Monitor는 각 에이전트의 hook 설정에 한 줄을 더하고, 그 줄이 앱이 써 둔 작은 스크립트를 실행해 이벤트를 이 Mac 안의 앱으로 넘깁니다.

그림은 세 번 바꿨습니다

서브에이전트가 갈라져 나갔다 돌아오는 흐름을 그리는 ‘흐름 보기’ 창은 상자와 연결선, 리본 모양을 거쳐 시간축 레인으로 정했습니다. 시안 세 가지를 브라우저에 나란히 띄워 놓고 운영자가 골랐습니다.

그런데 개발한 Mac의 지난 30일 기록을 세어 보니, 서브에이전트를 쓴 Claude Code 세션은 188개 중 29개였습니다. 따로 여는 창은 대개 비어 있다는 뜻이어서, 같은 레인을 세션 카드 안에 작게 넣고 서브에이전트가 움직일 때만 보이게 했습니다.

권한 확인을 패널에서 답하기

가장 조심스럽게 만든 기능입니다. 패널에서 ‘허용’을 누르면 에이전트가 실제로 명령을 실행하기 때문입니다. 그래서 기본값은 꺼짐입니다. 켜면 Claude Code의 권한 확인 hook이 최대 30초 동안 패널의 답을 기다리고, 그동안 터미널에도 원래 확인 화면이 함께 뜹니다. 답이 없거나 앱이 꺼져 있으면 평소처럼 터미널에서 묻습니다.

이 기능은 검토를 맡는 Codex가 한도에 걸려 Claude의 검토 서브에이전트에게 보안 검토를 두 차례 받았고, ‘반드시 고칠 것’과 ‘고치면 좋은 것’을 모두 반영했습니다. 마지막 소켓 변경은 세 번째 검토를 받지 않았다는 점도 기록에 남겨 두었습니다.

Mac 밖으로 보내지 않고, 남의 설정은 지키기

에이전트 이벤트에는 명령과 프롬프트가 들어 있습니다. 그래서 이벤트는 이 Mac 안에서만 오가고 외부 서버로 보내지 않습니다. 브라우저가 보낸 요청은 받지 않습니다. hook 설정 파일은 고치기 전에 백업하고, 내용이 깨져 있으면 고치지 않고 멈추며, 다른 hook은 그대로 둡니다.

이 원칙은 실제로 한 번 시험대에 올랐습니다. 처음 Mac에서 돌렸을 때 예전 Swift 앱과 새 앱이 같은 글자로 자기 hook을 찾고 있어서, 새 앱의 설치·제거가 예전 앱의 hook 9개까지 지울 수 있었습니다. 표식을 나누고, 그 경우를 자동 시험으로 막았습니다.

App Store 대신 서명과 공증

배포는 Mac App Store가 아니라 직접 내려받는 방식으로 정했습니다. 다른 도구의 설정 파일을 고치고 터미널을 움직이는 앱이라 App Store의 샌드박스와 맞지 않는다고 판단했습니다. 심사 지침과 하나하나 대조한 결론은 아닙니다. 대신 Developer ID로 서명하고 Apple 공증을 받아, Apple Silicon과 Intel에서 모두 도는 파일 하나로 냈습니다. 팀의 첫 공증은 45분이 넘게 걸렸습니다.

기능과 설치 방법은 Agent Monitor 소개 쪽에, 이 앱이 지켜보는 에이전트들에게 일을 나누는 방식은 혼자서 AI 여럿과 일하는 방법에 적어 두었습니다.

다른 제작기