← 블로그로
Ai약 12 분 읽기

agent-autoloop는 '사람을 기다리는 일'을 데이터베이스 한 행으로 저장한다

게시일 2026년 11월 15일
agent-autoloop는 '사람을 기다리는 일'을 데이터베이스 한 행으로 저장한다

몇 주에 한 번씩 같은 장면을 본다. 누군가 터미널에서 coding agent를 띄우고 커피를 타러 일어나고, 돌아와 보면 아무도 보지 못한 질문 앞에 멈춰 있다. 흔한 해법은 알림음을 더 크게 하는 것이다. agent-autoloop가 겨냥하는 것은 그 아래에 있는 낭비, 즉 프로세스와 컨텍스트 윈도가 열린 채 아무것도 하지 않고 사람은 키보드에서 떠나 있는 시간이다.

로컬 hub이고, 2026년 11월 15일 기준 GitHub 스타 5,459개, MIT 라이선스다. 이벤트를 지켜보다가 이미 쓰고 있는 명령줄 agent에 넘기고는 비켜선다. agent는 한 라운드를 끝내고, 답을 쓰고, 종료한다. 결정이 필요하면 hub가 데스크톱으로 카드를 보낸다. Feishu, DingTalk, WeCom, Slack, Discord로 보내도 된다. 선택지를 고른다. agent가 그 대화를 다시 집어 든다.

클라우드 박스도, 열린 포트도, dashboard도 없다.

설치, 그리고 작동을 증명하는 명령 하나

요구 사항은 Node 24 이상, Git, 그리고 이미 설치하고 로그인한 명령줄 agent 하나다. macOS와 Linux에서는 curl도 필요하다.

irm https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.ps1 | iex
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh

그다음 agent-autoloop try를 실행한다. 버전 번호만 찍는 설치 스크립트는 당신 agent의 플래그와 로그인이 작동한다는 증거가 되지 못한다. try는 당신 agent로 실제 '질문, 대기, 응답, 계속' 주기를 한 바퀴 돈다. 이벤트가 나가고, agent가 일하고, 멈추고, 선택지가 붙은 질문을 하고, 종료하고, 기다린다. 답하면 hub가 세션을 이어받아 마무리한다. 설정이 틀렸다면 2분 안에 알게 된다. cron 규칙이 잘못 걸려 새벽 2시에 알게 되는 것이 아니라.

계약 한 문장, 규칙 파일 하나

hub와 agent 사이의 인터페이스는 관습 하나다. 결과를 마지막 응답에 넣는다. SDK도, wrapper도, 패치한 바이너리도 없다. 프롬프트를 받아 마지막 메시지를 출력하는 것이면 무엇이든 붙는다. 그래서 범용 명령 어댑터가 Claude Code, Codex, ACP, DeepSeek Harness, ZCode와 나란히 있다.

질문은 덧붙이기다. agent는 응답 끝에 agent-autoloop라는 이름의 펜스 블록을 두고 그 안에 JSON을 담는다. title, text, options, key를 가진 ask 배열과, 나머지 동사에 대응하는 notice, resolve, later, events다. agent 작성자가 배워야 할 프로토콜은 이것이 전부다.

규칙은 ~/.agent-autoloop/rules.json에 있다. 규칙은 세 가지 질문에 답한다. 무슨 일이 있었는지, 어느 agent가 받는지, 어느 디렉터리에서 도는지.

{
  "when": { "cron": "0 9 * * *" },
  "to": "codex",
  "cwd": "~/notes"
}

이벤트 규칙은 시계를 소스로 바꾼다. GitHub의 issues.opened에 맞추고 parallel: 3과 스킬을 더하면 모양은 같다. 설정은 파일 두 개에 들어 있다. 이것 하나와, 당신 agent가 원래 읽는 파일 하나다. 들여다볼 수 있고 diff가 쉽다는 점이 마음에 든다.

시스템 엔지니어링에서 빌려온 네 가지 메커니즘

커널은 설계가 흥미로워지기 시작하는 지점이다. 따로 떼어 보면 새로운 것은 거의 없다.

첫째는 비용 없는 중단이다. 기다리는 동안 프로세스는 종료되고 상태는 데이터베이스로 옮겨 간다. 사흘을 조용히 있으면 사흘치 토큰도, 돌고 있는 agent도 없다. 남는 것은 hub뿐이고, 계속 띄워 두기에 부담이 작다.

둘째는 이벤트 소싱이다. 모든 상태는 append-only 로그에서 파생되고, 로그는 hub가 응답하기 전에 인덱스와 같은 트랜잭션으로 기록된다. 프로세스를 죽여도 확정된 작업은 살아남는다. 어느 라운드든 나중에 번호로 설명할 수 있다. 스키마 변경은 마이그레이션 스크립트 대신 로그에서 다시 만든다.

셋째는 명령과 데이터의 분리다. issue 제목 같은 외부 텍스트는 자료로서 파일에 저장되고 프롬프트에 이어 붙지 않는다. 프롬프트가 나르는 것은 검증된 type, id, link뿐이다. 어느 agent가, 어느 디렉터리에서, 어떤 권한으로 도는지는 전부 로컬 규칙에서 나온다. cwd, agent, access를 스스로 달고 온 이벤트는 거부된다.

