eliasstravik/herdr-projects

Herdr Projects – 하나의 작업을 위한 여러 개의 코딩 에이전트 조율

무엇인가요

• Herdr AI 코딩 환경(맥OS / 리눅스, Herdr 0.9.1 이상)용 무료이며 MIT 라이선스의 플러그인입니다.
• 코디네이터 에이전트를 추가하여 여러 독립된 에이전트 스레드로 구성된 "프로젝트"를 시작할 수 있게 합니다. 각 스레드는 자체 Git worktree/branch(또는 폴더)에서 작동합니다.
• 스레드가 병렬로 실행되는 동안에도 코디네이터와 단일 대화를 유지할 수 있으며, Herdr 사이드바는 스레드를 상태(당신이 필요함, 작업 중, 리뷰 대기 등)별로 그룹화하여 표시합니다.

왜 사용해야 할까요

• 한 개의 코딩 에이전트로는 너무 큰 작업의 경우, 수동으로 각 에이전트를 시작하고 추적하는 대신 자동으로 여러 에이전트로 분할할 수 있습니다.
• 코디네이터는 무거운 작업을 하지 않기 때문에 항상 질문에 응답할 수 있습니다.
• 모든 스레드는 동일한 목표, 지시사항, 메모리를 공유하므로 프로젝트 전체에서 일관성이 유지됩니다.
• 호스팅된 서비스가 필요 없으며, 모든 것이 귀하의 컴퓨터 및 SSH로 접근 가능한 컴퓨터에 저장됩니다.

주요 기능

기능	제공되는 기능
병렬 실행	각 작업이 자체 Git worktree/branch(또는 폴더)에서 실행되어 작업이 동시에 진행됩니다.
단일 채팅	코디네이터만과 대화하면 됩니다. 코디네이터는 진행 상황 보고서를 전달하고, 스레드가 당신의 도움이 필요할 때 입력을 요청합니다.
사이드바 개요	스레드 ID, 제목, 상태 태그(예: review · PR #4, ~40%)가 있는 행으로 표시됩니다.
자동 스레드 라이프사이클	PR이 머지되거나 스레드가 설정 가능한 기간 동안 무응답 상태가 되면, 플러그인이 worktree/branch를 정리하고 보고서를 안전한 위치로 복사합니다.
모든 Herdr 호환 에이전트와 호환	Claude Code, Codex, OpenCode, 또는 Herdr가 시작할 수 있는 CLI 기반 에이전트라면 어떤 것도 사용 가능합니다.
추가 비용 없음	모든 기능은 무료이며, 하위 에이전트 모델의 일반적인 사용료만 지불하면 됩니다.
사용자 정의 가능한 보안	코디네이터가 에이전트에게 수행할 수 있는 작업을 세밀하게 허용 목록으로 설정할 수 있으며, 선택적으로 "yolo" 모드로 자동 승인도 가능합니다.
CLI 우선 워크플로우	herdr plugin install eliasstravik/herdr-projects로 설치한 후, herdr-projects new, herdr-projects open, herdr-projects thread start 등의 명령어를 사용할 수 있습니다.

작동 방식(개요 흐름)

1. 설치 및 구성 – herdr plugin install …로 사전 빌드된 바이너리를 다운로드하고, herdr-projects configure로 사이드바 행, 팝업 키, /autoproject 스킬을 설정합니다.
2. 프로젝트 생성 – herdr-projects new "Billing" --repo ~/dev/app로 ~/.herdr-projects/ 아래에 PROJECT.md, AGENTS.md, MEMORY.md 등의 Markdown/TOML 파일을 포함한 폴더를 생성합니다.
3. 코디네이터와 대화 – 코디네이터 패널에서 전반적인 목표를 설명합니다. 코디네이터는 스레드 집합(각각 별도의 에이전트 작업)을 제안하고 승인을 기다립니다.
4. 스레드 실행 – 승인된 스레드는 자체 Git worktree/branch(또는 폴더)에서 시작되어 에이전트 CLI를 실행합니다. 필요에 따라 진행 상황을 보고하고 질문을 하며 PR을 엽니다.
5. 당신은 항상 흐름을 파악 – 사이드바는 "당신이 필요함"으로 표시된 스레드를 강조 표시합니다. Herdr에서 직접 답변, 리뷰, PR 병합이 가능합니다.
6. 정리 – 스레드가 완료되면 플러그인이 worktree/branch를 제거합니다(미커밋 변경 사항이 있는 경우 제외)하고 보고서를 아카이브합니다.

시작하기 (빠른 3단계 체크리스트)

단계	명령어	기능
1️⃣ 설치	herdr plugin install eliasstravik/herdr-projects herdr-projects configure	바이너리를 다운로드하고 사이드바 행 및 팝업 단축키를 등록합니다.
2️⃣ 생성	herdr-projects new "MyProject" --repo ~/dev/myrepo herdr-projects open myproject	프로젝트 디렉터리를 설정하고 코디네이터 에이전트를 시작합니다.
3️⃣ 설명	코디네이터 패널에 고수준 설명을 입력하고 제안된 스레드를 확인합니다.	코디네이터가 병렬 에이전트를 생성하고, 사이드바에서 상태를 모니터링합니다.

데이터 저장 위치

• 프로젝트 폴더: ~/.herdr-projects/<name>/ (내용: PROJECT.md, AGENTS.md, MEMORY.md, TASKS.md, threads/, library/ 등).
• 구성 및 보안 설정: ~/.config/herdr-projects/config.toml (프로젝트 외부, 에이전트가 수정하지 않음).

업데이트 방법

• herdr-projects update를 실행합니다(또는 --check로 버전만 확인). 명령어는 최신 바이너리를 다운로드하고 doctor --fix를 실행한 후, 프로젝트를 유지하는 백그라운드 타이머를 재시작합니다.

보안 및 권한

• 코디네이터는 herdr-projects 바이너리를 실행합니다. 서브커맨드 단위로 허용 목록을 설정해야 합니다. 일반적으로 허용되는 작업: skill, context, report, thread list, thread prompt 등. 더 제한적인 작업(예: thread resolve, sweep)은 일반 에이전트 권한 프롬프트 뒤에 실행됩니다.
• 플러그인은 자체적으로 코드를 푸시하거나 머지하지 않습니다. 머지 작업은 스레드가 명시적으로 "PR 병합" 명령을 실행할 때만 발생합니다.

누가 사용해야 할까요

• 터미널에 익숙하고 이미 Herdr를 AI 지원 코딩에 사용하는 개발자.
• 대규모 기능을 여러 개의 독립된 AI 기반 하위 작업으로 분할하면서도 단일 인터페이스를 유지하고 싶은 팀.
• 호스팅된 프로젝트 관리 서비스 없이 완전히 로컬이고 무료인 솔루션을 원하는 사람.

라이선스

• MIT 라이선스 – 플러그인을 자유롭게 사용, 수정, 재배포할 수 있습니다.

---

위의 모든 세부 정보는 리포지토리의 README에서 직접 가져왔으며, 추가 기능은 추측되지 않았습니다.