GitHub Trending오픈소스 · 도구

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의 성능을 실측했다.
  • 프로젝트는 설치 설명, 규칙 설정 가이드, 플러그인 개발 문서, 전체 통신 프로토콜, 보안 경계 설명 등을 포함한 완전한 설명서를 제공한다.
AI 요약 안내

AI가 한국어로 정리한 내용입니다. 정확한 정보는 원문을 확인해 주세요.

요약 원칙 ↗