Agent Autoloop: 터미널을 닫아도 에이전트가 일을 이어 가게
에이전트가 뒤에서 일을 받아 끝까지 하고, 사람이 정해야 할 때만 카드로 물어봐요
- 누가
- KKKKhazix가 Claude Code, Codex 같은 명령줄 에이전트를 쓰는 사람을 위해 만들었어요. MIT 라이선스예요.
- 언제
- 2026년 11월 3일에 저장소가 열렸고, 11월 13일에 1.8.3이 나왔어요.
- 어디서
- Windows, macOS, Linux의 내 PC. Claude Code, Codex, ACP를 말하는 에이전트, 그 밖의 명령줄 에이전트와 붙어요.
이게 불편했어요
Claude Code나 Codex는 대개 터미널 앞을 지키며 써요. 한 줄 시키고, 도는 것을 보고, 다음을 물으면 답해 줘야 하죠. 창을 닫거나 자리를 비우면 일은 거기서 멈췄어요.
그래서 이렇게 풀어요
Agent Autoloop은 내 PC에 까는 작은 허브예요. 아침 9시가 되거나 GitHub에 새 Issue가 생기면 rules.json에 적어 둔 규칙대로 에이전트에게 일을 맡겨요. 에이전트는 한 차례 일하고 종료하는데, 데이터 삭제나 서비스 재시작처럼 사람이 정해야 할 일이면 카드 한 장을 보내요. 기다리는 동안에는 에이전트 프로세스도 토큰도 쓰지 않고, 답하면 원래 대화를 이어서 마저 끝내요.

이걸로 만든 사람들
Codex 한 세션을 밤새 돌리며 차례마다 읽은 입력 토큰을 표로 쟀어요. 외부 API가 살아나기를 기다리며 같은 세션에 계속 이어 붙이자, 할 일이 없는 차례에도 18만~19만 토큰이 들었다고 해요.
实测缓存命中率始终在 97% 左右,因此主要开销并非来自缓存过期,而是长会话本身的体量累积。
자기 飞书 앱에 알림 채널을 붙여 보았어요. lark-cli 1.0.66에서는 카드가 나가지 않았고, 1.0.100으로 바꾸자 같은 설정으로 정상이었다고 해요.
2026-11-12 真机实测(本机先在 1.0.66 上复现,换 1.0.100 后同一配置即正常)
안에서는 이렇게 돌아가요
- 1
이벤트 (cron, GitHub) → 허브의 kernel
표준 이벤트 한 건Webhook이나 정해 둔 시각이 종류, 대상, 링크를 가진 이벤트가 돼요.plugins/github/source.ts - 2
- 3
worker → Claude Code / Codex
claude -p … --session-id에이전트를 따로 띄우고, 사람이 쓴 글은 프롬프트가 아니라 자료 파일로 건네요.plugins/claude/agent.ts - 4
Claude Code / Codex → worker
마지막 답 + agent-autoloop 블록ask, notice, resolve, later, events 가운데 필요한 것을 적고 프로세스가 끝나요.worker/contract.ts - 5
- 6
- 7
- 8
Claude Code / Codex → 끝난 일과 status 기록
결론 한 줄agent-autoloop status에 차례 수, 토큰, 비용과 함께 남아요.cli/status.ts
넣으면 이렇게 나와요
나한테 맞을까요
이럴 때 좋아요
- 매일 같은 시각에 브리핑이나 받은편지함 정리를 받아 보고 싶을 때
- 새 Issue나 서비스 알림을 에이전트가 먼저 살펴보게 하고 싶을 때
- PR에 라벨만 붙이고 리뷰부터 배포 확인까지 맡기고 싶을 때
- 서버 없이 내 PC 한 대에서 에이전트를 뒤에 돌려 두고 싶을 때
이건 안 돼요
- 명령 출력과 기본 알림 문구는 아직 중국어예요(영문 README 기준).
- 긴 세션을 이어 붙이면 할 일이 없는 차례에도 토큰이 들어요. 한 사용자는 Codex에서 한 차례에 18만~19만을 쟀어요(Issue #268).
- 자주 도는 자동화에는 구독 대신 API 키를 쓰라는 것이 각 회사의 권고라고 README가 밝혀요.
- 钉钉, 企微, Slack, Discord 알림 틀은 로컬 모의 서버에서만 확인했다고 해요.
발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요