claudekit / tools / herdr
[ Tool · Claude Code Utilities ]

Herdr

Rust로 작성된 단일 바이너리의 터미널 네이티브 에이전트 멀티플렉서. tmux식 세션 유지와 패널 분할에 에이전트 상태 추적(idle, working, blocked, done)을 더해, Claude Code를 포함한 여러 CLI 에이전트를 한 화면에서 관리합니다. Herdr는 Claude Code를 자동 감지해 직접 통합(direct integration) 설치 프롬프트를 띄우고, 승인하면 풀 상태 감지, 로컬 소켓 API를 통한 시맨틱 상태 전달, 재시작 후 에이전트 세션 복원이 동작합니다.

ogulcancelik/herdr ·updated
$ curl -fsSL https://herdr.dev/install.sh | sh copy

Anthropic 공식 아님. ogulcancelik이 만든 커뮤니티 오픈소스 프로젝트(ogulcancelik/herdr).

왜 필요한가?

tmux는 터미널 세션을 유지하고 패널을 나누는 사실상의 표준이지만, 어떤 패널의 에이전트가 “작업 중”인지 “차단됐는지”는 알지 못합니다. 그래서 여러 에이전트를 동시에 돌리면 매번 패널을 직접 돌아가며 확인해야 합니다. 반대로 GUI 멀티 에이전트 매니저는 터미널 밖으로 나가야 해서 워크플로가 끊깁니다.

Herdr는 그 사이를 메우는 도구입니다. tmux식 세션 유지와 패널 분할은 그대로 두고, 각 에이전트의 상태(idle, working, blocked, done)를 사이드바에 시각적으로 표시합니다. 외부 의존성이 없는 단일 Rust 바이너리입니다.

주요 기능

  • 에이전트 상태 추적

    사이드바에서 각 패널의 에이전트가 작업 중(working), 차단됨(blocked), 완료(done), 유휴(idle) 중 어디인지 한눈에 보여줍니다. Claude Code, Codex, Cursor Agent, OpenCode, Hermes, QoderCLI 등 다양한 CLI 에이전트를 자동 감지합니다.

  • 세션 영속성과 클라이언트 재첨부

    세션이 클라이언트 종료 후에도 살아 있어 detach와 reattach를 반복해도 작업이 끊기지 않습니다. SSH를 통한 원격 attach도 지원합니다.

  • 워크스페이스, 탭, 패널

    프로젝트별 워크스페이스, 그 안의 탭, 패널 분할까지 다층 조직을 지원합니다. ctrl+b 프리픽스 + shift+n(새 워크스페이스), v/minus(패널 분할), c(새 탭), w(워크스페이스 전환) 같은 단축키로 조작합니다.

  • 마우스 네이티브와 실제 터미널 뷰

    클릭, 드래그, 분할이 마우스로 가능합니다. 각 패널은 해석된 표현이 아니라 실제 터미널을 그대로 표시해 ANSI나 TUI 출력이 정확히 렌더링됩니다.

  • 에이전트 소켓 API와 SKILL.md

    로컬 Unix 소켓 API로 에이전트가 워크스페이스 생성, 패널 분할, 헬퍼 spawn, 출력 읽기, 상태 변화 대기 같은 동작을 수행할 수 있습니다. README는 SKILL.md를 재사용 가능한 에이전트 스킬 패턴으로 언급합니다.

Claude Code 연동

Herdr를 실행하면 Claude Code 프로세스를 자동 감지해 직접 통합(direct integration) 설치 승인 프롬프트를 띄웁니다. 승인하면 통합이 자동으로 설치됩니다. 직접 명령으로 설치하고 싶다면 다음을 실행합니다.

herdr integration install claude

직접 통합을 설치하면 다음이 동작합니다.

  • 풀 상태 감지 — idle, done, working, blocked 모두 인식 (자동 감지만으로는 일부 상태만 인식)
  • 로컬 소켓 API를 통한 시맨틱 상태 전달 — Claude Code가 자기 상태를 Herdr에 능동적으로 보고
  • 재시작 후 에이전트 세션 복원 — [session] resume_agents_on_restore = true 설정 시 서버 재시작이나 업데이트 후에도 에이전트 세션이 자동 복원

사용 방법

  1. 설치합니다 — 설치 스크립트(curl), brew install herdr, 또는 GitHub Releases의 바이너리 중 하나를 사용합니다.
  2. 프로젝트 디렉터리에서 herdr를 실행합니다.
  3. 첫 실행 시 Herdr가 Claude Code를 감지해 띄우는 설치 승인 프롬프트를 승인합니다(또는 herdr integration install claude로 수동 설치).
  4. ctrl+b 프리픽스로 워크스페이스, 탭, 패널을 만들고, 각 패널에서 Claude Code나 다른 에이전트를 띄웁니다.
  5. 사이드바에서 어떤 에이전트가 blocked 상태로 사용자 입력을 기다리는지 확인합니다.

