KKKKhazix/agent-autoloop
Agent Autoloop, 커맨드라인 에이전트를 백그라운드 자동화 플랫폼으로
원제 KKKKhazix/agent-autoloop
스타 4,022TypeScript
Key Point
사용자 개입 없이 CLI 에이전트가 장시간 자동으로 작업을 추진하고 판단이 필요할 때만 알림을 받는 구조로, 개인 개발자부터 팀 자동화까지 기존 에이전트 워크플로의 근본적인 한계를 해결한다.
핵심 요약
- Claude Code나 Codex 같은 커맨드라인 에이전트가 터미널 조작 없이 백그라운드에서 자동으로 작업을 처리하고 반복 추진하는 경량 자동화 중플랫폼이다.
- 인코드 요청이 생기면 슬랙, 飞书, 디스코드 등을 통해 카드를 전송해 사용자 승인을 기다리며, 승인 전까지 프로세스는 메모리를 차지하지 않고 대기 상태를 데이터베이스에 저장한다.
- TypeScript 기반, 약 1850줄의 제로 외부 의존성 내핵을 사용하며 Windows, macOS, Linux에서 단일 명령어로 실행되고 별도 클라우드 서버나 공개 포트가 필요 없다.
- 규칙 파일(`rules.json`)에 '무엇 → 누가 → 어디서'를 정의하면, 정시 작업, GitHub 이벤트, HTTP 훅, 폴링 등 다양한 이벤트 소스를 연결할 수 있다.
- Claude Code, Codex, DeepSeek Harness 등 여러 에이전트와 飞书, 钉钉, 슬랙 등 통지 채널을 플러그인 방식으로 자유롭게 교체할 수 있다.
- 에이전트는 최종 회신에 JSON 형식의 `agent-autoloop` 블록을 포함해 선택지 제시, 알림, 카드 닫음, 복검 예약, 새 이벤트 발동 등을 지시한다.
- 동일 사건의 새 이벤트는 기본적으로 새 세션을 열지만 규칙에 `"resume": true`를 설정하면 이전 대화를 이어받아 중복 작업을 방지한다.
- 일일 조조보고, GitHub Issue 추적, 온라인 알람 대응, 사용자 피드백 처리, 웹사이트 순찰, PR 자동 배포 등 8가지 실전 시나리오 템플릿을 기본 제공한다.
- 모든 상태는 추가만 가능한 로그에서 계산되고 디스크에 트랜잭션 단위로 저장되므로, 프로세스 강제 종료 시에도 확정된 기록은 손실되지 않는다.
- 지정 깊이를 초과하는 재귀적 이벤트 파견(Agent가 새 이벤트 발동 시 최대 8단계로 제한)은 기록만 하고 더 이상 파견하지 않으며 사용자에게 알린다.
- Apple M5 Pro 기준 콜드스타트 88.78ms, 유휴 메모리 59.94MB, 지속성 쓰기 초당 2394건, 110만 건 이력 로드 시 99.8ms의 성능을 실측했다.
- 프로젝트는 설치 설명, 규칙 설정 가이드, 플러그인 개발 문서, 전체 통신 프로토콜, 보안 경계 설명 등을 포함한 완전한 설명서를 제공한다.
저장소 보기 ↗github.com