오늘의 AI 오픈소스 · 2026-11-12
KKKKhazix/agent-autoloop
Agent Autoloop은 명령행 AI 에이전트가 백그라운드에서 일을 받아 끝까지 처리하게 하는 자동화 도구다.
| 저장소 | github.com/KKKKhazix/agent-autoloop ↗ |
|---|---|
| 주 언어 | TypeScript |
| 라이선스 | MIT |
| GitHub 별·포크 | ★ 4,526 · 포크 827 (2026-11-12 기준) |
| 만든 날·최근 업데이트 | 2026-11-03 · 2026-11-11 |
| GitHub 주제 | ai-agents, automation, claude-code, cli, codex, event-driven, mcp, nodejs |
소개
Agent Autoloop은 Claude Code, Codex 같은 명령행 에이전트를 사람이 터미널 앞에 지켜 앉아 있지 않아도 돌아가게 하는 가벼운 자동화 중계 도구다. 정해진 시간이나 외부 이벤트가 들어오면 에이전트에게 일을 넘기고, 판단이 필요한 일에만 사람에게 카드를 보내 결정을 받는다.
작업 스케줄링을 맡는 내부 코어는 외부 의존성이 없고, 이벤트 소스·에이전트·알림 채널·배포 파이프라인은 모두 플러그인으로 갈아 끼운다. 사용자는 rules.json에 '어떤 일을, 어느 에이전트에게, 어느 디렉터리에서' 맡길지 적고, 에이전트는 마지막 응답 끝에 agent-autoloop 코드 블록을 붙여 질문·알림·재확인 예약을 남긴다. 결정을 기다리는 동안에는 프로세스를 띄워 두지 않고 토큰도 쓰지 않으며, 답을 받으면 원래 대화를 이어 남은 일을 마친다.
이미 명령행 에이전트를 쓰고 있고 이슈 대응, 아침 보고서 작성, 장애 알림 확인처럼 반복되는 일을 맡기고 싶은 개발자에게 맞다. 클라우드 서버나 공개 포트 없이 개인 컴퓨터 한 대에서 돌아간다.
왜 눈여겨볼까
명령행 에이전트를 대화형 도구가 아니라 이벤트를 받아 일하는 백그라운드 작업자로 쓰게 하는 설계가 눈에 띈다. 위험한 작업에서만 사람에게 묻고, 기다리는 동안 자원을 쓰지 않다가 같은 대화로 돌아와 이어서 처리하는 Human-in-the-loop 흐름을 SDK나 에이전트 코드 수정 없이 응답 형식 하나로 풀었다.
주요 기능
- 정해진 시간, GitHub·GitLab Webhook, HTTP 요청에서 들어온 이벤트를 규칙에 따라 정해진 에이전트와 디렉터리에 배정한다.
- Claude Code, Codex, ACP, DeepSeek Harness, ZCode를 내장 플러그인으로 지원하고, 프롬프트를 받아 마지막 응답을 출력하는 명령행 도구라면 설정 한 줄로 연결할 수 있다.
- 데이터 삭제, 서비스 재시작, 비용 지출, 외부 메시지 발송처럼 판단이 필요한 일은 데스크톱 알림, Feishu, DingTalk, WeCom, Slack, Discord로 카드를 보내 결정을 받는다.
- 규칙 일시 중지·재개, 놓친 이벤트 재실행, 실행 이력과 경위 조회, 규칙 점검·사전 시뮬레이션 명령을 제공한다.
- PR에 deliver 라벨을 붙이면 리뷰, CI 대기, 병합, 배포 확인까지 이어 가는 배포 플러그인이 있다.
이런 데 씁니다
- 매일 아침 로컬 노트와 Git 커밋을 정리해 보고서를 쓰게 한다.
- 새 GitHub 이슈를 주기적으로 확인해 로컬에서 코드를 고치고 결과를 알려 받는다.
- 장애 알림을 받아 코드와 대조해 원인을 찾고, 재시작이 필요하면 확인을 받은 뒤 진행한다.
- 웹사이트 상태를 점검하거나 읽지 않은 메일을 분류해 답장 초안을 만든다.
시작하기
- Node 24 이상과 Git, 로그인된 명령행 에이전트를 준비한다(macOS·Linux는 curl도 필요하다).
- macOS·Linux에서는 curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh, Windows PowerShell에서는 irm https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.ps1 | iex 로 설치한다.
- agent-autoloop try 로 질문, 결정, 이어서 처리하는 흐름을 한 번 실행해 본다.
- ~/.agent-autoloop/rules.json에 규칙을 추가한 뒤 agent-autoloop check 로 점검한다.
고를 때 따질 점
- 2026년 11월에 만든 프로젝트라 규칙 형식과 명령이 바뀔 수 있다.
- README에 따르면 시나리오 템플릿은 로컬 HTTP와 가짜 Feishu CLI로만 검증했고 실제 계정에서 전체 업무를 돌려 보지는 않았다.
- 에이전트가 백그라운드에서 스스로 작업하므로 사용하는 에이전트의 토큰 비용과 권한 범위를 미리 정해 둬야 한다.
- 일부 템플릿은 기본값이 베이징 시간과 Feishu 개인 메시지로 되어 있어 환경에 맞게 바꿔야 한다.
관련 용어·기업
출처
저장소 README와 GitHub 정보를 근거로 AI를 활용해 정리했습니다. 별 수 등 숫자는 기준일의 GitHub 값이며, 기능·라이선스는 바뀔 수 있으니 저장소에서 확인하세요.