Install

ui-install.sh --preset full --tunnel

누구에게 적합한가

여러 agent를 하나의 통합 시스템 안에서 오케스트레이션하고 싶은 팀이나 개인에게 적합합니다. 작업 라이프사이클 도구(send-task, cancel-task, task-action, poll-task, store-progress), steering 메시지, session/session logs, 그리고 예산 관리(getBudget/getBudgets/upsertBudget/deleteBudget)를 통해 agent 그룹을 지휘하고 모니터링할 수 있으며, 최신 버전은 v2.7.7입니다.
e2e 계약이 "모든 route, MCP 도구, 워크플로 노드 타입"을 커버하고, 각 도메인에 32개 이상의 MCP 도구가 문서화되어 있어, 멀티 agent 협업을 장기 인프라로 다루려는 사용자에게 적합합니다.
제로 배포, 단일 파일 즉시 사용을 원하는 사용자에게는 부적합합니다. 기본 설치 경로는 tunnel이 포함된 preset full 배포이며, Compose 스택에는 lead, workers, agent-fs, MinIO, Caddy가 포함됩니다. tls profile을 사용하면 실제 agent-swarm.dev 서브도메인에 배포됩니다.
자격 증명 요구 사항, 인증 방식, 예산 gate의 기본 임계값은 수집된 증거에서 설명되지 않았으므로, 사용 전에 공식 README/문서에서 확인해야 합니다.

공식 기본 경로는 README와 문서에 있는 전체 설치입니다: ui-install.sh --preset full --tunnel.
전제 조건: 여러 서비스 컨테이너를 띄울 수 있는 호스트 한 대와 Bun 런타임 설치(agent-swarm은 Bun 기반이며 데이터 레이어는 bun:sqlite). 품질 게이트는 bun run lint와 tsc:check를 사용하므로, 소스 코드를 Bun 워크플로로 검증할 수 있음을 알 수 있습니다.
부작용 주의: 이것은 읽기 전용 시험이 아니라 실제 배포입니다. 로컬 상태(SQLite)에 기록하고 MinIO/Caddy 등의 서비스를 띄우며, tls profile 사용 시 실제 서브도메인을 점유합니다. 실행 전에 이러한 부작용이 수용 가능한지 확인하세요. 증거에는 공식 롤백/취소 명령이 제공되지 않으므로, 원클릭 복원이 가능하다고 가정하지 마세요.
성공 신호: 설치 스크립트가 완료되면 Compose 스택의 lead, workers, agent-fs, MinIO, Caddy가 실행 상태가 되며, dashboard UI(공식 데모는 agent-browser 사용)를 통해 시스템 상태를 점검할 수 있습니다.
배포 없이 도구 면만 먼저 파악하고 싶다면, 증거에는 더 가벼운 공식 경로가 제공되지 않으므로 대체 설치 방식을 추측하지 마세요.

사례 1: 작업을 내리고 추적하기. 배포가 완료되면 MCP를 통해 send-task를 호출해 swarm에 작업을 보내고, 이어서 poll-task로 진행 상황을 폴링하고, store-progress로 진행 상황을 기록합니다(terminal 'skipped' 상태 지원). 필요하면 cancel-task로 중단할 수 있습니다. 기대할 수 있는 결과: 작업이 생성부터 종료 상태까지 거치는 라이프사이클을 session logs에서 확인할 수 있습니다.
사례 2: 일일 예산을 설정해 무분별한 소비 방지하기. getBudget/getBudgets를 호출해 현재 예산을 확인하고, upsertBudget으로 일일 지출 상한을 설정합니다. 공식 증거에 따르면 지출이 일일 gate에 도달하면 시스템이 이후 작업 수락을 거부합니다. 이것이 예산 메커니즘이 작동하는 것을 직접 관찰하는 방법입니다. 삭제는 deleteBudget을 사용합니다.

읽기/쓰기 성격: 읽기 전용 조회(getBudgets, poll-task, session logs)와 쓰기 및 취소 작업(send-task, upsertBudget, cancel-task)이 모두 있습니다. 첫 시도 이후 어떤 쓰기 작업이든 수행하기 전에 dashboard에서 대상 상태를 먼저 확인하세요.
로컬 데이터: 데이터 레이어는 bun:sqlite이며 호스트에 로컬 데이터베이스 상태를 기록합니다. 이는 로컬 쓰기이며, 조회 도구가 존재한다고 해서 읽기 전용이 되는 것이 아닙니다.
배포 부작용: 한 번에 여러 서비스 스택을 띄우고 실제 도메인을 점유할 수 있으며, 증거에는 롤백 경로가 제공되지 않습니다.
아직 확인되지 않은 사항: 일일 예산 gate의 기본값, 자격 증명 및 인증 요구 사항, 각 MCP 도구의 전체 파라미터 시그니처(도구 이름과 32개 이상이라는 수량만 확인됨). 사용 전에는 공식 README/문서를 기준으로 하세요.