오케스트레이션
에이전트가 서브 에이전트에게 일을 나눠 웨이브로 진행하는 모습을 보고, 세션끼리 연결해 컨텍스트를 공유하기.
⇧⌘F가 오케스트레이션을 엽니다. (파일 편집기에서는 ⇧⌘F가 프로젝트 파일 검색입니다. 오케스트레이션은 보기 메뉴에서도 열 수 있습니다.) 탭이 두 개 있습니다. 워크플로는 세션의 일이 어떻게 나뉘어 어디까지 진행됐는지 보여 주고, 세션 연결은 세션끼리 연결해 컨텍스트를 공유합니다.
오케스트레이션 시작하기#
목표를 적으면 오케스트레이터 에이전트가 나머지를 합니다. 목표에 맞는 에이전트 팀을 짜서 계획을 보여 주고, 웨이브로 실행한 뒤 결과를 검수까지 받습니다.
홈 화면의 오케스트레이션, 탭 오른쪽 클릭 메뉴의 새 오케스트레이션 탭, 새 작업공간의 시작 화면, 또는 이 화면 오른쪽 위의 새 오케스트레이션에서 시작합니다. 시작 창에는:
- 목표 — 팀이 해낼 일.
- 자료 — 팀이 참고할, 목표에 넣은 링크와 첨부 파일. 링크는 목표 아래에 어떻게 읽을지와 함께 표시됩니다. Jira 이슈와 Confluence 페이지는 설정 → 보드의 Jira 연결로(토큰은 그 사이트에만 보냅니다), 누구나 볼 수 있는 사이트면 연결 없이도, GitHub 파일·이슈·PR·저장소는 이 Mac에 로그인된
gh로, 링크가 있는 누구나 볼 수 있게 공유된 Google 문서·스프레드시트·프레젠테이션은 내보내기로, 그 밖의 페이지는 텍스트와 원본 HTML, 스크린샷으로 받아 옵니다. 스크린샷은 Chrome, Edge, Brave, Chromium 중 설치된 브라우저를 빈 프로필로 띄워 찍으므로 로그인 정보는 함께 가지 않습니다. 파일 첨부를 누르거나 파일을 창에 끌어다 놓으면 문서가 추가됩니다. PDF와 이미지는 그대로, Word·Excel·PowerPoint·OpenDocument·RTF 파일은 텍스트 사본과 함께 둡니다. 시작하면 Agentty가 전부 읽어 폴더의.agentty-orchestration/에 둡니다(git에는 들어가지 않습니다). 오케스트레이터는 이것부터 읽고, 못 읽은 것은 직접 시도한 뒤, 계획 전에 일감(WORK_ITEMS.md)으로 정리합니다. 모양을 따라 하는 목표면 결과를 원본 페이지나 그림과 브라우저에서 나란히 비교합니다. - 모델 — 균형, 최고 품질, 절약 중 하나를 팀의 모든 에이전트에 적용합니다. 카드마다 켜 둔 에이전트별로 무엇을 쓰는지 보여 줍니다: Claude Code는 Sonnet·Opus·Haiku, Codex는 쓰던 모델에 추론 medium·high·low, Gemini CLI는 Flash·Pro·Flash-Lite, Antigravity CLI는 그 수준의 Gemini Flash. 검수는 한 단계 위에서 돌고, 계획에는 에이전트마다 쓸 모델이 적힙니다.
- 폴더 — 팀이 일할 곳. 앞에 있는 창의 프로젝트, 없으면 지난 오케스트레이션의 폴더, 그것도 없으면
~/AgenttyWorkspace/orchestration(없으면 만듭니다). - 함께 쓸 AI — 이 Mac에 설치된 에이전트(Claude Code, Codex, Gemini CLI, Antigravity CLI)를 각각 켜고 끕니다. Claude Code가 켜져 있으면 Claude Code가, 아니면 Codex가 리드를 맡습니다. 둘 다 꺼져 있으면 오케스트레이션을 시작할 수 없습니다. 계획은 일마다 강점이 맞는 에이전트에게 맡기고(정밀한 코드 수정과 리뷰는 Codex, 아주 큰 입력은 Gemini), 그 에이전트들의 권한 확인은 끄지 않습니다.
Codex 리드에는 서브에이전트가 없습니다. 그래서 웨이브의 에이전트를 각각 에이전트 CLI 프로세스로 실행하고, 시작과 끝을 Agentty에 알립니다(agentty plan --start / --done). 이 화면은 Claude Code 리드일 때와 똑같이 진행을 따라갑니다. Codex는 이 명령들을 샌드박스 밖에서 실행하기 전에 승인을 묻습니다.
새 작업공간은 처음에 만들어지는 오케스트레이션 그룹에 들어가고, 원하는 그룹으로 옮길 수 있습니다. 시작하면 이 화면에 그 워크플로가 나옵니다. 계획이 준비되면 막대가 뜹니다. 계획 보기는 오케스트레이터 패널을 열고, 수정 요청은 메시지를 보내고, 시작은 계획을 실행합니다. 따로 브랜치가 필요한 일은 병렬 세션(agentty tasks)으로 가고, 마지막에 검수 에이전트가 결과를 목표와 대조한 뒤 오케스트레이터가 보고로 마무리합니다.
따라가기, 이어하기, 중단#
오케스트레이터 패널 맨 위에는 이 화면과 같은 말로 상태를 보여 주는 막대가 있습니다: 계획 세우는 중, 계획 준비됨(시작), 실행 중(작업 중인 에이전트 수와 완료 수), 완료, 중단됨, 중지됨. 워크플로 보기를 누르면 이 화면으로 옵니다. 사이드바와 메뉴 막대에는 그 작업공간이 오케스트레이션 아이콘으로, 상태 색으로 표시됩니다. **×**로 막대를 닫을 수 있습니다. 앱을 다시 켜도 닫힌 채 유지되고, 에이전트가 추가되거나 오케스트레이션이 나를 기다릴 때(승인할 계획, 이어 할 작업)만 다시 나타납니다.
오케스트레이션은 재시작해도 남습니다. 실행 중에 Agentty가 종료되거나 강제 종료되면 에이전트도 함께 멈춥니다. 그러면 막대와 이 화면에 중단됨이 뜨고, 이어하기를 누르면 필요하면 세션을 다시 열어 이미 끝난 일은 두고 남은 일만 이어서 실행합니다. 전체 중단(확인 후)은 오케스트레이터의 현재 작업과 아직 돌고 있는 모든 에이전트를 멈추고, 나중에 이어하기로 계속할 수 있습니다. 삭제는 오케스트레이션을 목록에서 지우고 터미널도 닫습니다. 다른 것이 없는 작업공간이면 작업공간도 함께 지웁니다. 만든 파일은 그대로 남습니다. 그 작업공간을 삭제해도 오케스트레이션이 함께 지워집니다.
설정은 설정 → AI 설정 → 오케스트레이션에 있습니다: 사용 여부, 새 오케스트레이션의 기본 모델, 기본으로 함께 쓸 다른 AI, 계획을 보여 준 뒤 시작을 기다릴지, 새 작업공간과 새 탭 중 어디에 열지.
워크플로#
왼쪽은 스레드 목록입니다. Agentty에서 실행 중인 에이전트 세션이 상태 색 점과 함께 나오고, 에이전트가 agentty tasks로 시작한 병렬 작업 묶음도 나옵니다. 하나를 고르면 그 워크플로가 보입니다.
- 맨 위: 마지막으로 시킨 일(
$ …)과 세션 이름. - 오케스트레이터 줄: 메인 에이전트의 상태, 웨이브 수, 끝난 서브 에이전트 수, 쓰고 있는 모델 수. 열기는 그 패널로 가고, 메시지는 그 패널에 입력한 것처럼 한 줄을 보내고, 중단은 지금 턴을 멈춥니다(패널에서 Esc를 누른 것과 같음).
- 그래프: 오케스트레이터 다음에 서브 에이전트들이 웨이브별로 한 열씩 나옵니다. 오케스트레이션의 웨이브는 계획에서 옵니다. 계획이 나오는 순간 모든 에이전트가 그래프에 올라오고, 아직 시작하지 않은 에이전트는 대기로 보이며, 각자 기다리는 에이전트에서 선이 이어져 일이 웨이브에서 웨이브로 넘어가는 것이 보입니다. 다른 세션은 같은 시간에 돌았던 서브 에이전트가 한 웨이브입니다. 일하는 중인 웨이브에는 밑줄이 그어집니다. 카드마다 실행 중·완료·대기와 걸린 시간, 에이전트 종류와 모델, 지금 단계나 마지막 한마디가 나옵니다. 실행 중인 웨이브로 가는 선은 움직입니다. 카드를 누르면 그 서브 에이전트의 기록이 열립니다.
- 맨 아래: 서브 에이전트들의 최근 단계가 실시간으로 나옵니다. 스크롤하면 이전 단계를 볼 수 있고(오른쪽 아래 화살표로 최신으로 돌아옵니다), 위쪽 가장자리를 끌어 높이를 바꿀 수 있으며, 왼쪽 목록은 오른쪽 가장자리를 끌어 너비를 바꿉니다.
병렬 작업 묶음은 작업들이 한 웨이브로 나오고, 각자 브랜치(또는 폴더)와 패널 상태를 보여 줍니다. 누르면 그 패널로 갑니다.
그래프의 빈 곳을 끌거나 휠을 굴리면 이동합니다. ⌘ 또는 Ctrl과 휠, 또는 오른쪽 아래 버튼으로 확대·축소하고, 전체 보기로 한눈에 봅니다.
세션 연결#
한 세션에서 다른 세션으로 선을 끌면 받는 쪽이 보낸 쪽의 컨텍스트를 받습니다. 무엇을 작업 중인지, 무엇을 결정했는지, 어디까지 왔는지입니다. Claude Code와 Codex 사이에서도 동작합니다.
Claude Code 세션 둘을 연결하면, 여기서 선을 그었든 터미널의 링크 버튼으로 창을 골랐든 직접 연결됩니다. 두 세션이 서로 메시지를 주고받습니다. 선을 시작한 세션은 상대 세션 프로젝트의 일을 직접 하지 말고 상대에게 넘기라는 안내를 받고, 상대 세션은 일을 마치면 결과를 알려 줍니다. 막 시작했거나 아직 이어서 여는 중인 세션은 몇 초 기다립니다. 그래도 서로 메시지를 보낼 수 없으면 대화 내용만 한쪽으로 넘기고 그렇다고 알려 줍니다.
세션이 많을 때는 화면을 옮겨 가며 봅니다. 스크롤하거나 빈 곳을 끌면 화면이 움직이고, ⌘ + 스크롤은 포인터를 중심으로 확대·축소합니다. 오른쪽 아래 버튼으로 축소·확대, 100%로 되돌리기, 모든 세션이 보이게 맞추기를 할 수 있습니다.
연결 방식#
| 방식 | 동작 |
|---|---|
| 한 번 | 선을 그은 시점의 컨텍스트를 전달 |
| 라이브 | 보낸 쪽의 새 턴이 생길 때마다 받는 쪽으로 전달 |
| 양방향 | 서로에게 전달 — 컨텍스트 터널 |
라이브 연결을 쓰면 직접 복사하지 않아도 두 번째 에이전트가 계속 상황을 따라옵니다. 양방향 연결을 쓰면 두 에이전트가 같은 문제를 절반씩 맡으면서도 상대가 방금 한 일을 압니다.
무엇이 전달되는가#
대화의 요약입니다. ~/.agentty/handoffs/에 파일로 써서 받는 에이전트에게 넘깁니다. 프롬프트와 응답을 턴 단위로 재생하지는 않습니다.
언제 무엇을 쓰나#
- 한 번 — 관련된 작업에 두 번째 에이전트를 시작하면서 맥락을 알고 출발하게 할 때.
- 라이브 — 한쪽이 구현하고 다른 쪽이 리뷰하거나 문서를 쓰거나 테스트를 지켜볼 때.
- 양방향 — 두 에이전트가 기능을 나눠 맡았고 서로 어긋나면 안 될 때.
연결을 끄면 전달이 멈춥니다. 이미 전달된 내용은 받는 쪽의 대화에 남습니다.