starfleetctl

같은 코드베이스에서 작업 중인 선박 세션을 조율하는 하나의 바이너리.

starfleetctl은 동시 선박 세션을 관리합니다 — 상태 하트비트, 세션 간 지시, PR 브랜치 잠금, GitHub PR 접근 — 여러 선박이 서로 방해하지 않고 병행 작업할 수 있도록 합니다.

왜 필요할까?

여러 선박이 하나의 저장소를 공유할 때, 다음이 필요합니다:

• 상태 보드 — 누가 무엇을 작업 중인지, 누가 대기 중인지, 누가 막혀 있는지
• 메시지 버스 — 선박들이 서로에게 작업이나 질문을 보낼 수 있음
• PR 잠금 — 두 선박이 같은 브랜치를 편집하지 않도록 방지
• 안전한 커밋 — 동시 세션이 같은 작업 트리를 경쟁하지 않도록 함
• GitHub 통합 — jq/sed 없이 PR을 보고, 댓글 달고, 라벨 지정 가능

starfleetctl은 이러한 모든 기능을 타사 의존성 없이 하나의 Go 바이너리로 제공합니다.

빠른 시작

make all은 추가로 vet, fmt, 단위 테스트, 오픈코드 플러그인의 정적 빌드 테스트(check-plugin — esbuild 번들 체크 및 tsc --noEmit; 두 단계 모두 도구 체인이 설치되지 않은 경우 안전하게 생략)를 실행합니다.

문서

문서	설명
사용자 가이드	여기에서 시작 — 설치, 개념, 워크플로우, 문제 해결
아키텍처	작동 방식 — 데이터 흐름, 파일 형식, 잠금
통신	선박 간 통신 참조
대시보드	프로젝트 상태 추적
PR 클레임	PR 브랜치 잠금
세션	에이전트 세션 관리 (termctl)
GitHub	PR 보기,

---

🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.