Herdr

여러 코딩 에이전트의 터미널·상태·세션을 한곳에서 유지하는 Rust 멀티플렉서

curl -fsSL https://herdr.dev/install.sh | sh

여러 코딩 에이전트를 실제 터미널 pane에서 실행하고 workspace·tab·상태를 한 화면에 모으는 Rust 기반 멀티플렉서입니다. 클라이언트를 닫아도 백그라운드 서버의 셸·테스트·에이전트가 계속 실행되며, Claude Code·Codex·Kimi Code·OpenCode 등은 세션 식별과 상태 통합을 추가로 지원합니다. 로컬 소켓 API와 플러그인으로 스크립트나 다른 에이전트가 pane을 제어할 수도 있습니다.

판단

이럴 때 씁니다

  • 여러 프로젝트의 Claude Code·Codex·OpenCode 세션을 동시에 띄우고 막힌 에이전트만 찾아가야 할 때
  • SSH 연결이나 로컬 터미널을 닫은 뒤에도 셸·테스트·에이전트 프로세스를 계속 실행해야 할 때
  • 다른 스크립트나 에이전트가 로컬 API로 pane에 프롬프트를 보내고 상태를 기다려야 할 때

이럴 땐 쓰지 마세요

  • 동시에 돌릴 프로세스가 하나뿐이고 일반 터미널이나 tmux만으로 충분할 때
  • 서버 재시작 뒤에도 모든 임의 프로세스를 자동 복원해야 할 때 — Herdr의 cold restart는 layout 복원과 지원 에이전트의 native resume까지만 보장합니다.
  • 터미널 화면 기록이나 에이전트 세션 메타데이터를 로컬 디스크에 남길 수 없는 환경

차별점

  • 터미널 클라이언트를 분리해도 백그라운드 서버의 pane·셸·에이전트 프로세스가 그대로 실행됩니다.
  • Claude Code·Codex·OpenCode·Kimi Code 등 지원 에이전트의 working·blocked·done·idle 상태와 세션 식별자를 sidebar에 모읍니다.
  • 마우스로 pane 분할·크기 조절·workspace 이동을 처리하면서 tmux와 비슷한 ctrl+b prefix 키도 제공합니다.
  • 로컬 소켓 API, 플러그인, direct agent attach를 제공해 스크립트와 다른 에이전트가 터미널을 제어할 수 있습니다.

워크플로

  1. 01공식 설치 스크립트를 실행하고 herdr --version으로 v0.7.5를 확인합니다.
  2. 02프로젝트 디렉터리에서 herdr를 열고 workspace·tab·pane을 만든 뒤 각 pane에서 claude, codex 같은 에이전트를 실행합니다.
  3. 03herdr integration status로 상태·세션 통합을 확인하고 필요한 에이전트 통합만 설치합니다.
  4. 04ctrl+b q로 분리한 뒤 herdr로 다시 붙습니다. 세션을 끝내야 할 때만 herdr server stop을 실행합니다.

주요 명령

명령설명
herdr현재 디렉터리에서 기본 백그라운드 세션을 시작하거나 기존 세션에 다시 붙습니다.
herdr integration status에이전트별 상태·세션 통합 설치 버전을 확인합니다.
herdr agent attach reviewer전체 UI 대신 이름이 reviewer인 에이전트 터미널에 직접 붙습니다.
herdr server stop현재 세션과 그 안의 pane 프로세스를 실제로 종료합니다.
herdr update설치 채널에 맞춰 새 릴리스를 확인하고 업데이트합니다.

함정

설치 전에 확인하세요

  • detach와 서버 재시작은 다릅니다. ctrl+b q로 분리하면 프로세스가 계속 돌지만 서버가 완전히 멈추면 원래 셸·테스트·서버는 사라지고 layout만 기본 복원됩니다.
  • pane 화면 기록은 토큰·프롬프트·명령 출력 같은 비밀값을 담을 수 있어 기본으로 꺼져 있습니다. 복원 편의를 위해 켤 때 저장 범위를 먼저 검토해야 합니다.
  • 에이전트마다 상태 신호의 정확도가 다릅니다. 통합이나 lifecycle hook이 없는 도구는 화면 패턴만 감지하거나 일반 터미널로만 보일 수 있습니다.
  • v0.7.5부터 설치·링크한 플러그인과 활성 상태가 세션별이 아니라 사용자 전역입니다. 이전 세션 전용 플러그인은 다시 설치하거나 링크해야 합니다.

비교

tmux가 범용 터미널 프로세스를 유지한다면 Herdr는 코딩 에이전트 감지·상태·세션 복구를 sidebar와 API에 더합니다. Ruflo 같은 작업 오케스트레이터가 에이전트 역할과 태스크 흐름을 조직하는 층이라면, Herdr는 각 에이전트가 실제로 실행되는 터미널과 프로세스를 보존하는 층입니다.

최근 변경

v0.8.2에서는 pipe가 닫힐 때 CLI가 조용히 종료되도록 하고 terminal wake 중복 작업을 줄였으며, 커서 아래 active terminal row의 가시성과 0.8.x 안정 릴리스 문서를 보강했습니다.

공식 변경 내역