herdr orchestrator, 여러 에이전트를 슬래시 커맨드로 돌리는 법

🇰🇷 한국어

|

🇺🇸 English

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 — 공식 문서의 설치·학습·설정 안내를 제공합니다.

도구 구독이 부담되면 할인 경로만 보시면 됩니다.

Based only on the official documentation checked as of 2026-09-03, the practical takeaway is an automation and CLI workflow that lets a script or one agent create work for other coding agents, inspect their state, and collect results. This article explains that documented route first, then records the narrow personal workflow I use.

What does the orchestration angle mean?

Short answer: “herdr orchestrator” is not a separately documented product name; it is the search angle used here for the documented automation layer and CLI coordination flow for coding agents.

The official Agent automation page describes a script or one agent creating work for other agents, checking their state, and collecting their results. Its documented responsibilities are divided as follows.

• Layout controls workspace, tab, and pane topology.
• Pane controls the raw terminal.
• Agent controls the lifecycle of a recognized coding agent.

Starting an agent requires an existing shell pane; starting the agent does not create or rearrange the layout. The automation CLI documents lifecycle states including working, blocked, done, idle, and unknown.

When the documentation specifies creation-command output, a script should capture the returned JSON IDs rather than predict them. Agents stay in real terminal panes and their state is collected in the sidebar, so the official automation guide is the route for coordination from a script or another agent.

How does the official skill/CLI flow relate to slash commands?

Short answer: The verified official pages do not provide a literal /... command for invocation.

The documented route is a reusable agent skill plus the local CLI. A coding agent running in a Herdr-managed pane with HERDR_ENV=1 uses the herdr CLI to control the runtime. Unless a primary agent document establishes otherwise, a slash-command menu in a personal workflow belongs to the coding agent’s skill or custom-instruction UI, not to a Herdr builtin.

The reusable skill is installed with this official command.

npx skills add herdrdev/herdr --skill herdr -g

Omitting -g makes the installation project-local. The skill lists inspection of workspaces, panes, and neighboring agents; pane splitting; output reading; waiting; and helper starts. The CLI uses the same local socket API as the running server uses for integrations and agents, and most commands return JSON for deterministic scripting.

Plugins are executable workflow packages whose manifests can declare actions and which the runtime can launch. The full CLI is their plugin API, but that does not establish any literal slash-command syntax.

How do you get started?

Short answer: From a project directory, run the runtime command to launch or attach to the default background session.

herdr

If the session has no workspaces, one opens automatically. A workspace is the project-level container for tabs, panes, and agents. Start a supported coding agent in a pane and the runtime detects it automatically; the sidebar shows working, blocked, done, or idle across workspaces.

Agents keep running after the client detaches. The install page lists direct installers for Linux/macOS and Windows, along with Homebrew, mise, and Nix routes; those options are secondary here because the workflow starts with the project-directory command.

How is the personal use limited?

• I currently subscribe to AGY, Cursor agent, and Codex CLI.
• I run them through this runtime.
• I created slash commands and use that workflow.

What should the FAQ answer?

Short answer: The four checks are whether the name is official, whether an invocation method is documented, whether automation can coordinate agents, and what happens after the client detaches.

Question	Answer
Is “herdr orchestrator” an official product name?	The exact name was not found on the verified official pages. Here it is the search angle for the documented automation and CLI workflow.
Does the official documentation give a /... command to invoke?	Not on the verified official pages. Use the documented herdr CLI and the agent-skill installation facts as the reference point.
Can a script coordinate agents?	Yes. The official Agent automation page explicitly presents that use case and separates layout, pane, and agent controls.
Do agents keep running after the client detaches?	The official Quick start and Concepts pages say that the server and agents continue after client detachment; stopping the server ends its panes.

What are the sources?

Short answer: The article uses only official documentation checked as of 2026-09-03.

• Official Agent automation documentation — describes the agent automation layer and coordination flow.
• Official Agent skill file documentation — documents reusable-skill installation and CLI use from a managed pane.
• Official CLI reference — documents the CLI and JSON responses.
• Official Quick start documentation — documents starting a session from a project directory.
• Official Agents documentation — documents terminal panes and sidebar state.
• Official Concepts documentation — documents server and session concepts.
• Official Plugins documentation — documents executable workflow packages and the CLI API.
• Official Install documentation — lists the supported installation routes.
• Herdr documentation — provides the official install, learn, and configure guidance.

If tool subscriptions feel expensive, see only the discount route.