TL;DR

firstmate는 특정 모델이나 CLI가 아니라 여러 코딩 에이전트를 한 명의 first mate가 조율하도록 만드는 standalone agent distro입니다. 사용자는 Claude Code, Grok, Pi, Codex, OpenCode, Cursor Agent CLI 같은 지원 harness에서 저장소를 실행하고, first mate는 요청을 crewmate별 작업으로 분배해 독립 Git worktree와 가시적인 세션에서 처리합니다. 작업은 PR, 로컬 merge 또는 조사 보고서로 정리되며 tmux를 비롯한 여러 session backend와 디스크 기반 상태 복구를 사용합니다. GitHub CLI 인증과 런타임 의존성이 필요하므로, 단일 에이전트보다 병렬 개발과 장시간 감독이 중요한 환경에서 검토할 만합니다.

핵심 포인트

• firstmate는 CLI나 MCP server가 아니라 코딩 에이전트를 승무원처럼 운영하는 agent distro입니다. 저장소 자체를 복제해 AGENTS.md와 skills를 로드합니다. Claude Code, Grok, Pi 등을 실행하면 first mate가 됩니다.
• 첫 에이전트가 요청을 여러 crewmate 작업으로 나누고 각 작업을 독립 Git worktree와 세션에 배정합니다. 작업 결과는 PR, 승인된 로컬 merge 또는 조사 보고서로 돌아옵니다. 병렬 수정에서 컨텍스트 복사와 터미널 전환을 줄이는 구조입니다.
• tmux를 기본으로 herdr, zellij, cmux, Orca 세션 backend를 선택할 수 있습니다. Bash watcher가 이벤트가 있을 때만 first mate를 깨워 토큰을 쓰지 않는 감독을 수행합니다. 세션이 중단돼도 디스크 상태를 바탕으로 작업을 재조정합니다.
• macOS와 Linux에서 Git, GitHub CLI, 인증된 gh 계정, 지원되는 primary harness가 필요합니다. 설치 프로그램 없이 저장소를 clone한 뒤 Claude Code나 Pi 등을 실행합니다. 단일 에이전트보다 여러 프로젝트 작업을 병렬 처리하려는 개발자에게 적합합니다.