Herdr 완전 정리: 코딩 에이전트를 한 터미널에서 돌리는 오픈소스 런타임 (2026)

작성일자 글쓴이

AI 코딩 에이전트를 3개, 5개씩 동시에 돌리는 개발자가 늘고 있습니다. 한 터미널에서는 리팩터링을, 다른 터미널에서는 테스트 작성과 버그 수정이 동시에 돌아가는 식이죠. 그런데 정작 힘든 건 코드가 아니라 관리입니다. 어느 에이전트가 내 대답을 기다리며 막혀 있는지, 어느 터미널 창을 열어야 하는지 계속 확인해야 하니까요.

Herdr는 이 문제를 정면으로 겨냥한 오픈소스 도구입니다. 코딩 에이전트가 “사는 곳”이 되어 주는 터미널 런타임이죠. tmux처럼 세션을 유지하면서, 에이전트의 상태까지 실시간으로 보여줍니다.

Herdr란 무엇인가

Herdr 터미널 런타임 — 에이전트 상태 사이드바와 멀티 창 구성 개념도

Herdr는 한 문장으로 “코딩 에이전트가 살아가는 런타임”입니다. 노트북이든 데스크톱이든 빌린 서버든, 에이전트가 실제 터미널에서 계속 돌도록 붙잡아 주는 배경 서버 역할을 합니다.

  • 약 10MB짜리 Rust 단일 바이너리 — Electron도, 클라우드 계정도 없음
  • 배경에서 서버가 터미널을 유지하므로 노트북을 닫아도, 네트워크가 끊겨도 에이전트는 계속 작업
  • 재부팅 후에도 레이아웃과 세션을 복원하고, 키보드가 있는 어떤 기기에서든 다시 접속 가능
  • 2026년 3월 첫 릴리스(v0.1.0) 후 약 4개월 만에 GitHub 스타 약 2만 6천 개를 기록, GitHub 트렌딩 1위에도 올랐음

Herdr 공식 사이트 바로가기

핵심 기능 4가지

1. 항상 실행 — 닫아도 사라지지 않는 세션

Herdr는 계속 열어 두는 앱이 아닙니다. 터미널이 서버 안에서 살아가는 구조라서, 노트북 덮개를 닫거나 SSH가 끊겨도 에이전트는 그대로 일합니다. ctrl+b q로 분리(detach)했다가 herdr 한 줄로 다시 붙으면 끝입니다.

2. 막힌 에이전트를 찾아 헤매지 않아도 됨

Herdr는 모든 창(pane)을 읽어 에이전트마다 상태를 표시합니다. 사이드바에 working(작업 중) / blocked(입력 대기) / done(완료) / idle(대기)이 표시되니, 대답을 기다리는 에이전트를 창마다 뒤질 필요가 없습니다. 별도 설정 없이 프로세스 감지와 터미널 출력 분석만으로 동작합니다.

3. 에이전트 네이티브 — 에이전트가 에이전트를 부림

CLI와 소켓 API는 에이전트가 직접 조작하도록 설계된 동일한 인터페이스입니다. 에이전트가 창을 분할하고, 다른 에이전트를 띄우고, 서로 프롬프트를 보내며, 상대가 진짜 막힐 때까지 기다리는 오케스트레이션이 가능합니다.

4. 이미 쓰는 에이전트를 그대로

Claude Code, Codex, Cursor, opencode, Grok, Copilot 등 19종 이상의 에이전트를 기본적으로 자동 감지합니다. 기존 도구를 감싸거나 대체하는 게 아니라 터미널만 소유하는 방식이라, 쓰던 CLI가 그대로 동작합니다.

GitHub 저장소 바로가기

한눈에 보는 구조

계층 역할
서버 배경에서 PTY 세션을 유지. 분리·재접속·재부팅 복원의 주체
워크스페이스 보통 리포지토리 1개 = 워크스페이스 1개
탭 / 창(pane) 탭으로 그룹화, 창마다 실제 터미널(PTY)에서 에이전트 실행
소켓 API 유닉스 소켓 JSON API. CLI의 모든 명령이 이 API와 1:1 대응

터미널 렌더링에는 Ghostty의 VT 엔진을 내장해, 에이전트의 전체화면 TUI도 깨짐 없이 그대로 표시됩니다.

tmux와 무엇이 다른가

구분 Herdr tmux / Zellij GUI·클라우드 도구
에이전트 상태 사이드바 기본 내장 없음(직접 확인) 제각각
에이전트별 실제 PTY 지원 지원 에뮬레이션인 경우 많음
스크립트/소켓 API 전체 지원 제한적 제각각
동작 방식 터미널 안, 로컬 터미널 안, 로컬 GUI 앱 또는 클라우드

요약하면 tmux급 세션 지속성 + 에이전트 상태 감지 + 스크립트 가능한 소켓 API를, 이미 쓰는 터미널을 떠나지 않고 얻는 것이 Herdr의 차별점입니다.

설치와 시작

설치는 한 줄이면 됩니다.

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

# Homebrew
brew install herdr

# Windows(베타)
powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"

그 다음, 작업 폴더에서 실행합니다.

herdr          # 시작 또는 재접속
herdr --session work      # 이름 붙인 세션
herdr --remote mybox      # 원격 서버에 붙기(SSH)

플랫폼은 macOS와 Linux가 안정 지원이며 Windows는 베타 단계입니다. 라이선스는 v0.8.0부터 AGPL에서 Apache-2.0으로 전환되어 기업에서도 부담 없이 쓸 수 있습니다.

공식 문서(Quick Start) 바로가기

