
littleguys로 여러 AI 에이전트 관제하기: 승인 요청과 예약 실행 관리
littleguys는 AI 에이전트의 대화·상태·승인 요청을 모아 관리하는 macOS용 오픈소스 관제 프런트엔드입니다. 연결 방식별 예약 실행 주체와 도입 전 확인할 승인 범위, 앱 종료 후 동작을 정리합니다.
Hyuk · · 4분 · AI
핵심 요약
- littleguys는 기존 에이전트의 대화·상태·승인 요청을 메뉴 막대와 통합 창에서 관리합니다.
- OpenClaw와 Hermes의 예약은 각자의 스케줄러가 담당하며, ACP 연결의 예약은 littleguys 실행에 의존합니다.
- 도입 전에는 승인 요청의 출처, 항상 허용의 적용 범위, 앱 종료와 재시작에 따른 예약 동작을 확인해야 합니다.
littleguys는 이미 쓰고 있는 AI 에이전트의 대화와 상태, 승인 요청을 macOS 메뉴 막대와 통합 창 한곳에서 관리하게 해 주는 오픈소스 관제 프런트엔드입니다. 여러 에이전트가 어디까지 진행했는지 살피고, 사용자 판단이 필요한 요청에 그 자리에서 답할 수 있어요. 예약 실행도 지원합니다. 다만 앱을 종료한 뒤에도 예약이 돌아가는지는 어떤 방식으로 연결했느냐에 따라 달라집니다.
공식 사이트도 이 도구를 기존 에이전트에 연결하는 인터페이스로 소개하고 있어요. 그래서 관제와 자동 협업은 따로 생각하는 편이 좋습니다. 에이전트끼리 역할을 나누거나 작업 사이의 의존성을 관리하는 기능까지 갖췄다고 확인된 도구로 보기는 어렵습니다.
승인 요청이 어디서 왔는지 알아볼 수 있는가
도입을 고민하고 있다면 승인 요청이 어떤 경로로 도착해서 처리되는지부터 보시길 권합니다. 관제 화면이 실제로 쓸모 있느냐는 결국 요청을 발견한 뒤 그 실행 맥락까지 얼마나 빨리 파악할 수 있느냐에 달려 있기 때문이에요.

