Squad

에이전트 협업 및 메시지 전달

에이전트는 squad send와 squad receive 명령을 통해 메시지를 교환합니다. --wait 옵션을 사용하면 메시지가 도착할 때까지 블로킹 대기할 수 있어 실시간 협업이 가능합니다. 모든 메시지는 .squad/messages.db SQLite 파일에 저장됩니다.

작업(task) 관리

squad task create로 작업을 생성하고, squad task ack로 작업을 수락하며, squad task complete로 완료 처리할 수 있습니다. 작업은 자동으로 고유 ID가 부여되어 동시 실행 시 충돌이 발생하지 않습니다. squad task list로 작업 목록을 필터링해 볼 수 있습니다.

역할 및 팀 템플릿

역할은 .squad/roles/ 디렉터리의 마크다운 파일로 정의됩니다. 기본 제공되는 관리자, 작업자, 검사자 역할 외에도 사용자 정의 역할을 추가할 수 있습니다. 팀은 .squad/teams/의 YAML 파일로 구성되며, squad team <이름> 명령으로 팀 설정을 적용할 수 있습니다.

슬래시 명령어 통합

squad setup 명령을 통해 Claude Code, Gemini CLI, Codex CLI, OpenCode 등에 /squad 슬래시 명령어를 설치할 수 있습니다. 설치 후 해당 AI 도구의 터미널에서 /squad manager와 같이 바로 사용할 수 있습니다.

다운로드·설치 방법

Windows에서는 GitHub Releases에서 squad-x86_64-pc-windows-msvc.zip을 다운로드한 후 압축을 해제하고, squad.exe를 원하는 폴더(예: C:Toolssquad)에 놓습니다. 그 폴더를 시스템 PATH에 추가하면 어디서든 squad 명령을 사용할 수 있습니다.

기본 사용법/명령어

먼저 squad init를 실행해 작업 공간을 초기화합니다. 이 명령은 .squad/ 디렉터리를 만들고, Git 무시 목록에 추가하며, 관련 AI 도구의 설정 파일에 협업 가이드를 추가합니다.

각 터미널에서 에이전트를 시작합니다:

• 터미널 1: /squad manager (또는 squad join manager)
• 터미널 2: /squad worker
• 터미널 3: /squad inspector

작업자 역할로 참여할 때는 클라이언트와 프로토콜 버전을 지정할 수 있습니다:

작업을 생성하고 처리하는 일반적인 흐름은 다음과 같습니다:

1. 관리자가 작업 생성: squad task create manager worker --title "UI 개선" --body "버튼 색상 수정"
2. 작업자가 작업 수락: squad task ack worker <task-id>
3. 작업 완료 및 보고: squad task complete worker <task-id> --summary "색상 변경 완료"
4. 다른 에이전트에게 알림: squad send --task-id <task-id> inspector worker "접근성 검토 요청"

이런 경우에 유용합니다

여러 AI 도구를 동시에 사용해야 하는 개발자나 연구자에게 유용합니다. 예를 들어, Claude Code로 코드를 작성하고, Gemini CLI로 테스트를 생성하며, OpenCode로 리뷰를 진행할 때, 각 도구의 터미널에서 Squad를 통해 작업을 조율하고 결과를 공유할 수 있습니다. 별도의 협업 플랫폼 없이 터미널만으로도 복잡한 멀티 에이전트 워크플로우를 구축할 수 있습니다.

제한 사항·확인 사항

소스 코드로부터 빌드하려면 Rust 1.77 이상이 필요합니다. Windows에서는 미리 빌드된 바이너리를 사용하는 것이 권장되며, 소스 빌드를 위해서는 Rust 도구 체인이 설치되어 있어야 합니다. squad setup의 tmux 런처 기능은 Unix-like 환경에서만 작동하며, Windows에서는 기본 슬래시 명령어 설치만 지원됩니다.