Agent Monitor
Agent Monitor: 여러 에이전트를 화면 끝에서 지켜보기
code404에서는 한 작업에 AI 에이전트 여럿이 함께 움직입니다. 그러다 보니 지금 누가 무엇을 하고, 누가 내 답을 기다리는지 놓치는 일이 잦았습니다. Agent Monitor는 그 불편을 풀려고 만든 Mac 앱이고, 이 글은 만들면서 무엇을 어떻게 정했는지 적은 기록입니다.
왜 만들었나
Claude Code가 코드를 쓰다가 검토를 맡기려고 Codex를 실행하고, 조사가 필요하면 agy를 부릅니다. 터미널과 데스크톱 앱 창이 여러 개 열려 있으면 어느 창이 멈춰서 승인을 기다리는지 하나씩 열어 봐야 했습니다.
처음 판은 Swift로 만든 메뉴 막대 앱이었습니다. 이후 Tauri와 React로 새 앱을 만들었는데, 예전 앱에 기능을 옮겨 붙이지 않고 별도 앱으로 두기로 한 것은 운영자의 결정입니다. 지금 내려받을 수 있는 것은 이 새 앱입니다.
상태는 hook으로 듣습니다
세 에이전트는 모두 일을 시작하고, 도구를 쓰고, 마칠 때마다 정해 둔 명령을 실행하는 hook을 지원합니다. Agent Monitor는 각 에이전트의 hook 설정에 한 줄을 더하고, 그 줄이 앱이 써 둔 작은 스크립트를 실행해 이벤트를 이 Mac 안의 앱으로 넘깁니다.
- 앱이 꺼져 있어도 방해하지 않기: 연결은 아주 짧게만 기다리고, 실패하면 조용히 넘어갑니다. 에이전트 쪽 작업은 그대로 이어집니다.
- 명령은 고정, 스크립트만 갱신: 설정 파일에 넣는 줄은 바뀌지 않고, 앱이 켜질 때 스크립트만 새로 씁니다. 앱을 고쳐도 hook을 다시 설치할 필요가 없습니다. 사용자가 승인한 hook만 실행하는 Codex의 승인도 유지될 것으로 보는데, Codex가 승인을 어떻게 기억하는지는 공개 문서가 없어 가정으로 적어 둡니다.
- 누가 누구를 불렀는지: 이벤트마다 그 에이전트의 프로세스 번호를 함께 보내고, 앱이 1초마다 프로세스 계보를 거슬러 올라가 가장 가까운 다른 에이전트 세션을 찾습니다. Claude가 Codex를 부르고 그 Codex가 다시 Claude를 부르는 세 단계가 이어져 보이는 것도 실제로 돌려 확인했습니다.
그림은 세 번 바꿨습니다
서브에이전트가 갈라져 나갔다 돌아오는 흐름을 그리는 ‘흐름 보기’ 창은 상자와 연결선, 리본 모양을 거쳐 시간축 레인으로 정했습니다. 시안 세 가지를 브라우저에 나란히 띄워 놓고 운영자가 골랐습니다.
그런데 개발한 Mac의 지난 30일 기록을 세어 보니, 서브에이전트를 쓴 Claude Code 세션은 188개 중 29개였습니다. 따로 여는 창은 대개 비어 있다는 뜻이어서, 같은 레인을 세션 카드 안에 작게 넣고 서브에이전트가 움직일 때만 보이게 했습니다.
권한 확인을 패널에서 답하기
가장 조심스럽게 만든 기능입니다. 패널에서 ‘허용’을 누르면 에이전트가 실제로 명령을 실행하기 때문입니다. 그래서 기본값은 꺼짐입니다. 켜면 Claude Code의 권한 확인 hook이 최대 30초 동안 패널의 답을 기다리고, 그동안 터미널에도 원래 확인 화면이 함께 뜹니다. 답이 없거나 앱이 꺼져 있으면 평소처럼 터미널에서 묻습니다.
- 답을 받는 통로: 처음에는 이벤트와 같은 네트워크 포트로 답을 받았는데, 앱이 꺼진 사이 다른 프로그램이 그 포트를 차지하면 ‘허용’을 대신 보낼 수 있었습니다. 비밀값을 붙이는 방법은 명령줄 인자가 다른 사용자에게도 보여 버렸습니다. 지금은 내 계정만 들어갈 수 있는 폴더 안의 소켓으로만 답을 받습니다.
- 선택지를 지어내지 않기: 초기 판은 ‘다시 묻지 않기’ 규칙을 스스로 만들어 보여 줬습니다. 지금은 Claude Code가 요청과 함께 보낸 제안만 버튼으로 보여 주고, 그 제안을 바꾸지 않고 돌려줍니다.
- 잘못 누르지 않게: 새 요청이 뜨거나 목록이 바뀌면 0.6초 동안 버튼이 눌리지 않습니다. 너무 길어 전부 보여 줄 수 없는 요청은 허용할 수 없게 했습니다.
- 다른 곳에서 답하면 물러나기: 터미널에서 거부하면 hook 이벤트가 오지 않습니다. 그래서 대화 기록 파일을 1초마다 확인해 패널에 남은 요청을 거둡니다.
이 기능은 검토를 맡는 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 여럿과 일하는 방법에 적어 두었습니다.


