먼저 결론:
- Agent Autoloop(MIT)는 「터미널을 지키는」 방식을 「이벤트 / cron → 한 라운드 후 종료 → 필요할 때만 카드 → 답하면 같은 세션 재개」로 바꿉니다. README는 macOS / Linux. Windows 공식은 미정(issue #17, 당장은 WSL2).
- 설치:
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh, 이어서agent-autoloop try. - 2026년 11월 6일 Linux 실측: Node 24.22.2, agent-autoloop v1.5.0, Codex(aicodewith,
gpt-6.1-sol). 승인 루프 성공 — 색 카드까지 약 9초, 「초록」 답 후 같은 세션에서 약 10초 「시범 통과」. GUI 없음으로notify-send부재, CLI로 완주. - 규칙은
~/.agent-autoloop/rules.json.agent-autoloop check로 검증. - 무인 운영은 곧 로컬 권한. 카드 링크를 밖으로 보내지 말고 Webhook을 인증하세요. SECURITY에 따르면 프롬프트 인젝션이 완전히 해결되지 않았고, 기본은
edit, 부작용은ask.
API Key를 만들고 Claude Code / Codex를 연결한 뒤 루프 시작 →
무엇을 해결하나
Claude Code나 Codex는 터미널을 보며 쓰는 경우가 많습니다. 창을 닫으면 멈춥니다.
Agent Autoloop는 결정적 kernel(README 기준 약 1650줄·런타임 의존성 0)을 중심으로 이벤트·에이전트·알림·배포를 플러그인으로 교체합니다.
- 이벤트 유입 — 아침 9시 cron, 새 GitHub Issue, 알림.
- 규칙으로 배정 — 어떤 Agent·어느 디렉터리. 같은 주제는 병합.
- 한 라운드 후 종료 — 기다리는 동안 Agent 프로세스 없음.
- 필요할 때만 카드 — 삭제·재시작·외부 발송 등.
- 답으로 재개 — 원래 대화를 이어감.
README에 따르면 Claude Code / Codex / ACP는 멀티턴·세션 재개가 실측됐고, Feishu는 실제 전송이 있습니다. Webhook 등은 로컬 mock 중심.
사전 요구
| 항목 | 요구 |
|---|---|
| OS | macOS / Linux. Windows 공식 미정(#17). INSTALL에 WSL2 |
| 런타임 | Node.js 24+, Git, curl |
| Agent | 사용 가능한 Claude Code 또는 Codex(command 가능) |
| aicodewith Key(선택) | 가입 후 API Key 생성 |
이 머신은 Node 22 → n 24로 24.22.2.
0단계: API Key
- aicodewith.ai 가입 후 「키 관리」.
- 「키 만들기」, 알아보기 쉬운 이름(예
autoloop-box). - 즉시 전체 키 복사. Create API Key 문서.
Codex — ~/.codex/config.toml:
model = "gpt-6.1-sol"
model_provider = "aicodewith"
[model_providers.aicodewith]
name = "aicodewith"
base_url = "https://api.aicodewith.ai/chatgpt/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_API_KEY"
Claude Code — ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
}
}
관련: Codex 설치, Codex API Key, config.toml, Claude Code 백그라운드 서브에이전트, Conductor 대안 worktree.
설치
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh
앱은 ~/.agent-autoloop/app. CI / 헤드리스는 --no-service 후 agent-autoloop up(INSTALL).
실측(2026-11-06, Asia/Shanghai): v1.5.0(f211ca2de3b1), Agent는 Codex.
agent-autoloop --version
agent-autoloop doctor
agent-autoloop up
agent-autoloop try
최소 루프: try → answer → status
Codex 타임라인(UTC+8):
| 단계 | 시각 | 결과 |
|---|---|---|
| try | 15:25:01 → 15:25:10 | 약 9초, 색 카드 |
| answer 1 2 | 15:25:27 | 초록, 3라운드, 같은 세션 |
| 완료 | 15:25:27 → 15:25:37 | 약 10초, 「시범 통과」 |
| 알림 | — | notify-send 없음. CLI OK |
agent-autoloop answer 1 2
agent-autoloop status
agent-autoloop why 3
솔직한 기록: 첫 try는 모델명이 사이트에 없어 실패. gpt-6.1-sol로 바꾼 뒤 성공. Claude Code 단독 스모크 약 6초 OK. 이번 try는 Codex 플러그인.
rules.json
아침 브리프(README):
{
"name": "Morning brief",
"when": { "cron": "0 9 * * *" },
"to": "codex",
"cwd": "~/notes",
"prompt": "Summarize yesterday's notes and commits into today's brief."
}
check OK. rules explain은 Asia/Shanghai, 다음 실행 11/07 09:00. GitHub issues 예는 저장소.
Claude Code / Codex / 기타
use는 claude / codex / acp / dsh, 또는 {prompt}를 단일 인자로 두는 command. Claude Code / Codex / Cursor는 대등한 선택지. worktree 병렬은 Conductor 대안.
보안
SECURITY: 로컬 권한, 카드 링크 7일·소지=응답, 이벤트가 Agent를 고르지 못함, Webhook 인증, CLI 로그인 미중계, 측정 후 Key 설정 삭제.
FAQ
Windows? 미정(#17), WSL2 있음. 서비스 필수? 아니요. try 실패? doctor, Node ≥ 24, 모델 목록, 완전한 experimental_bearer_token.
정리
Node 24 → 설치 → try / answer / status → cron 규칙 → SECURITY → Key 삭제.



