Herdr 플러그인 'herdr-projects': 단일 코디네이터 기반 병렬 브랜치 에이전트 오케스트레이션

단일 코디네이터 에이전트와 대화하여 작업별 Git 브랜치에서 병렬 스레드를 구동하고, Herdr 사이드바 실시간 진행률 표시와 머지 후 자동 리소스 정리를 지원하는 herdr-projects 플러그인을 소개합니다.

tau · 2026년 9월 24일

#herdr #ai-agents #orchestration #developer-tools #git

Herdr 플러그인 'herdr-projects': 단일 코디네이터 기반 병렬 브랜치 에이전트 오케스트레이션

개발자 Elias Stråvik(@eliasstravik)이 멀티에이전트 터미널 하네스 Herdr를 위한 신규 오케스트레이션 플러그인인 'herdr-projects'를 공개했습니다. 출시 48시간 만에 Herdr 생태계 전체 플러그인 올타임 상위 15위에 진입한 이 도구는 작업자가 단일 코디네이터 에이전트와의 대화만으로 복수의 독립된 Git 브랜치를 생성하고 병렬 작업을 분배할 수 있도록 지원합니다.

Herdr 사이드바에서 실시간 진행률과 함께 표시되는 herdr-projects 멀티에이전트 병렬 브랜치 실행 화면

이미지 출처: Elias Stråvik (@eliasstravik)

Herdr 환경에서 복수의 코딩 에이전트를 동시에 운용할 때 필연적으로 발생하던 수동 브랜치 관리와 세션 전환 비용을 자동화된 워크플로우로 흡수하는 것이 핵심 목적입니다.

단일 코디네이터와 독립 브랜치 기반 병렬 실행 구조

기존의 Herdr 환경은 Claude Code, Codex, OpenCode 등 다양한 CLI 기반 AI 에이전트를 분할 창(Split Panes)과 탭으로 나란히 구동하는 저수준 터미널 프리미티브(agent.send, agent.read, agent.list)를 제공해 왔습니다. 하지만 여러 에이전트에게 서로 다른 구현 과제를 맡길 경우, 사용자가 각 PTY 창을 직접 넘나들며 상태를 복사해 전달하거나 수동으로 Git 브랜치를 분기해야 하는 운영상 번거로움이 있었습니다.

herdr-projects는 이러한 분절을 해소하기 위해 '코디네이터 에이전트(Coordinator Agent)' 패턴을 도입했습니다.

  • 단일 접점 인터페이스: 사용자는 중앙 코디네이터 에이전트 한 곳에만 작업을 지시합니다. 코디네이터가 하위 작업을 분해하고 필요한 에이전트를 호출합니다.
  • 브랜치 격리형 병렬 스레드: 각 하위 작업은 저장소 내에서 독립된 Git 브랜치로 자동 분기되어 별도의 병렬 스레드에서 실행됩니다. 서로 다른 에이전트의 파일 수정이 작업 중 충돌하지 않도록 파일 시스템 수준에서 안전하게 격리됩니다.
  • 자유로운 에이전트 조합: 사용자가 지정한 임의의 AI 에이전트를 개별 스레드의 작업자로 배정할 수 있어, 리팩토링이나 테스트 작성 등 작업 성격에 맞춘 에이전트 배치가 가능합니다.

실시간 모니터링과 자동 라이프사이클 관리: prefix+a 및 자동 정리

병렬 에이전트가 늘어날수록 각 세션의 진행 상황을 한눈에 파악하고 완료된 브랜치를 수습하는 일이 핵심 과제로 떠오릅니다. herdr-projects는 Herdr의 터미널 UI 특성을 활용해 시각적 가시성과 리소스 정리 기능을 내장했습니다.

  • 사이드바 실시간 진행률 표시: Herdr 사이드바에 각 병렬 스레드의 작업 완료율이 백분율(%) 지표로 실시간 갱신되어 터미널 전체 화면을 전환하지 않고도 전체 작업 흐름을 파악할 수 있습니다.
  • prefix+a 통합 팝업 조회: 터미널 단축키 prefix+a를 입력하면 활성화된 모든 프로젝트와 에이전트 스레드 목록을 단일 팝업 오버레이로 즉시 호출하여 전환할 수 있습니다.
  • 머지 후 자동 리소스 정리: 각 브랜치에서 에이전트의 작업이 완료되고 브랜치가 메인 작업선으로 머지되면, 플러그인이 해당 스레드와 임시 리소스를 자동으로 정리하여 불필요한 PTY 프로세스와 댕글링 브랜치가 방치되는 것을 방지합니다.

설치 방법 및 프로젝트 적용 시 고려사항

herdr-projects는 Herdr의 표준 플러그인 관리 명령어를 통해 한 줄로 설치할 수 있습니다.

herdr plugin install eliasstravik/herdr-projects

실무 도입 시 염두에 두어야 할 기술적 전제 조건과 제약 사항은 다음과 같습니다.

  • Herdr 런타임 종속성: 본 도구는 독립 실행형 CLI가 아니며, 로컬 환경에 Herdr 멀티에이전트 런타임이 사전 설치되어 설정되어 있어야 플러그인으로 정상 등록됩니다.
  • 단일 저장소 범위 동작: 현재 버전의 브랜치 오케스트레이션은 단일 Git 저장소(Single Repository) 내부 분기에 최적화되어 있습니다. 마이크로서비스나 서브모듈 등 복수 저장소에 걸친 교차 오케스트레이션(Cross-repo support)은 현재 네이티브로 지원되지 않으며 커뮤니티 피드백을 통해 향후 과제로 제기되고 있습니다.

단일 저장소 내에서 여러 기능 구현이나 테스트 작성을 병렬로 위임하고자 하는 Herdr 사용자에게 작업 분할과 브랜치 정리의 수고를 덜어주는 실용적인 도구입니다.

출처