넷째는 hop fuse이고, 내가 가장 좋아하는 부분이다. agent가 만든 이벤트를 다시 agent로 보내면 깊이가 쌓인다. 패킷이 TTL을 쌓는 방식과 같다. 사람의 질문과 예정된 재확인은 카운터를 초기화하지 않고, agent도 그것을 고칠 수 없다. 8단계를 넘으면 hub는 디스패치를 멈추고 이벤트를 기록한 뒤 대신 카드를 보낸다.

숫자, 그리고 내가 믿기를 멈추는 지점

벤치마크 표는 Apple M5 Pro, 24 GB, Node 24.21.0에서 나왔다. 쓰기는 하나씩 커밋하고 트랜잭션은 응답 전에 디스크로 간다. 콜드 스타트 88.78 ms. 유휴 메모리 59.94 MB RSS. 긴 폴링 1,000개 동시에 170.49 MB. 초당 2,394회 영속 쓰기. 디스패치 p99가 1.82 ms이고, 큐에 5,000개가 쌓인 상태에서 하트비트 p99가 1.66 ms다. 110만 건의 팩트 위에서 기동 99.8 ms. 런타임 의존성은 0이다.

이것은 애플리케이션 숫자가 아니라 큐 숫자이고, 바로 그게 핵심이다. 기다림을 행으로, 작업을 이벤트로 저장하는 hub라면 큐처럼 동작하는 게 당연하다.

내 회의는 이렇다. 머신 한 대, 운영자 한 명, 따뜻한 페이지 캐시, 그리고 커널을 쓴 사람이 직접 쓴 하네스. 영상 통화를 켜 두고 빌드가 도는 노트북에서 이 벤치마크를 돌린 적은 없다. 하한으로 읽고 약속으로 읽지 말 것. 110만 건이라는 숫자에는 다른 곳에 정직한 대가가 붙어 있다. README에는 포맷이 바뀐 뒤 첫 기동이 로그에서 재구성된다고 적혀 있고, 그때 43.1초가 걸렸다. 노트북에서는 괜찮지만, 아니라고 가정했다면 곤란하다.

자율성이 당신을 해칠 수 있는 두 곳, 그리고 물려받는 것

보안은 저자들이 가장 영리한 척하지 않은 지점이고, 이건 칭찬이다. 명령과 데이터의 분리 덕분에 악의적인 issue 제목이 실행을 다른 디렉터리나 다른 agent로 돌릴 수 없다. 그 필드는 문에서 거부된다. hop fuse 덕분에 agent들이 서로 일을 넘기며 영원히 돌 수는 없다. 깊이는 참여자가 아니라 hub가 올리기 때문이다.

둘 다 증명은 아니다. fuse는 8단계라는 정책이다. 정당한 워크플로가 9단계를 필요로 한다면 그건 당신의 문제다. 그리고 위험한 경우가 한 홉마다 실제 피해를 내는 느린 2단계 루프라면, fuse는 끝내 발동하지 않는다. 분리가 지키는 것은 디스패치 결정이고, 당신이 넘겨준 디렉터리에서 셸을 얻은 뒤 agent가 하는 일은 아니다.

시뮬레이션은 대부분의 프로젝트보다 강하다. node sim/random.ts 24301 200000은 고정 시드로 연결 끊김, 패킷 손실, 크래시, 중복 제출을 20만 스텝 돌리므로 실패를 재현할 수 있다. node sim/crash.ts 1000 12648430은 프로세스를 1,000번 죽이고 확정된 기록이 사라지지 않는지 확인한다. 그다음 README가 덧붙인다. 머신 전체의 전원 손실은 시험하지 않았다고. 나는 이 문장을 존중하고, 동시에 또 무엇을 시험하지 않았는지 묻게 된다. webhook 템플릿은 로컬 mock 서버에만 돌렸다. GitLab webhook은 문서에 적힌 형식과만 대조했고 실제 GitLab에는 한 번도 대 보지 않았다. 레시피 스크립트는 가짜 Feishu CLI로 검증했다. 각각이 '테스트했다'는 말이 독자가 짐작하는 것보다 가벼운 지점이다.

손으로 쓴 커널과 런타임 의존성 0으로 물려받는 것은 유지보다. 작은 의존성 트리는 누군가 지켜보는 동안은 나이가 들수록 좋아지고, 저자가 떠나면 나빠진다. 그것이 88 ms 콜드 스타트의 대가다.

청구에 관한 세부 하나는 설계 밖에 있다. hub는 당신 머신에 이미 설치되고 로그인된 CLI 도구를 돌리므로 사용량은 당신 계정이나 구독으로 간다. README는 고빈도 자동화에는 API 키를 쓰라고 벤더들이 선호한다고 적는다. 개인 요금제는 사람의 속도에 맞춘 상호작용을 전제로 만들어졌기 때문이다. cron 규칙을 당신의 Claude Code 세션에 걸어 두고 잠자리에 들기 전에 이 문장을 두 번 읽어라.

위의 모든 메커니즘을 통과하는 위험이 하나 있다. GitHub issue를 열 수 있고, 전달 파이프라인을 통해 deliver 라벨이 붙은 pull request까지 머지할 수 있는 루프는 당신의 자격 증명을 쥔 공급망 행위자다. 위의 모든 것은 그것을 신뢰할 만하게 만들고 목줄을 짧게 한다. 당신이 설정한 review 단계가 그것과 나쁜 머지 사이에 있는 유일한 것이고, 아무리 event sourcing을 쌓아도 읽지 않은 review는 나아지지 않는다.

관련 글