herdr orchestrator, 여러 에이전트를 슬래시 커맨드로 돌리는 법
2026-09-03 기준, 공식 문서로 herdr에서 여러 에이전트를 오케스트레이션하고 슬래시/스킬 커맨드로 돌리는 법을 이해하는 데 이 런타임이 적합합니다. 이 글은 스크립트나 한 에이전트가 다른 코딩 에이전트의 작업을 만들고 상태를 확인하고 결과를 모으도록 돕는 자동화·CLI 흐름의 시작점과 제가 실제로 사용하는 범위를 차례로 정리합니다.
이 도구의 orchestrator는 무엇입니까?
한 줄 답: ‘이 도구의 orchestrator’는 공식적으로 따로 이름 붙은 제품이 아니라, 코딩 에이전트를 위한 자동화 계층과 CLI 조정 흐름을 설명하기 위한 이 글의 검색 관점입니다.
공식 Agent automation 문서는 스크립트나 한 에이전트가 다른 에이전트의 작업을 만들고, 상태를 확인하고, 결과를 수집할 수 있다고 설명합니다. 문서에 나온 책임은 다음처럼 나뉩니다.
- layout은 워크스페이스, 탭, 패인의 토폴로지를 제어합니다.
- pane은 원시 터미널을 제어합니다.
- agent는 인식된 코딩 에이전트의 생명주기를 제어합니다.
에이전트를 시작하려면 기존 shell pane이 필요하며, 에이전트 시작 자체가 레이아웃을 만들거나 재배치하지는 않습니다. 자동화 CLI에는 working, blocked, done, idle, unknown 같은 생명주기 상태가 문서화되어 있습니다.
생성 명령의 출력이 문서에 지정된 경우에는 스크립트가 ID를 미리 예상하지 않고 반환된 JSON ID를 캡처해야 합니다. 에이전트는 실제 터미널 패인 안에서 계속 실행되고 상태는 사이드바에 모이므로, 스크립트나 다른 에이전트에서 조정하려면 공식 자동화 문서의 경로를 따르면 됩니다.
슬래시 커맨드는 공식 문서에서 어떻게 씁니까?
한 줄 답: 확인한 공식 문서에는 호출용으로 바로 입력하는 문자 그대로의 /... 명령이 없습니다.
공식적으로 문서화된 경로는 재사용 가능한 에이전트 스킬과 로컬 CLI입니다. HERDR_ENV=1인 관리된 pane 안에서 실행 중인 코딩 에이전트가 이 런타임을 제어하는 herdr CLI를 사용합니다. 개인 사용 흐름에서 보이는 슬래시 커맨드 메뉴는 1차 에이전트 문서가 별도로 입증하지 않는 한 이 흐름의 내장 기능이 아니라 코딩 에이전트의 스킬 또는 사용자 지정 지침 UI로 구분해야 합니다.
재사용 가능한 스킬은 다음 공식 설치 명령으로 추가합니다.
npx skills add herdrdev/herdr --skill herdr -g
-g를 생략하면 현재 프로젝트에만 설치됩니다. 이 스킬에 문서화된 기능은 워크스페이스·패인·주변 에이전트 점검, 패인 분할, 출력 읽기, 대기, 헬퍼 시작입니다. CLI는 실행 중인 서버가 통합 및 에이전트에 제공하는 것과 같은 로컬 소켓 API를 사용하며, 대부분의 명령은 결정적인 스크립팅을 위해 JSON을 반환합니다.
플러그인은 실행 가능한 워크플로 패키지이며 매니페스트에서 액션을 선언할 수 있고 이 런타임이 이를 시작할 수 있습니다. 플러그인 API는 전체 CLI이지만, 이것만으로 문자 그대로의 슬래시 커맨드 문법이 생긴다고 볼 근거는 없습니다.
시작은 어떻게 합니까?
한 줄 답: 프로젝트 디렉터리에서 이 런타임의 명령을 실행하면 기본 백그라운드 세션을 시작하거나 기존 세션에 연결할 수 있습니다.
herdr
세션에 워크스페이스가 없으면 하나가 자동으로 열립니다. 워크스페이스는 탭, 패인, 에이전트를 담는 프로젝트 수준의 컨테이너입니다. 지원되는 코딩 에이전트를 패인에서 시작하면 자동으로 감지되고, 워크스페이스 전반의 working, blocked, done, idle 상태가 사이드바에 표시됩니다.
클라이언트에서 분리한 세션에서도 에이전트는 계속 실행됩니다. 설치 페이지에는 Linux/macOS와 Windows용 직접 설치 프로그램, Homebrew, mise, Nix 경로가 함께 안내되어 있지만, 여기서는 설치보다 이 실행 흐름을 먼저 보면 됩니다.
실제 사용은 어떻게 하고 있습니까?
- 현재 AGY, Cursor agent, Codex CLI를 구독하고 있습니다.
- 이들을 이 런타임을 통해 실행하고 있습니다.
- 슬래시 커맨드를 만들었고, 그 흐름을 사용하고 있습니다.
FAQ는 무엇을 보면 됩니까?
한 줄 답: 공식 명칭인지, 호출 방식이 문서화되어 있는지, 자동화가 가능한지, 클라이언트에서 분리한 뒤에도 계속 실행되는지를 확인하면 됩니다.
| 질문 | 답변 |
|---|---|
| ‘이 도구의 orchestrator’는 공식 제품명입니까? | 확인한 공식 페이지에서는 그 정확한 이름을 찾지 못했습니다. 이 글에서는 공식 자동화·CLI 흐름을 설명하기 위한 검색 관점으로 사용합니다. |
공식 문서에 호출용 /... 명령이 있습니까? | 확인한 공식 페이지에는 없습니다. 문서에 있는 herdr CLI와 에이전트 스킬 설치 사실을 기준으로 이해하면 됩니다. |
| 스크립트로 에이전트를 조정할 수 있습니까? | 가능합니다. 공식 Agent automation 문서는 이 사용 사례를 명시하고 layout, pane, agent 제어를 구분합니다. |
| 클라이언트에서 분리한 뒤에도 에이전트가 계속 실행됩니까? | 공식 Quick start와 Concepts 문서에 따르면 서버와 에이전트는 클라이언트 분리 뒤에도 계속 실행되며, 서버를 중지하면 서버의 패인이 종료됩니다. |
출처는 무엇입니까?
한 줄 답: 아래 내용은 2026-09-03 기준으로 확인한 공식 문서만을 바탕으로 정리했습니다.
- Agent automation 공식 문서 — 에이전트 자동화 계층과 조정 흐름을 설명합니다.
- Agent skill file 공식 문서 — 재사용 스킬 설치와 관리된 pane의 CLI 사용을 설명합니다.
- CLI reference 공식 문서 — CLI와 JSON 응답을 설명합니다.
- Quick start 공식 문서 — 프로젝트 디렉터리에서 세션을 시작하는 흐름을 설명합니다.
- Agents 공식 문서 — 터미널 pane과 사이드바 상태를 설명합니다.
- Concepts 공식 문서 — 서버와 세션 개념을 설명합니다.
- Plugins 공식 문서 — 실행 가능한 워크플로 패키지와 CLI API를 설명합니다.
- Install 공식 문서 — 지원되는 설치 경로를 안내합니다.
- Herdr documentation — 공식 문서의 설치·학습·설정 안내를 제공합니다.
도구 구독이 부담되면 할인 경로만 보시면 됩니다.