Repolode
제출하기
kunchenguid

kunchenguid/firstmate

코딩 에이전트 팀을 운영하기 위한 에이전트 배포판으로, 하나의 퍼스트메이트와 대화하면 격리된 Git worktree와 tmux 스타일 세션에서 작업을 병렬로 진행합니다.

GitHub에서 보기
스타
8,661
포크
2,716
열린 이슈
2,608
마지막 커밋
어제

어떤 프로젝트인가요?

firstmate는 범용 터미널 코딩 에이전트를 에이전트 팀의 코디네이터로 바꿔 주는 지침, 스킬, 보조 스크립트 모음입니다. 설치할 앱은 없습니다. 저장소를 clone한 뒤 Claude Code, Grok, Pi, Codex, OpenCode 같은 지원 하네스를 저장소 안에서 실행하면 해당 세션이 퍼스트메이트가 됩니다. 채팅으로 작업을 설명하면 퍼스트메이트가 자율적으로 작업하는 크루메이트를 생성합니다. 각 크루메이트는 확인할 수 있는 별도 세션과 깨끗한 Git worktree에서 작업하고, PR이나 승인된 로컬 병합 또는 조사 보고서를 내놓을 때까지 감독을 받습니다.

여러 코딩 에이전트를 동시에 돌리다 보면 터미널 사이를 오가고, 저장소 간에 컨텍스트를 복사하고, 어떤 작업이 실패했는지 놓치는 등 수동으로 관리해야 하는 상황을 해결하는 것이 이 프로젝트의 목표입니다. 감독은 이벤트 기반으로 이루어지며, 크루메이트가 판단을 필요로 할 때만 워처가 퍼스트메이트를 깨웁니다. 각 프로젝트는 PR, 직접 PR 또는 로컬 전용 병합 방식으로 결과물을 전달하도록 설정할 수 있습니다. 선택 사항인 상주형 세컨드메이트는 로컬 머신이나 SSH로 접속할 수 있는 호스트의 격리된 홈 디렉터리에서 실행할 수 있습니다.

저장소는 macOS와 Linux를 지원하며, 기본 레퍼런스 백엔드인 tmux를 비롯해 herdr, Zellij 등 실험적이라고 표시된 여러 세션 백엔드를 지원합니다.

핵심 기능

  • 01하나의 퍼스트메이트와 대화해 크루메이트의 병렬 작업을 지시하고 감독합니다.
  • 02각 작업은 별도의 일회용 Git worktree에서 실행되므로 같은 저장소에서 병렬로 작업해도 충돌하지 않습니다.
  • 03크루메이트는 확인하거나 참여할 수 있는 tmux 창 또는 그 밖의 지원 세션 백엔드에서 실행됩니다.
  • 04프로젝트별 모드로 PR, 직접 PR, 로컬 전용 병합 중 결과물 전달 방식을 설정할 수 있습니다.
  • 05선택 사항인 상주형 세컨드메이트는 로컬 또는 SSH로 접속 가능한 호스트의 격리된 홈 디렉터리에서 실행할 수 있습니다.
  • 06이벤트 기반 워처는 판단이 필요할 때만 퍼스트메이트를 깨웁니다.

활용 사례

  • 여러 저장소에서 버그 수정이나 기능 작업을 동시에 여러 개 진행하기.
  • 코드베이스 조사나 감사를 에이전트에 맡기고 서면 보고서를 받기.
  • 터미널을 오가며 관리하지 않고 하나의 채팅 세션에서 코딩 에이전트들을 지휘하기.
  • 서로 다른 머신에서 실행되는 상주형 세컨드메이트에 대규모 작업을 분담하기.

빠른 시작

  1. 1

    GitHub CLI를 인증합니다

    gh auth login
  2. 2

    firstmate 저장소를 클론합니다

    git clone https://github.com/kunchenguid/firstmate
  3. 3

    클론한 디렉터리로 이동합니다

    cd firstmate
  4. 4

    Claude Code와 같은 지원되는 하네스를 실행합니다. 이후에는 AGENTS.md가 이어서 처리합니다

    claude

사용 전 알아둘 점

  • 독립 실행형 앱이 아닙니다. Claude Code, Grok, Pi와 같은 지원되는 코딩 에이전트 하네스 안에서 실행됩니다.
  • 인증된 GitHub CLI와 tmux 또는 다른 지원되는 세션 백엔드가 필요합니다.
  • Zellij, cmux, T3 Code와 같은 일부 백엔드와 기능은 실험용으로 표시되어 있습니다.

포함된 컬렉션

코딩 에이전트 병렬 실행 도구멀티 에이전트 오케스트레이션 프레임워크Claude Code 도구·스킬·플러그인오픈소스 AI 에이전트 프레임워크와 앱AI 코딩 어시스턴트와 에이전트

토픽

#ai-agents#coding-agent#git-worktree#tmux#multi-agent#developer-workflow#claude-code#automation

자주 묻는 질문

firstmate은(는) 무엇인가요?
코딩 에이전트 팀을 운영하기 위한 에이전트 배포판으로, 하나의 퍼스트메이트와 대화하면 격리된 Git worktree와 tmux 스타일 세션에서 작업을 병렬로 진행합니다. firstmate는 범용 터미널 코딩 에이전트를 에이전트 팀의 코디네이터로 바꿔 주는 지침, 스킬, 보조 스크립트 모음입니다. 설치할 앱은 없습니다. 저장소를 clone한 뒤 Claude Code, Grok, Pi, Codex, OpenCode 같은 지원 하네스를 저장소 안에서 실행하면 해당 세션이 퍼스트메이트가 됩니다. 채팅으로 작업을 설명하면 퍼스트메이트가 자율적으로 작업하는 크루메이트를 생성합니다. 각 크루메이트는 확인할 수 있는 별도 세션과 깨끗한 Git worktree에서 작업하고, PR이나 승인된 로컬 병합 또는 조사 보고서를 내놓을 때까지 감독을 받습니다.
firstmate은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
firstmate은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
firstmate은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. firstmate의 마지막 커밋은 2026년 11월 6일입니다.
firstmate은(는) 어디에 사용할 수 있나요?
여러 저장소에서 버그 수정이나 기능 작업을 동시에 여러 개 진행하기. 코드베이스 조사나 감사를 에이전트에 맡기고 서면 보고서를 받기. 터미널을 오가며 관리하지 않고 하나의 채팅 세션에서 코딩 에이전트들을 지휘하기. 서로 다른 머신에서 실행되는 상주형 세컨드메이트에 대규모 작업을 분담하기.
firstmate는 어떻게 설치하나요?
GitHub CLI를 인증합니다: gh auth login firstmate 저장소를 클론합니다: git clone https://github.com/kunchenguid/firstmate 클론한 디렉터리로 이동합니다: cd firstmate Claude Code와 같은 지원되는 하네스를 실행합니다. 이후에는 AGENTS.md가 이어서 처리합니다: claude
firstmate은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/kunchenguid/firstmate

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트