정의

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 그대로 사용✅✅✅❌
내 머신 꺼진 상태에서도 운영❌❌❌✅

설치·사용 흐름

  1. 설치·설정: herdr plugin install eliasstravik/herdr-projects → herdr-projects configure(사이드바 행, 팝업 키, 진행 훅 한 번만).
  2. 프로젝트 생성·오픈: Projects: new project 액션, 또는 herdr-projects new "<이름>" --repo <경로> → herdr-projects open <이름>. 코디네이터 에이전트가 프로젝트 폴더에서 시작되고 해당 프로젝트의 AGENTS.md로 자체 priming.
  3. 작업 지시: 코디네이터 pane에 원하는 작업을 말로 전달. 코디네이터가 스레드를 제안하면 승인, 사이드바에 각 스레드 상태가 표시된다.

프로젝트는 ~/.herdr-projects/<이름>/ 아래에 파일 집합으로 저장된다:

  • PROJECT.md — 설정·스탠딩 지시
  • AGENTS.md — 코디네이터 priming
  • MEMORY.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) 루프다.

  1. 코디네이터에서 /autoproject를 입력하고 프로젝트 브리프, 리뷰 루브릭, 반복 한도를 준다.
  2. 메이커 에이전트가 변경 하나를 만들어 커밋한다.
  3. 새로 띄운 리뷰어 에이전트가 메이커는 본 적 없는 루브릭으로 블라인드 판정한다.
  4. 나아졌으면 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에서도 추적됨.