코딩 에이전트 한 명에게 말하고, 일하는 것은 여러 명이 함께하게 만드는 방법
여러 개의 터미널 창을 오가며 각 에이전트의 진행 상황을 확인하고, 컨텍스트를 복사해서 붙여넣는 일은 이제 그만두셔도 됩니다. firstmate는 하나의 에이전트와 대화하면, 나머지 작업들을 별도의 에이전트들이 각자의 독립된 환경에서 처리하도록 지시하는 구조입니다. 마치 선장이 조타수를 통해 선원들을 지휘하듯, 당신은 최종 결과물인 PR이나 리포트만 확인하면 됩니다.
선장과 조타수의 관계
firstmate는 설치형 앱이 아니라, 에이전트가 따를 지침과 스크립트가 담긴 디렉터리입니다. 이 저장소를 클론한 뒤, 지원되는 코딩 에이전트를 실행하면 '조타수(first mate)'가 생성됩니다. 조타수는 사용자의 요청을 받아 필요한 만큼의 '선원(crewmate)' 에이전트를 생성하고, 각각에게 깨끗한 git worktree를 배정합니다. 선원들은 병렬로 작업을 수행하며, 조타수는 그들이 완료될 때까지 감독합니다. 모든 상태는 디스크에 저장되므로, 세션이 재시작되어도 이전 작업 상태를 복원할 수 있습니다.
작업 방식과 결과물
작업은 크게 두 가지 형태로 나뉩니다. 'ship' 작업은 코드 변경을 포함하며, 설정된 프로젝트 모드에 따라 PR을 생성하거나 로컬 머지를 수행합니다. 'scout' 작업은 코드 변경 없이 조사 결과를 리포트로만 남깁니다. 각 작업은 tmux, Herdr, Zellij, cmux, Orca 중 선택한 백엔드에서 독립된 창이나 탭으로 실행되어, 사용자가 진행 상황을 실시간으로 관찰하거나 개입할 수 있습니다. 조타수는 토큰을 소모하지 않는 이벤트 기반 워처를 통해 필요한 시점에만 사용자를 깨웁니다.
사용을 시작하기 위한 준비
사용을 위해선 먼저 GitHub CLI(gh)로 인증을 완료하고, firstmate 저장소를 클론해야 합니다. 이후 Claude Code, Grok, Pi, Codex, OpenCode, Cursor Agent CLI 중 하나를 선택해 실행합니다. 이 중 Claude Code, Grok, Pi는 동등한 1급 지원 대상이며, 각자의 방식으로 워커를 재시작하거나 감시하는 기능을 검증받았습니다. tmux는 기본 세션 백엔드로 사용되며, 다른 백엔드를 사용하려면 해당 문서에 따른 추가 설정이 필요합니다. 조타수는 누락된 도구를 감지하고, 사용자의 동의 후 설치할 수 있습니다.
이 구조를 선택해야 하는 경우
여러 개의 병렬 작업을 동시에 처리해야 하지만, 각 세션을 직접 관리하는 부담을 줄이고 싶은 개발자에게 적합합니다. 특히 단일 저장소에서 여러 가지 수정, 조사, 계획 수립을 동시에 진행할 때 유용합니다. 다만, firstmate는 모델이나 프레임워크가 아니라 에이전트를 운영하는 '디스트로'이므로, 반드시 지원되는 코딩 에이전트를 함께 사용해야 합니다. 또한, 프로젝트 경계는 엄격하게 유지되며, 조타수는 승인된 작업 외에는 프로젝트에 읽기 전용으로 접근합니다. 복잡한 원격 세컨드메이트 구성이나 Relay(소셜 미디어 연동) 기능은 선택 사항이며, 기본 사용에는 영향을 주지 않습니다.