kunchenguid/firstmate

해결하는 문제

Firstmate는 개발자가 여러 병렬 코딩 작업(버그 수정, 연구, 감사 등)을 서로 다른 터미널 세션과 리포지토리 간에 수동으로 관리해야 하는 '탭 전환 문제'를 해결합니다. 개별 에이전트를 하나씩 관리하는 대신 사용자는 단일한 '프리메이트' 에이전트와 상호작용하며, 이 에이전트가 자율적인 워커 에이전트 팀을 관리하고 작업 배분, 감시, 결과 통합을 수행합니다.

작동 방식

Firstmate는 일반적인 코딩 에이전트(예: Claude Code, Grok, Pi 등)를 감독자로 전환하는 지침, 도구, 정책의 집합인 '에이전트 디스트리뷰션'으로 작동합니다.

1. 연락 모델: 사용자는 프리메이트와 대화하고, 이 에이전트가 tmux, Zellij, Orca와 같은 격리된 세션 백엔드에서 크루메이트 에이전트를 생성합니다.
2. 격리: 각 크루메이트는 treehouse를 통해 독립된 깨끗한 git worktree에서 작동하여 병렬 작업 간 충돌을 방지합니다.
3. 감시: bash 기반의 제로 토큰 감시자가 팀을 모니터링하며, 인간의 개입이나 결정이 필요한 경우에만 프리메이트를 깨웁니다.
4. 배달: 작업은 '선박'(PR 또는 로컬 머지 결과) 또는 '정찰'(조사 보고서 결과)로 분류됩니다.
5. 확장성: 사용자는 '세컨드메이트'(로컬 또는 원격 SSH 호스트에 있는 지속적 에이전트)와 'Relay' 시스템(예: X, Discord에서의 요청 처리)에 참여할 수 있습니다.

대상 사용자

AI 코딩 에이전트를 사용하고, 각 세션의 컨텍스트와 상태를 수동으로 관리하지 않고도 병렬로 여러 자율 작업을 수행하여 생산성을 극대화하고자 하는 개발자.

주요 특징

• 단일 접점: 전체 팀을 관리하는 단일 감독 에이전트와 상호작용할 수 있습니다.
• 일회용 Worktree: 각 작업에 독립된 git 환경을 제공하여 코드 충돌을 방지합니다.
• 다중 백엔드 지원: tmux, Herdr, Zellij, cmux, Orca 등 다양한 터미널 멀티플렉서와 호환됩니다.
• 해머스 무관성: Claude Code, Grok, Pi, Cursor Agent CLI 등 여러 주요 에이전트 해머스와 호환됩니다.
• 재시작 대응 상태: 모든 상태는 디스크에 영구 저장되어 크래시나 재시작 후에도 세션을 복구하고 재개할 수 있습니다.