Orch termdocs
기능 검색…Ctrl K

대형 기능 · control plane MCP A2A

에이전트 오케스트레이션

대화 중인 AI가 다른 AI(claude·codex·agy)를 워커로 띄워, 컨텍스트를 유지한 채 여러 턴에 걸쳐 협업시킵니다. 지휘자(commander)–워커(worker) 모델로 한 자리에서 팀을 부립니다.

무엇을 하는가

지휘자 AI가 orchterm 안의 워커를 인터랙티브 TUI 탭에 띄우고 메시지를 주고받습니다. 워커도 지휘자에게 먼저 말을 걸 수 있는 양방향 1:1 채널이며, 자기 세션이 아닌 워커는 건드릴 수 없어 남의 작업을 가로채지 못합니다.

commander
외부 Claude Code
지휘자
세션 열기
지시 · 응답
orchterm
MCP 서버
:9611
워커 탭
응답 반환
worker
codex · agy · claude
인터랙티브 탭

시작하기 — 지휘자에게 시키기

  1. 오케스트레이션 켜기

    설정에서 오케스트레이션을 켜고(기본 off) 앱을 재시작합니다. 그러면 외부 Claude Code가 별도 설정 없이 바로 워커를 부릴 수 있습니다.

  2. 지휘자 탭에서 일 맡기기

    지휘자(claude) 탭에 자연어로 위임하면 워커 탭이 뜨고 응답이 돌아옵니다.

    commander · claudeorchestrating
    commander · claude
    backend · codex
    backend(codex)에게 SSH 터널 모듈 리뷰를 맡겨줘 ▸ open_session codex from=ep_claude_8f3a… → { session_id: s_4c1e } ▸ send "channel_open_direct_tcpip 동시성 안전한지 봐줘" ⟳ codex 작업 중… (출력 idle 대기) ◂ reply codex: "&self 차용이라 동시성 안전. -L/-D 리스너는 127.0.0.1 바인드 확인."
    지휘자가 워커를 열고 지시한 뒤 응답을 받는 한 사이클.

감독 대시보드 (Space당 1개)

명령 팔레트에서 "오케스트레이션 워커 지휘자"를 실행하면 감독 대시보드 탭이 열립니다. 현재 Space의 라이브 세션을 모아 보여주고, 각 워커로 이동·진행 중 턴 중지·세션 닫기를 한곳에서 합니다.

오케스트레이션 — 감독 대시보드
오케스트레이션 · Space 1● 2 세션
codex s_4c1e · ssh-core⟳ 턴 진행 중
agy s_91b7 · docs대기(idle)
상태 dot — 주황 진행 중 · 초록 대기. 행에서 이동 · 중지 · 닫기.

무엇을 주고받나

지휘자 AI가 자연어 뒤에서 호출하는 도구입니다 — 사용자가 직접 칠 일은 없고, 흐름을 이해할 때 참고하세요.

도구하는 일
list_agents쓸 수 있는 워커 목록 (codex · agy · claude)
open_session워커를 인터랙티브 탭으로 연다
send상대에게 지시하고 응답을 기다린다
close_session워커 탭을 닫는다

안전 기본값

주의 — 오케스트레이션은 외부 프로그램이 로컬에서 AI를 부리는 통로입니다. 토큰·로컬 바인딩·안전 모드 기본값을 함부로 끄지 마세요.