agent-swarm
무엇인가
agent-swarm은 회사 단위의 AI 작업을 돌리는 자체 호스팅 오케스트레이션 계층이다. 단일 코딩 에이전트 세션을 대체하는 자리에 놓이며, TypeScript로 작성됐고 MIT 라이선스를 쓴다. CLI, HTTP API, 대시보드 세 가지 표면으로 조작한다.
어떻게 동작하나
리드 에이전트가 Slack, 저장소, 이슈 트래커, 이메일, API에서 작업을 받아 목표를 워커에게 위임한다. 워커는 개발 환경이 갖춰진 격리 Docker 컨테이너에서 실행되고, 하네스는 Claude Code, Codex, pi, opencode, Devin, ACP 에이전트 중에서 고른다. 작업 결과는 스키마로 검증되어 구조화 JSON으로 호출자에게 반환된다. 지연 작업은 감시 대상 작업이 전부 또는 일부 끝나거나 기한이 도달하면 깨어난다. 기억과 정체성은 세션을 넘어 유지되고 인용 평가와 자기 평가 힌트가 기본으로 켜진다. 실시간 룸이 페이지 상태, 프레즌스, 라이브 채널을 공유한다. 확장은 TypeScript 훅으로 설치되며, 에이전트 소유의 비활성 초안 상태로 두었다가 신뢰된 리드나 운영자, 대시보드 사용자가 활성화한다.
무엇과 다른가
터미널에서 단일 에이전트를 돌리는 방식과 달리 작업 상태가 컨테이너 밖에 남는다. 워크플로, 스케줄, 스크립트, 앱으로 반복 작업을 등록하고 검토 게이트를 통과시킨다. 특정 하네스에 묶이지 않아 워커 런타임을 교체할 수 있고, 작업 로그에는 도구 결과 이미지가 인라인으로 들어가며 미리보기를 원본 크기로 연다.
어떻게 쓰나
`npx skills add desplega-ai/agent-swarm`로 운영자 스킬을 설치하거나 하네스 플러그인으로 넣는다. 배포는 Docker Compose 또는 Kubernetes OCI Helm 차트로 한다. API는 http://localhost:3013에서 /docs와 /openapi.json을 노출하고, 대시보드는 이 API에 연결한다. 연동 대상은 Slack, GitHub, GitLab, Linear, Jira, AgentMail, WhatsApp(Kapso), Composio, Sentry, Devin, Serply 검색이다.
전제와 한계
워커 실행에 Docker 컨테이너가 필요하다. 구버전 워커를 올릴 때는 런타임 정체성을 지원할 때까지 MULTI_RUNTIME_ENABLED=false로 둔다. Slack 위임 렌더링은 옵트인이고 데이터베이스 보존은 기본 드라이런이다. AgentMail은 검증된 수신을 확인 응답 전에 아카이브하고 30일 보관한다. 신규 배포는 Slack 스레드 렌더러 v2, 큐잉된 Slack 스티어링, 작업 스티어링, 멀티 런타임 워커, RBAC, 작업 도구 프리로딩, 하이브리드 메모리 검색과 그래프 확장이 켜진 상태로 시작한다. MIT 라이선스는 자체 호스팅 소프트웨어에 적용되고, 플러그인의 개인정보·약관 링크는 웹사이트와 Cloud 서비스를 가리킨다.