플러그인과 자동화 확장

Herdr는 플러그인 시스템도 갖췄습니다. herdr-plugin.toml 하나로 액션, 이벤트 훅, 오버레이 창을 등록할 수 있고, 커뮤니티 마켓플레이스에서 워크플로우 확장 플러그인을 받아 쓸 수 있습니다.

스크립트 자동화도 강력합니다. 창을 분할하고 명령을 실행한 뒤 특정 출력이 나올 때까지 기다리는 일련의 동작을 CLI 한 줄씩 조합하면 됩니다.

# 오른쪽에 새 창 분할 → 개발 서버 실행 → 포트 준비 대기
NEW_PANE=$(herdr pane split 1-2 --direction right --no-focus | \
  python3 -c 'import sys,json; print(json.load(sys.stdin)["result"]["pane"]["pane_id"])')
herdr pane run "$NEW_PANE" "npm run dev"
herdr wait output "$NEW_PANE" --match "ready on port 3000" --timeout 30000

이 조합 덕분에 에이전트가 직접 Herdr를 운전할 수 있습니다. 공식 에이전트 스킬을 설치하면 에이전트가 스스로 창을 띄우고, 형제 에이전트의 작업이 끝나길 기다렸다가 다음 단계로 넘어가는 파이프라인을 구성합니다.

어떤 사람에게 어울리나

  • 에이전트를 2개 이상 병렬로 돌리는 개발자 — 상태 사이드바 하나만으로도 전환 비용이 크게 줄어듭니다
  • VPS·원격 서버에서 에이전트를 돌리는 사람 — SSH로 붙고 떨어지기를 반복해도 세션이 살아 있고, 휴대폰에서도 재접속할 수 있습니다
  • tmux 사용자 — 기존 단축키 습관을 유지하면서 에이전트 상태 감지라는 새 기능을 얻습니다
  • 보안에 민감한 팀 — 세션이 로컬 파일로만 저장되고 클라우드 호출이 없어 코드 유출 경로가 늘어나지 않습니다

다만 주의할 점도 있습니다. 1.0 이전 버전이라 릴리스 주기가 빠르고 프로토콜 변경이 있을 수 있으며, 주 관리자가 1명인 프로젝트라는 점은 장기 유지보수 관점에서 알고 쓰는 것이 좋습니다.

버전 변화와 성숙도

버전 시점 주요 변화
v0.1.0 2026-03 첫 릴리스
v0.2.0 2026-03 유닉스 소켓 API + CLI 래퍼
v0.5.0 2026-04 지속형 서버/클라이언트 모델 도입
v0.7.0 2026-06 플러그인 v1, 공개 ID 체계
v0.8.0 2026-08 Apache-2.0 라이선스 전환, Windows 지원 강화, UI 옵션 추가

약 4개월 만에 초기 프로토타입에서 플러그인 생태계까지 갖춘 셈입니다. GitHub 트렌딩 1위 기록과 2만 6천 스타는 멀티 에이전트 관리라는 문제 자체가 개발자들의 실제 통증이었음을 보여줍니다.

실무 도입 체크리스트

  • ☐ 자주 쓰는 에이전트 CLI가 Herdr 창에서 정상 감지되는지 확인
  • ☐ herdr integration install claude 등으로 주요 에이전트 정밀 상태 리포팅 설치
  • ☐ 리포지토리별 워크스페이스 분리, Git 브랜치는 worktree로 매핑
  • ☐ 노트북 절전·SSH 끊김 후 재접속 테스트로 세션 지속 검증
  • ☐ 원격 서버(VPS)에서 herdr --remote 접속 흐름 확인
  • ☐ 필요 시 플러그인 마켓플레이스에서 워크플로우 확장 검토

FAQ

Q. 기존 에이전트를 Herdr용으로 다시 설정해야 하나요?

아닙니다. Herdr는 에이전트를 감싸거나 교체하지 않고 터미널만 소유합니다. 평소처럼 에이전트 CLI를 띄우면 자동으로 감지됩니다.

Q. 내 코드가 외부로 전송되나요?

Herdr 자체는 클라우드 호출이 없는 로컬 도구입니다. 세션은 ~/.config/herdr/ 아래의 로컬 파일로 저장됩니다. 다만 각 에이전트가 모델 제공자로 코드를 보내는 것은 에이전트 자체의 동작이니 그 부분은 별도 확인이 필요합니다.

Q. tmux를 이미 쓰고 있는데 갈아탈 이유가 있나요?

에이전트를 여러 개 돌린다면 이유가 충분합니다. “누가 막혔는지”를 tmux에서는 눈으로 찾아야 하지만, Herdr는 사이드바가 알려줍니다. tmux 스타일 단축키도 그대로 지원해 전환 비용이 낮습니다.

Q. Windows에서도 쓸 수 있나요?

베타 단계로 동작은 하지만 가끔 거친 부분이 있을 수 있습니다. Linux·macOS가 주력 플랫폼입니다.

결론

멀티 에이전트 개발의 병목은 이제 모델 성능이 아니라 사람의 주의력입니다. Herdr는 에이전트에게 “사는 곳”을 줘서 세션을 살려 두고, 상태판으로 누가 막혔는지를 알려주며, 소켓 API로 에이전트끼리 협업하게 만듭니다. 약 10MB 바이너리 하나로 이 모든 것을 로컬에서 얻는 셈이죠. 에이전트를 2개 이상 동시에 돌리고 있다면, 설치 한 줄로 직접 체감해 보시길 권합니다.

함께 읽으면 좋은 글