여럿을 띄워 두고, 손이 필요한 녀석만 돌봅니다.
AI 코딩 에이전트를 위한 터미널 작업 공간 관리자
에이전트는 빨라졌는데 병목은 "누가 날 기다리나"를 찾는 나입니다. herdr가 그걸 대신 봐 줍니다.
brew install herdr # 또는 curl -fsSL https://herdr.dev/install.sh | sh herdr integration install claude herdr
터미널 창·탭이 열 개. 어느 게 어느 프로젝트인지 하나씩 눌러 봐야 압니다.
"이 파일 고쳐도 될까요?" — 그 질문을 30분 뒤에 발견합니다. 그동안 에이전트는 멈춰 있었죠.
끝났나? 창을 열어 보고, 아직이면 닫고, 또 열고. 확인하느라 내 시간이 다 갑니다.
Rust로 만든 실행 파일 하나. Electron 없음. 오픈소스(Apache-2.0).
tmux식 ctrl+b 단축키도, 마우스 클릭도 됩니다. 패널 경계를 끌어 크기 조절까지.
Claude Code · Codex · Copilot CLI · Cursor · OpenCode 등 — 상태를 읽어 냅니다.
$ brew install herdr # macOS · mise · Nix도 됨 $ curl -fsSL https://herdr.dev/install.sh | sh # Linux · macOS $ herdr # 실행 — 업데이트는 herdr update
space — 프로젝트를 나누는 서랍. 사이드바에 줄지어 섭니다.
tab — 한 프로젝트 안의 화면 배치. 에이전트용 · 로그용 · 서버용.
pane — 진짜 터미널 하나. 에이전트가 사는 곳.
| 상태 | 뜻 | 내가 할 일 |
|---|---|---|
| working | 일하는 중 | 그냥 둔다 |
| blocked | 내 입력 · 승인 · 결정을 기다림 | 지금 바로 간다 — 멈춰 있는 시간이 손해 |
| done | 끝났는데 아직 내가 안 봄 | 결과 확인 → 다음 일 주기 |
| idle | 끝났고 확인도 함 — 대기 중 | 새 일을 줄 수 있는 빈자리 |
| unknown | 상태를 판단할 수 없음 | 직접 들여다본다 |
pane → tab → space로 상태가 모입니다. 한 명이라도 blocked면 그 space가 통째로 빨갛게.
ctrl+b g Goto 창에서 blocked · done만 골라 바로 점프.
pane에서 지금 돌고 있는 프로그램이 무엇인지 보고, 화면 맨 아래를 에이전트별 패턴과 맞춰 봅니다.
"❯ 1. 예 / 2. 아니오"가 보이면 → blocked.
$ herdr integration install claude
에이전트의 훅이 상태를 직접 보고합니다. codex · cursor 등도 같은 방식.
herdr agent explain <pane> — 상태 판단의 근거를 보여 줍니다.
pane 속에서 tmux를 또 띄우면 에이전트가 가려져서 상태를 못 읽습니다.
백그라운드에서 터미널을 쥐고 있음
보여 주기만 하는 손님
| ctrl+b q | 화면만 떼기 (detach) — 에이전트는 계속 |
| herdr | 다시 붙기 — 떠난 자리 그대로 |
| herdr session list · attach · stop | 이름 붙인 세션을 여러 개 운영 |
| herdr server stop | 전부 끄기 — 모든 pane이 종료됨 |
| shift+n | 새 space |
| w | space 이동 |
| c | 새 tab |
| n p | 다음 · 이전 tab |
| 1…9 | tab 번호로 |
| v | 오른쪽으로 나누기 |
| - | 아래로 나누기 |
| hjkl | pane 사이 이동 |
| z | 크게 보기 |
| x | 닫기 |
| g | 상태로 찾아가기 |
| b | 사이드바 켜고 끄기 |
| [ | 복사 모드 |
| q | 화면 떼기 |
| ? | 단축키 전체 보기 |
외우기 싫으면 — 그냥 마우스로 클릭하세요. space · tab · pane · 에이전트 모두 눌러집니다.
$ herdr workspace create --cwd ~/project --label api # space 만들기 $ herdr pane run w1:p2 "npm test" # 특정 pane에서 명령 실행 $ herdr agent wait w1:p1 --until done # 그 에이전트가 끝날 때까지 기다리기
agent wait --until done 뒤에 다음 명령을 붙이면 — 사람 없이 바통 터치.
CLI는 로컬 소켓 위의 JSON API를 감싼 것. 상태 변화 이벤트를 구독해 알림·대시보드도 만듭니다.
📁 vibe-coding # space = 프로젝트 ├ agents logs server # tab = 용도별 화면 📁 side-project ├ agents review
프로젝트는 space로, 그 안의 일은 tab으로 — 에이전트가 여럿이어도 어디서 뭘 하는지 한눈에.
✅ feat-login 완료 — 결과 확인 🙋 feat-search 답변 대기 — 내 차례 ⏳ refactor-db 작업 중
완료·답변 대기가 바로 보이니 멈춘 에이전트에 곧장 다음 일을 줍니다.
brew install herdr herdr integration install claude
ctrl+b shift+n 로 space를 만들고 agents 탭에 에이전트 2~3개.
사이드바의 빨간 점이 뜨면 가서 답하고, 초록 점이면 결과 보고 다음 일.