Cook - AI Agent Orchestration CLI

Claude Code, Codex, OpenCode를 오케스트레이션하는 간단한 CLI

핵심 컨셉

Work (프롬프트 하나 = 에이전트 호출 1회) 위에 Loop/Composition 연산자를 조합해서 복잡한 워크플로우를 구성.

연산자

Loop (순차 반복)

연산자설명
xNN번 순차 실행
reviewreview → gate → iterate 루프 (기본 최대 3회)
ralph N "gate"gate가 DONE할 때까지 반복

Composition (병렬 실행 후 병합)

연산자설명
vNN개 동일 브랜치 병렬 실행 → best 선택
vs두 개 다른 브랜치 → best 선택
pick, merge, compare결과 해결 방식

사용 예시

# review 루프
cook "Implement dark mode" review
 
# 3번 실행
cook "Implement dark mode" x3
 
# 3개 병렬, best 선택
cook "Implement dark mode" v3 "least code"
 
# 두 방식 비교
cook "Auth with JWT" vs "Auth with sessions" pick "best security"
 
# 태스크 리스트 처리
cook "Work on next task in plan.md" review ralph 5 "DONE if all tasks complete"

연산자 조합

왼쪽에서 오른쪽으로 조합됨:

cook "work" x3 review   # 3번 실행 후 review 루프
cook "work" review x3   # review 루프를 3번 반복
cook "work" review v3   # review 루프가 달린 3개 병렬 실행

Review 커스터마이징

# 기본 (최대 3회)
cook "Add dark mode" review
 
# 최대 5회
cook "Add dark mode" review 5
 
# 커스텀 프롬프트
cook "Add dark mode" "Review for accessibility" "DONE if WCAG AA, else ITERATE"
 
# 에이전트/모델 지정
cook "Add dark mode" review --work-agent codex --review-agent claude --review-model opus

Rate Limit 대응

토큰 쿼터/Rate limit 도달 시 자동으로 대기 후 재시도.

# 비활성화
cook "Build the feature" review --no-wait

.cook/config.json 설정:

{
  "retry": {
    "enabled": true,
    "pollIntervalMinutes": 5,
    "maxWaitMinutes": 360
  }
}

설치

Skill (CLI 없음) — 에이전트가 직접 서브에이전트 오케스트레이션:

mkdir -p .claude/skills/cook && curl -fsSL https://raw.githubusercontent.com/rjcorwin/cook/main/no-code/SKILL.md -o .claude/skills/cook/SKILL.md

CLI — 터미널/CI용:

npm install -g @let-it-cook/cli
mkdir -p .claude/skills && cp -r $(npm root -g)/@let-it-cook/cli/skill .claude/skills/cook

요구사항

Sources