정의
Herdr Projects는 Herdr 위에서 큰 작업을 여러 코딩 에이전트로 나눠 병렬 실행할 때 쓰는 플러그인이다. 사용자가 코디네이터 에이전트와 한 대화만 유지하고, 코디네이터가 태스크마다 별도 에이전트(스레드)를 띄워 각자 브랜치·worktree에서 작업하게 한다. 사용자 측에는 사이드바와 팝업(prefix+a)으로 각 스레드의 상태(needs you / review / working)가 집계된다.
핵심 설계 포인트:
- 코디네이터는 직접 작업하지 않는다. 항상 응답 대기 상태를 유지하며, 스레드 제안→사용자 승인→스레드 실행 흐름으로 진행한다.
- 스레드마다 독립된 git worktree + 브랜치를 쓴다(레포가 없으면 별도 폴더). Claude Code, Codex, OpenCode 등 Herdr이 띄울 수 있는 에이전트 CLI면 무엇이든 쓸 수 있다.
- 공통 기억(instructions + memory) 을 모든 스레드 브리프에 공유한다. 스레드가
## Remember로 보고한 교훈은 다음 스레드 메모리에 반영된다. - PR 추적: 배경 티커가 PR을 따라가며, 실패한 CI·리뷰 코멘트를 스레드로 돌려준다. 머지되면 해당 스레드는 해소(resolve)되고 worktree·브랜치를 정리한다(보고서·산출물은 먼저 복사본으로 보존).
- 수락/주기적 해소: 스레드는 사용자가 직접 해소하거나, PR 머지, 또는
auto_resolve_days경과 후 정리된다.
비교 관점
| 기준 | Herdr Projects | 사람 손으로 각각 브리핑 | 긴 에이전트 세션 1개 | 클라우드 프로젝트 상품 |
|---|---|---|---|---|
| 추가 소프트웨어 비용 | 없음 | 없음 | 없음 | 있음 |
| 별도 브랜치로 병렬 태스크 | ✅ | ✅ | ❌ | ✅ |
| 모든 태스크에 동일 지시·기억 | ✅ | ❌ | ✅ | ✅ |
| 답변 가능한 단일 대화 유지 | ✅ | ❌ | ❌ | ✅ |
| 내가 필요한 스레드만 묶어 표시 | ✅ | ❌ | ❌ | ✅ |
| 내 머신에서 실행 | ✅ | ✅ | ✅ | ❌ |
| 이미 띄운 에이전트 pane 채택 | ✅ | ✅ | ❌ | ❌ |
| 내가 쓰는 에이전트 CLI 그대로 사용 | ✅ | ✅ | ✅ | ❌ |
| 내 머신 꺼진 상태에서도 운영 | ❌ | ❌ | ❌ | ✅ |
설치·사용 흐름
- 설치·설정:
herdr plugin install eliasstravik/herdr-projects→herdr-projects configure(사이드바 행, 팝업 키, 진행 훅 한 번만). - 프로젝트 생성·오픈: Projects: new project 액션, 또는
herdr-projects new "<이름>" --repo <경로>→herdr-projects open <이름>. 코디네이터 에이전트가 프로젝트 폴더에서 시작되고 해당 프로젝트의AGENTS.md로 자체 priming. - 작업 지시: 코디네이터 pane에 원하는 작업을 말로 전달. 코디네이터가 스레드를 제안하면 승인, 사이드바에 각 스레드 상태가 표시된다.
프로젝트는 ~/.herdr-projects/<이름>/ 아래에 파일 집합으로 저장된다:
PROJECT.md— 설정·스탠딩 지시AGENTS.md— 코디네이터 primingMEMORY.md/memory/— 코디네이터 기억TASKS.md— 코디네이터가 관리하는 태스크 목록uploads/— 스레드에 건넬 파일threads/— 스레드 기록·보고서library/— 스레드가 만든 파일- 안전 설정만 별도
~/.config/herdr-projects/config.toml(에이전트가 작업하지 않는 영역).
권한·안전성
- 코디네이터는 매 턴
herdr-projects바이너리를 실행하므로, 에이전트 허용 목록(allow-list)은 서브커맨드 단위로 관리하는 것이 권장된다. 읽기·유도 계열(skill,context,report,inbox done,thread list/prompt/next등)은 허용,thread resolve,sweep,delete,routine approve,configure, 그리고start_threads = "auto"가 아닌 한thread start는 일반 권한 프롬프트에 남긴다. - 안전 설정은 “소프트”하다. 기본 상태에서는 코디네이터가 스레드를 제안하고 대기하며, 스레드 에이전트는 평소 권한 프롬프트를 그대로 유지한다(코디네이터가 모델만 고를 수 있고 런치 플래그까지 건드리진 못함). 루틴(routine)은 사용자가 활성화하고 터미널에서 명령별로 승인하기 전까지 셸 명령을 실행하지 못한다.
- 다만 에이전트에 셸이 있다는 점은 한계로 명시된다: skip-permission 인자로 실행되는 셸은 관련 파일을 편집할 수 있고, 스레드가 코디네이터를 사용자처럼 가장해 프롬프트할 수 있으며, 승인된 루틴 명령은 그 명령 텍스트만 커버하고 호출하는 스크립트까지는 커버하지 않는다. 또한 메모리에 도달한 내용은 이후 브리프마다 반복된다.
비용·라이선스
- MIT 라이선스, 무료. 에이전트 CLI의 기존 사용 요금은 그대로 적용된다 — 스레드 하나가 완전한 에이전트 세션이고, 코디네이터도 매 턴 digest를 읽으며 토큰을 소모한다.
- Herdr 0.9.1+ 필요. macOS / Linux. Rust / Cargo, Git, Herdr이 실행 가능한 에이전트 CLI(예: Claude Code) 필요.
업데이트
- 0.2.2 이하(최초에
update가 없던 버전)는 한 번만 수동 업데이트:herdr-projects --version확인 → 이후update.herdr plugin link로 로컬 체크아웃을 연결했다면git pull+cargo build --release --locked로 대체. - 그 이후 버전부터는
update가 두 설치 방식 모두를 처리하며 이미 최신이면 아무 작업도 하지 않는다. 연결된 체크아웃은main브랜치에 미커밋 변경이 없어야 하며 아니면update가 이유를 말하고 멈춘다. 빌드 실패 시 이전 버전이 유지되며 티커가 재시작된다.doctor로 새 버전 출시 여부를 확인할 수 있다.
/autoproject — 자율 반복 개선 루프
작성자 @eliasstravik(2026-09-25 03:23)에 따르면 herdr-projects는 공개 일주일이 안 돼 Herdr 플러그인 역대 상위 10위에 올랐고, Karpathy의 autoresearch에서 착안한 /autoproject가 추가됐다. 프로젝트 하나를 수십~수백 번 반복해 손대지 않고 다듬는 래칫(ratchet) 루프다.
- 코디네이터에서
/autoproject를 입력하고 프로젝트 브리프, 리뷰 루브릭, 반복 한도를 준다. - 메이커 에이전트가 변경 하나를 만들어 커밋한다.
- 새로 띄운 리뷰어 에이전트가 메이커는 본 적 없는 루브릭으로 블라인드 판정한다.
- 나아졌으면 PR로 머지하고, 나빠졌으면 버린다. 한도에 닿을 때까지 반복한다.
설치는 herdr plugin install eliasstravik/herdr-projects, 기존 사용자는 herdr-projects update.
관련 노트
- 2026-08-02-herdr-agent-multiplexer — herdr 본체: 터미널 속 에이전트 멀티플렉서(tmux for AI agents). Herdr Projects가 동작하는 런타임/플랫폼.
- 2026-08-02-herdr-browser — Herdr pane 안에 실제 Chromium을 렌더링하는 공식 브라우저 플러그인(브라우저 자동화·CDP 연동).
- moc-ai-agents-orchestration — 에이전트 오케스트레이션 상위 MOC. Herdr Projects는 코디네이터/스레드 병렬 실행 패턴으로 이 MOC에 속함.
- moc-ai-coding — AI 코딩 운영면 MOC. Herdr Projects는 코딩 에이전트 세션 관리·보고·再開 도구로 이 MOC에서도 추적됨.