herdr: Terminal Agent Multiplexer for Coding Agents — 12K+ Stars
herdr is a Rust-based terminal multiplexer for AI coding agents. Run Claude Code, Codex, Cline, and OpenCode in parallel — each with its own real terminal, workspace tabs, and state tracking. tmux rebuilt for agents.
- NOASSERTION
- 업데이트 2026-07-07
{{< 리소스 정보 >}}
AI 코딩 에이전트는 Claude Code, Codex CLI, Cline, OpenCode, Aider, Devin 등 빠르게 증가하고 있으며 이들을 동시에 관리하는 것은 악몽입니다. 각 에이전트는 자체 터미널, 작업 공간, 프로세스 트리를 원합니다. 둘 사이를 전환한다는 것은 복잡한 터미널 창을 통해 Alt 키를 누른 채 작동하는 에이전트, 차단된 에이전트, 충돌한 에이전트를 추적할 수 없음을 의미합니다.
herdr은 AI 에이전트용으로 특별히 제작된 터미널 멀티플렉서로 이 문제를 해결합니다. tmux를 생각하면 쉘을 관리하는 대신 에이전트를 관리합니다. 각 에이전트는 고유한 실제 터미널(앱의 모방이 아님)을 가지므로 상태를 한 눈에 확인하고 작업 공간과 탭으로 정리할 수 있으며 어디에서나 다시 연결할 수 있습니다. 심지어 SSH를 통한 휴대폰도 가능합니다.
herdr이 무엇인가요? #
herdr(“heer-der"로 발음)은 AI 코딩 에이전트를 위한 Rust 기반 터미널 멀티플렉서입니다. Ogul Cancelik이 개발한 이 솔루션은 여러 코딩 에이전트를 동시에 실행, 모니터링 및 관리할 수 있는 단일 터미널 인터페이스를 제공합니다.
핵심 철학: 에이전트는 샌드박스 에뮬레이션이 아닌 실제 터미널에서 실행되어야 합니다. 에이전트가 전체 화면 TUI(예: htop 또는 lazygit)를 실행하려면 실제 PTY가 필요합니다. herdr은 tmux 세션의 각 에이전트를 내부적으로 래핑하여 이를 제공하지만 맨 위에 깔끔한 에이전트 중심 인터페이스를 제공합니다.
주요 기능 #
- 에이전트별 실제 터미널 — 각 에이전트는 전체 TUI 지원을 통해 자체 PTY에서 실행됩니다.
- 에이전트 상태 추적 — 사이드바에는 각 에이전트가 차단됨(빨간색), 작업 중(노란색), 완료(파란색) 또는 유휴(녹색)으로 표시됩니다.
- 작업공간 및 탭 — 프로젝트 폴더 또는 저장소별로 에이전트 구성
- 지속적인 세션 — 노트북을 닫고 SSH에서 분리해도 에이전트는 계속 실행됩니다. 모든 터미널에서 다시 연결
- 제로 원격 측정 — 단일 바이너리, 계정 없음, 클라우드 종속성 없음, 데이터 수집 없음
- 마우스 기반 UI — 키보드를 건드리지 않고도 창을 클릭하고 드래그하고 분할할 수 있습니다.
아키텍처 #
herdr은 단순하지만 강력한 아키텍처를 기반으로 구축되었습니다.
┌─────────────────────────────────────┐
│ herdr CLI (Rust) │
│ ┌──────────┬──────────┬─────────┐ │
│ │ Workspace│ Workspace│ Workspace│ │
│ │ Tab 1 │ Tab 2 │ Tab 3 │ │
│ │ │ │ │ │
│ │ ┌────┐ │ ┌────┐ │ ┌────┐ │ │
│ │ │AGT1│ │ │AGT2│ │ │AGT3│ │ │
│ │ └────┘ │ └────┘ │ └────┘ │ │
│ └──────────┴──────────┴─────────┘ │
└─────────────────────────────────────┘
│ │ │
┌────▼────┐ ┌────▼────┐ ┌────▼────┐
│ tmux #1 │ │ tmux #2 │ │ tmux #3 │
│ (PTY) │ │ (PTY) │ │ (PTY) │
└─────────┘ └─────────┘ └─────────┘
에이전트 서버 #
herdr은 터미널 세션 전반에 걸쳐 지속되는 백그라운드 서버 프로세스(herdr-server)를 실행합니다. 이 서버:
- 에이전트의 모든 tmux 세션을 관리합니다.
- 에이전트 상태 추적(차단됨/작업 중/완료/유휴)
- 새 터미널에서 재부착 처리
- 작업 공간 및 탭 구성 유지
노트북을 닫거나 SSH 연결이 끊어져도 서버는 계속 실행됩니다. 다시 연결하면 ‘herdr attachment’가 전체 작업 공간을 나간 그대로 복원합니다.
상태 감지 #
herdr은 터미널 출력 패턴을 모니터링하여 에이전트 상태를 감지합니다.
- 차단됨(빨간색) — 에이전트가 사용자 입력, 파일 편집 또는 승인을 기다리고 있습니다.
- 작업 중(노란색) — 에이전트가 적극적으로 명령을 실행하거나 코드를 작성하거나 추론하고 있습니다.
- 완료(파란색) — 에이전트가 작업을 완료하고 종료했습니다.
- 유휴(녹색) — 에이전트가 실행 중이지만 적극적으로 처리 중이 아닙니다.
이는 휴리스틱 기반(후크 필요 없음)이며 Claude Code, Codex CLI, Cline, OpenCode, Aider 등 터미널 출력을 생성하는 모든 에이전트와 함께 작동합니다.
설치 #
화물 설치 #
``배쉬 화물 설치 herdr
러스트 1.70 이상이 필요합니다. 이는 전체 기능 지원을 위해 권장되는 방법입니다.
### 사전 구축된 바이너리
``배쉬
# 리눅스(x86_64)
컬 -L https://github.com/ogulcancelik/herdr/releases/latest/download/herdr-x86_64-linux.tar.gz | 타르 xz
sudo mv herdr /usr/local/bin/
# 맥OS(애플 실리콘)
컬 -L https://github.com/ogulcancelik/herdr/releases/latest/download/herdr-aarch64-darwin.tar.gz | 타르 xz
sudo mv herdr /usr/local/bin/
도커 #
``배쉬
docker run -it –rm
-v ~/.herdr:/root/.herdr
-v /var/run/docker.sock:/var/run/docker.sock
ghcr.io/ogulcancelik/herdr:최신
### 전제 조건
- **tmux** 3.2+(herdr은 PTY 관리를 위해 내부적으로 tmux를 사용합니다)
- **Rust 1.70+**(화물 설치용)
- **SSH**(선택 사항, 원격 재연결용)
## 사용법
### 에이전트 시작
``배쉬
# 새 에이전트 창에서 Claude Code를 시작합니다.
herdr 실행 클로드 코드
# 특정 작업으로 Codex CLI를 시작합니다.
herdr run codex "JWT를 사용하도록 인증 모듈을 리팩터링"
# 여러 에이전트를 병렬로 시작
herdr은 클로드 코드를 실행하고 &
herdr 실행 코덱스 &
잠깐만요
작업공간 관리 #
``배쉬
프로젝트를 위한 새로운 작업공간을 생성합니다 #herdr 작업 공간 create my-project –dir ./my-project
작업공간에 에이전트 추가 #
herdr 작업 공간은 my-project를 사용합니다. herdr은 clude-code –workspace my-project를 실행합니다.
작업 공간 간 전환 #
herdr 작업공간 목록 herdr 작업 공간은 다른 프로젝트를 사용합니다.
### 에이전트 상태 모니터링
``배쉬
# 모든 에이전트와 해당 상태를 봅니다.
목동 상태
# 에이전트 상태를 실시간으로 감시
군중 감시
# 에이전트가 완료되면 알림 받기
herdr inform --on-done "echo Agent $AGENT 완료"
부착 및 분리 #
``배쉬
herdr 서버에 연결합니다(모든 에이전트 표시). #
무리를 연결하다
분리(Ctrl+B, D — tmux와 동일) #
에이전트가 계속 실행됩니다. #
다른 터미널이나 SSH 세션에서 다시 연결 #
SSH 사용자@서버 무리를 연결하다
휴대폰에서 다시 첨부 #
SSH 사용자@서버 -p 22 무리를 연결하다
### 분할 및 레이아웃
``배쉬
# 가로로 나누기
herdr 스플릿-h
# 세로로 나누기
herdr 분할-v
# 레이아웃 순환
herdr 레이아웃 다음
# 창 크기 조정
herdr 크기 조정 --up 5
지원되는 에이전트 #
herdr은 모든 CLI 기반 코딩 에이전트와 함께 작동합니다. 공식적으로 테스트된 항목:
| 에이전트 | 상태 | 메모 |
|---|---|---|
| 클로드 코드 | 완벽하게 지원됨 | 실시간 상태 감지 |
| 코덱스 CLI | 완벽하게 지원됨 | OpenAI의 코딩 에이전트 |
| 클라인(VS Code) | 지원됨 | CLI 모드를 통해 |
| 오픈코드 | 완벽하게 지원됨 | 상태 감지 작동 |
| 에이더 | 완벽하게 지원됨 | Git 인식 에이전트 |
| 데빈 CLI | 지원됨 | 자율 에이전트 모드 |
| 모든 tmux 호환 CLI | 작품 | 일반 에이전트 모드 |
사용자 정의 에이전트 구성 #
특정 상태 감지 패턴을 사용하여 사용자 정의 에이전트를 정의할 수 있습니다.
``yaml
~/.herdr/agents.yaml #
에이전트: 내-맞춤-에이전트: 명령: “my-agent –task $TASK” 상태_패턴: 차단됨: /입력 대기 중|수정해 주세요/ 작업 중: /실행 중|실행 중|분석 중/ 완료: /완료|완료|완료/ 작업 공간_기본값: “사용자 정의”
## 대안과의 비교
### herdr 대 tmux
| Feature | herdr | tmux |
|---------|-------|------|
| Agent state tracking | Automatic (color-coded) | Manual (window names) |
| Workspace organization | Built-in (by project) | Manual (sessions) |
| Mouse support | Native (click, drag) | Configurable |
| Agent-specific commands | `herdr run`, `herdr watch` | `tmux new-window`, etc. |
| Learning curve | Low (agent-first) | Moderate (terminal-first) |
| Reattachment | Seamless (server-based) | Session-based |
tmux는 보다 범용적인 도구입니다. herdr은 **에이전트용** tmux입니다. 이는 에이전트 중심 UI에서 tmux의 세션 관리를 래핑합니다. 에이전트 없이 터미널만 관리하는 경우 tmux로 충분합니다. 여러 코딩 에이전트를 동시에 관리하는 경우 herdr은 상당한 인지 오버헤드를 절약합니다.
### herdr 대 tmuxinator
| 기능 | 목자 | tmuxinator |
|---------|---------|------------|
| 상담원 상태 추적 | 실시간 색상 코드 | 없음 |
| 지속성 | 서버 프로세스 | 세션 기반 |
| 원격 재연결 | 어디서나 SSH를 통해 | 로컬 전용 |
| 다중 에이전트 워크플로 | 내장 | 매뉴얼 |
| 마우스 UI | 네이티브 | 한정 |
tmuxinator는 tmux용 세션 관리자입니다. 이는 미리 정의된 창과 창을 엽니다. herdr은 더 나아가 각 창 내에서 실행 중인 내용을 추적하고 에이전트 상태를 시각적으로 표시합니다.
### herdr 대 화면
| 기능 | 목자 | GNU 화면 |
|---------|---------|------------|
| 에이전트 인식 | 예 | 아니요 |
| 최신 UI | 러스트/TUI | 레거시 |
| 마우스 지원 | 네이티브 | 한정 |
| 커뮤니티 | 성장 | 성숙한 |
| 패키지 가용성 | 사전 구축된 바이너리 | 시스템 패키지 |
스크린은 터미널 멀티플렉서의 할아버지입니다. herdr은 AI 에이전트 시대에 맞게 재설계하면 얻을 수 있는 것입니다.
## 성능
herdr은 Rust로 작성되었으며 매우 가볍습니다.
- **바이너리 크기**: ~15MB(단일 정적 바이너리)
- **메모리 사용량**: 유휴 ~2MB, 에이전트 세션당 ~5MB
- **시작 시간**: < 50ms
- **CPU 사용량**: 유휴 상태에서는 거의 0에 가까우며 에이전트 활동에 따라 확장됩니다.
tmux 서버는 최소한의 오버헤드로 백그라운드 데몬으로 실행됩니다. 모든 상태 감지는 터미널 출력 분석을 통해 로컬로 이루어집니다. 네트워크 호출이나 클라우드 종속성이 없습니다.
## 제한사항
### GUI 없음
herdr은 터미널 전용입니다. 데스크톱 앱, 브라우저 UI, 모바일 앱이 없습니다(단, 서버에 SSH를 통해 연결하고 휴대폰 터미널에서 herdr을 사용할 수는 있음). 시각적 대시보드를 선호한다면 herdr의 TUI가 까다롭게 느껴질 수 있습니다.
### 휴리스틱 상태 감지
에이전트 상태 감지는 API 후크가 아닌 터미널 출력 패턴에 의존합니다. 이는 다음을 의미합니다.
- 모든 에이전트와 작동합니다(통합 필요 없음).
- 그러나 때때로 상태를 잘못 분류할 수 있습니다(예: 에이전트가 실제로 차단되었지만 "작업 중..."이라고 인쇄함).
- 극단적인 경우에 맞게 사용자 정의 패턴을 구성할 수 있습니다.
### 에이전트 호환성
herdr은 모든 CLI 에이전트와 함께 작동하지만 일부 에이전트에는 다음과 같은 단점이 있습니다.
- 터미널 화면을 지우는 에이전트는 상태 컨텍스트를 잃을 수 있습니다.
- 비표준 이스케이프 코드를 사용하는 에이전트는 올바르게 감지되지 않을 수 있습니다.
- 전체 화면 TUI 에이전트(예: `vim` 또는 `htop`)가 완벽하게 작동합니다. 이것이 실제로 herdr의 강점입니다.
### 내장 결제 없음
herdr은 API 비용이나 토큰 사용량을 추적하지 않습니다. 유료 API를 통해 에이전트를 관리하는 경우 비용 추적을 위한 별도의 도구가 필요합니다.
## 편집자의 의견
herdr은 AI 코딩 에이전트가 증가함에 따라 더 넓어진 격차를 메웁니다. 에이전트 이전에는 tmux만으로 충분했습니다. 지능형 프로세스가 아니라 터미널을 관리했습니다. 그러나 각 "터미널"이 생각하고, 코드를 작성하고, 때로는 사용자를 기다리다가 멈추는 자율 에이전트인 경우에는 창 관리 이상의 것이 필요합니다. **상담사 인식**이 필요합니다.
herdr의 천재성은 단순함입니다. IDE, 프로젝트 관리자 또는 CI/CD 파이프라인이 되려고 하지 않습니다. 에이전트의 상태, 작업 공간, 연결 끊김에도 지속되어야 하는 필요성 등을 이해하는 터미널 멀티플렉서입니다. Rust로 작성되었으며 실행 비용이 전혀 들지 않는다는 사실은 여러 코딩 에이전트를 다루는 사람에게는 당연한 일입니다.
색상으로 구분된 상태 사이드바만으로도 하루에 몇 분씩 절약됩니다. 더 이상 어떤 에이전트가 완료되었고 어떤 에이전트가 멈췄는지 궁금해하며 8개의 터미널 창을 통해 Alt 키를 누를 필요가 없습니다. herdr은 다음과 같이 말합니다: 빨간색 = 차단됨(행동해야 함), 노란색 = 작동 중(내버려두기), 파란색 = 완료(출력 확인), 녹색 = 유휴(생각 중).
저장소 전체에 걸쳐 여러 에이전트를 실행하는 팀의 경우 herdr의 작업 공간 구성은 매우 중요합니다. 프로젝트별로 작업공간을 만들고, 폴더별로 에이전트를 추가하고, 컨텍스트를 잃지 않고 프로젝트 간에 전환하세요. SSH를 통한 재연결 기능은 노트북이 절전 모드일 때에도 에이전트가 원격 서버에서 계속 실행된다는 것을 의미합니다.
herdr이 상업용 대안에 비해 부족한 한 가지는 시각적 대시보드입니다. 그러나 herdr의 청중인 터미널 사용자의 경우 TUI는 웹 기반 에이전트 관리자보다 더 빠르고, 가볍고, 더 안정적입니다.
## FAQ
### Q: herdr은 비코딩 에이전트와 함께 작동합니까?
답: 그렇습니다. 터미널 출력을 생성하는 모든 CLI 프로세스는 herdr에 의해 관리될 수 있습니다. 코딩 에이전트(Claude Code, Codex, Cline)에 최적화되어 있지만 웹 서버, 데이터 파이프라인, 모니터링 도구 등 장기 실행 터미널 프로세스를 관리하는 데 사용할 수 있습니다.
### Q: Windows에서 herdr을 사용할 수 있나요?
A: herdr에는 주로 Unix 도구인 tmux가 필요합니다. Windows에서는 WSL2(Linux용 Windows 하위 시스템)를 사용하여 herdr을 실행할 수 있습니다. 기본 Windows 지원이 계획되어 있지만 아직 제공되지 않습니다.
### Q: herdr은 에이전트 충돌을 어떻게 처리합니까?
A: 에이전트가 충돌하면 herdr은 이를 차단된 것으로 표시하고(빨간색) 터미널 세션을 활성 상태로 유지합니다. 충돌 출력을 검사하고, 문제를 해결하고, 컨텍스트 손실 없이 동일한 작업 영역에서 에이전트를 다시 시작할 수 있습니다.
### Q: herdr을 위한 웹 기반 대시보드가 있습니까?
답: 아직은 아닙니다. herdr은 설계상 터미널 우선입니다. 제작자는 웹 대시보드가 로드맵에 있다고 언급했지만 현재 TUI는 대상 고객에게 충분한 것으로 간주됩니다.
### Q: herdr이 원격 서버의 에이전트를 관리할 수 있나요?
답: 그렇습니다. herdr은 서버 프로세스를 사용하므로 원격 시스템에서 herdr-server를 실행하고 모든 터미널(전화기의 SSH 포함)에서 연결할 수 있습니다. 에이전트는 연결 상태에 관계없이 원격 서버에서 계속 실행됩니다.
### Q: herdr은 에이전트 간 통신을 지원합니까?
답: 직접적으로는 아닙니다. herdr은 에이전트를 병렬로 관리하지만 에이전트 간의 통신을 촉진하지는 않습니다. 에이전트가 데이터를 공유해야 하는 경우 공유 파일 시스템, 환경 변수 또는 메시지 대기열을 사용하세요.
## Dibi8의 작품 더보기
- [OmniRoute: 237개 공급자가 포함된 무료 AI 게이트웨이](/resources/ai-tools/omniroute-free-ai-gateway/)
- [Orca: StableAI의 병렬 에이전트 오케스트레이션](/resources/ai-tools/orca-parallel-agent-orchestrator/)
- [Chrome DevTools MCP: 코딩 에이전트를 위한 브라우저 자동화](/resources/ai-tools/chrome-devtools-mcp/)
## 소스
- [herdr GitHub 저장소](https://github.com/ogulcancelik/herdr)
- [herdr 문서](https://herdr.dev/docs/)
- [herdr 블로그](https://herdr.dev/blog/)
---
*게시일: 2026년 7월 7일 | 최종 업데이트 날짜: 2026년 7월 7일 | 별: 12,627 | 라이센스: NOASSERTION*
💬 댓글 토론