알아두면 좋은 점

  • Anthropic 공식 아님 — ogulcancelik/herdr 커뮤니티 프로젝트.
  • AGPL-3.0 + 상용 듀얼 라이선스 — 자유로운 사용, 수정, 재배포가 가능하나 AGPL 의무를 준수해야 합니다. AGPL 준수가 어려운 조직은 별도 상용 라이선스([email protected])를 문의할 수 있습니다.
  • macOS와 Linux 지원 — Windows 바이너리는 릴리스 페이지에 명시되어 있지 않습니다.
  • 다중 에이전트 도구 — Claude Code 전용이 아니라 Codex, Cursor Agent, OpenCode, Hermes, QoderCLI 등도 함께 다룹니다. Claude Code만 쓸 때도 의미가 있지만, 여러 에이전트를 병행할수록 가치가 커집니다.
  • Claude Code의 claude agents와 차이 — claude agents는 Claude Code 안에서 백그라운드 세션을 관리합니다. Herdr는 터미널 멀티플렉서 레벨에서 Claude Code를 포함한 여러 도구를 한 화면에 통합하며, 시각적 상태 표시를 제공합니다.
§ 6

See also

same category · curated
[01]
[Tool] CC Workflow Studio · 캔버스 위에서 AI 에이전트 워크플로를 시각적으로 설계해, Claude Code·Cursor·Copilot 등 에이전트가 바로 실행할 수 있는 Markdown(skills·commands·agents)으로 내보내는 VS Code 익스텐션. MCP 서버가 내장돼 'Edit with AI'로 자연어 수정도 가능.
tool · claudekit.io / tools / cc-wf-studio
[02]
[Skill] Find Skills · 사용자가 "X 하는 방법 알려줘" 같은 질문을 하면 자동 활성화되어, 오픈 에이전트 스킬 생태계에서 적합한 스킬을 검색·설치하도록 안내하는 메타 스킬.
tool · claudekit.io / tools / find-skills
[03]
[Plugin] Caveman · LLM 출력을 짧고 단편적인 영어로 압축해 출력 토큰을 65~75% 줄이는 Claude Code 플러그인. 같은 정보, 더 적은 토큰, 더 긴 세션.
tool · claudekit.io / tools / caveman
§ 7

자주 묻는 질문

자주 묻는 질문
§ 7.1
Herdr은 무엇인가요?
Rust 단일 바이너리로 동작하는 터미널 네이티브 에이전트 멀티플렉서입니다. tmux의 세션 유지와 패널 분할에 에이전트 상태 추적(idle, working, blocked, done)을 더해, Claude Code 등 여러 CLI 에이전트를 한 화면에서 관리합니다.
§ 7.2
Claude Code와 어떻게 연동하나요?
Herdr를 실행하면 Claude Code를 자동 감지해 설치 승인 프롬프트를 띄우고, 승인하면 직접 통합(direct integration)이 자동 설치됩니다(또는 `herdr integration install claude`로 직접 설치). 설치 후 풀 상태 감지(idle/done/working/blocked), 로컬 소켓 API를 통한 시맨틱 상태 전달, 재시작 후 에이전트 세션 복원이 동작합니다.
§ 7.3
tmux와는 무엇이 다른가요?
tmux의 세션 유지와 패널 분할은 그대로 갖되, 각 패널의 에이전트가 어떤 상태인지(작업 중, 차단됨, 완료, 유휴) 사이드바로 보여줍니다. 마우스 네이티브 인터페이스로 클릭, 드래그, 분할이 가능한 점도 차이입니다.
§ 7.4
어떤 환경에서 동작하나요?
macOS와 Linux 터미널에서 동작합니다. SSH를 통한 원격 attach를 지원하며, Claude Code, OpenAI Codex, Cursor Agent, OpenCode, Hermes, QoderCLI 등 다양한 CLI 에이전트를 자동 감지합니다.
§ 7.5
무료로 사용할 수 있나요?
AGPL-3.0-or-later 오픈소스로 무료입니다. AGPL 의무를 준수해야 하며, 준수가 어려운 조직은 별도 상용 라이선스를 [email protected]로 문의할 수 있습니다.
§ 7.6
Claude Code의 `claude agents`와 무엇이 다른가요?
`claude agents`는 Claude Code 안에서 백그라운드 세션을 관리합니다. Herdr는 터미널 멀티플렉서 레벨에서 Claude Code를 포함한 여러 CLI 에이전트(Codex, Cursor Agent 등)를 한 화면에 통합하며 시각적 상태 표시를 더합니다.