메뉴 막대에는 대기, 작업 중, 새 답변, 사용자 확인 필요, 오프라인 상태가 표시됩니다. 팝오버를 열면 최근 메시지를 보고 바로 답장할 수 있어요. 메인 창으로 넘어가면 스트리밍 응답과 도구 호출을 따라가면서 명령을 승인하거나 거절하게 됩니다.
여기서 눈여겨볼 점은 ‘어느 연결의 어떤 에이전트가 무슨 명령을 기다리는지’가 한눈에 구별되느냐입니다. 비슷한 작업이 동시에 돌아가는 상황에서도 요청의 출처와 내용을 식별할 수 있어야 판단에 도움이 돼요. 이 흐름이 작업 환경과 잘 맞는다면 터미널 사이를 오가는 횟수와 승인을 놓치는 일을 줄이는 효과를 기대할 수 있습니다.
흔히 헷갈리는 부분이 하나 있어요. 승인 화면이 있다는 것과 모든 명령이 실행 전에 실제로 막힌다는 것은 별개의 문제이니, 이 부분은 따로 확인해야 합니다.
예약은 누가 실행하는가
설치 대상은 macOS 13 이상이고, Apple silicon과 Intel을 모두 지원합니다. DMG를 내려받거나 brew install herval/tap/littleguys 명령으로 설치하면 돼요.
설치보다 먼저 짚어 둘 것은 예약을 실제로 실행하는 주체가 누구냐입니다. main 브랜치 README에 나온 연결 방식과 루틴 설명을 정리하면 이렇습니다.
| 연결 대상 | 통신 방식 | 예약 실행 주체 |
|---|---|---|
| OpenClaw | Gateway WebSocket v4 | OpenClaw 자체 cron |
| Hermes Agent | 로컬 hermes serve의 WebSocket JSON-RPC 또는 원격 API 서버 | Hermes 자체 cron |
| Claude Code·Codex·Gemini CLI 등 ACP 에이전트 | 주로 표준 입출력, 일부 WebSocket | 실행 중인 littleguys |
ACP는 Agent Client Protocol의 약자로, 클라이언트와 에이전트가 대화하고 요청을 주고받을 때 쓰는 통신 규약이에요. 그러니 지원 목록에 여러 이름이 올라 있다고 해서 같은 모델을 쓴다는 뜻으로 읽으면 곤란합니다. 공통 규약으로 연결된다는 의미로 받아들이는 쪽이 정확해요. 표에 나오는 cron은 정해진 시간에 작업을 실행하는 스케줄러를 말합니다.
OpenClaw와 Hermes는 예약을 각자의 스케줄러가 맡기 때문에, 해당 실행 환경이 계속 살아 있는지가 관건입니다. ACP로 연결한 에이전트는 사정이 달라서 예약이 littleguys가 실행 중인지에 기대고 있어요. 똑같은 야간 작업이라도 누가 실행하느냐에 따라 앱을 끄는 것이 미치는 영향이 완전히 달라지는 셈입니다.
창을 닫는 것과 앱을 종료하는 것도 구별해서 보세요.
README에 따르면 창을 전부 닫아도 연결은 유지됩니다. 앱을 종료한 뒤 예약이 어떻게 처리되는지는 따로 살펴봐야 해요. 꺼져 있는 동안 놓친 작업을 재시작 후에 실행하는지, 중복 실행은 어떻게 막는지도 함께 확인할 항목입니다.
도입 전에 승인 범위와 종료 후 동작부터 시험해 보세요
처음에는 테스트용 Mac과 별도 프로필에서 에이전트 한 종류만 연결해 보길 권합니다. 연결을 늘리기 전에 상태 표시와 실제 동작이 어떻게 맞물리는지 알아 두면, 나중에 문제가 생겼을 때 원인을 좁히기가 훨씬 수월해요. 확인 순서는 이렇게 잡으면 됩니다.

- 작업 시작·완료·승인 대기·연결 끊김 표시를 실제 실행 로그와 대조합니다.
- 무해한 명령으로 일회 허용과 거절을 시험한 뒤, 항상 허용의 적용 범위와 철회 방법을 확인합니다.
- 토큰 파일과 로그의 평문 노출 여부, 파일 접근 권한을 살펴봅니다.
- 창 닫기·앱 종료·재시작을 나눠 예약 누락과 중복 실행 여부를 기록합니다.
이 가운데 가장 오해하기 쉬운 것이 ‘항상 허용’이에요. 버튼 이름만 보고는 범위를 가늠하기 어렵습니다. ACP 규격에는 사용자의 선택을 기억한다는 의미가 담겨 있지만, 그 선택이 명령 단위인지 프로젝트 단위인지 세션 단위인지, 그리고 어떻게 되돌리는지는 연결한 에이전트의 구현까지 확인해야 알 수 있어요.
토큰 파일에 0600 권한이 걸려 있다는 것과 저장된 내용이 암호화돼 있다는 것도 서로 다른 이야기입니다. README에 있는 초기 연결 토큰 저장 설명만 가지고 암호화가 적용됐다거나 모든 연결이 Keychain을 쓴다고 짐작하기는 어려워요. 쓰려는 기능이 v0.2.0 배포판에 실제로 들어 있는지도 main README와 구분해서 확인해 두세요.
자주 묻는 질문
- littleguys는 Intel Mac에서도 설치할 수 있나요?
- macOS 13 이상에서 Apple silicon과 Intel을 지원합니다. DMG 또는 `brew install herval/tap/littleguys` 명령으로 설치할 수 있습니다.
- littleguys 창을 모두 닫으면 에이전트 연결도 끊기나요?
- README는 창을 모두 닫아도 연결을 유지한다고 설명합니다. 앱 종료는 별개이며, 종료 후 예약 동작은 연결 방식과 실행 환경에 따라 확인해야 합니다.
출처
관련 글
댓글
Giscus를 연결하면 댓글이 열립니다.