프로젝트 소개

agent-runner는 자율 코딩 CLI를 지속적으로 실행하기 위한 감독 도구입니다. 각 라운드 후 에이전트 프로세스를 재시작하며 Claude Code, aider, gemini, codewhale, kimi, pi용 프리셋을 제공하고, 사용자 지정 구성을 통해 모든 프롬프트 인자 CLI를 지원합니다. 이 도구는 3계층 모델로 구성됩니다. Round(에이전트 1회 호출), Loop(신호를 포착하는 재시작 루프), Witness(14개 감지기와 자동 중지를 갖춘 모니터)입니다. 라운드 시간 예산, 프로세스 그룹 격리, 고아 스태시 멱등성, SHA 잠금 스태시, 집합 차이 분류, 시작 스모크 체크 등 데이터로 구조화된 15개의 명명된 방어 체계를 제공합니다. 각 방어 체계는 해결한 과거 사고를 문서화하고 불변식 테스트를 갖추고 있습니다. 모니터 구성 요소는 감독 대상 프로젝트의 로컬 로그에 대해 14개 감지기를 실행하여 타임아웃 비율, 중단된 라운드, 고아 체인, 디스크 경고 및 증가, 메모리 압박, 네트워크 실패, 속도 제한, 반복적 이상 징후 등의 문제를 다룹니다. 두 감지기는 계속하는 것이 해로울 때 서비스를 자동 중지할 수 있습니다. API 할당량을 소진시키는 OAuth 실패와 심각한 디스크 상태가 그것입니다. 선택적 소프트 브레이크는 지속적인 압박 하에서 메모리 사용량을 제한할 수 있습니다. agent-runner는 수명 주기 관리(init, install, start, stop, restart, kill, upgrade, migrate)와 관찰(peek, watch, monitor, events, status, doctor)을 위한 17개 명령 동사를 제공합니다. serve 및 monitor 프로세스를 위한 systemd 사용자 유닛, 예약된 실행/일시 중지 창, 다운스트림 소비자를 위한 JSON 출력, 관리형 SSH 연결을 통한 원격 이벤트 릴레이를 지원하면서 감지는 호스트에서 유지합니다. 이 프로젝트는 빠른 시작, 명령 참조, 구성 스키마, 운영자 문제 해결, 아키텍처를 다루는 광범위한 문서를 포함합니다. POSIX 전용(Linux, macOS)이며 x86_64 및 aarch64에서 Python 3.11+로 테스트되었고 Apache 2.0 라이선스를 따릅니다.