BranchOS은(는) 무엇을 하나요?
에이전트 작업을 위한 아키텍처 우선 가상 작업 분기 시스템
개요
BranchOS는 AI 에이전트가 복잡한 작업을 구조화된 가상 분기(Branch)로 분할하여 효율적으로 관리할 수 있도록 도와줍니다. 각 분기는 독립적인 작업 컨텍스트를 가지며, 필요에 따라 전환, 병합, 재개가 가능합니다.
주요 기능
- 분기 생성 및 관리:
branch create <name>명령어로 새 분기를 생성합니다. - 분기 전환:
branch switch <name>명령어로 현재 작업 분기를 전환합니다. - 분기 병합:
branch merge <target>명령어로 완료된 분기를 다른 분기에 병합합니다. - 분기 상태 확인:
branch status명령어로 현재 분기와 전체 분기 트리를 확인합니다. - 분기 목록 보기:
branch list명령어로 모든 분기와 그 상태를 조회합니다.
사용법
BranchOS는 CLI 명령어를 통해 사용됩니다. 모든 명령어는 branch 접두사로 시작합니다.
# 새 분기 생성
branch create feature/new-auth
# 분기 전환
branch switch feature/new-auth
# 현재 분기 상태 확인
branch status
# 분기 병합
branch merge main
# 분기 목록
branch list
아키텍처
BranchOS는 다음과 같은 계층 구조를 따릅니다:
- 루트 분기 (main): 기본 작업 분기입니다.
- 서브 분기 (sub-branch): 루트 분기에서 파생된 하위 작업 분기입니다.
- 태스크 분기 (task-branch): 특정 태스크를 위한 세부 분기입니다.
각 분기는 자체 컨텍스트 파일을 유지하며, 전환 시 에이전트의 맥락이 자동으로 복원됩니다.
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 기타 AI 에이전트 플랫폼
환경 변수
| 변수 | 설명 | 기본값 |
|---|---|---|
BRANCHOS_ROOT | 분기 데이터 저장 경로 | ~/.branchos |
BRANCHOS_CURRENT | 현재 활성 분기 이름 | main |
예제
다음은 BranchOS를 사용한 일반적인 워크플로우입니다:
- 메인 분기에서 시작합니다.
branch create feature/add-login으로 새 기능 분기를 생성합니다.- 분기에서 작업을 수행합니다.
- 완료 후
branch switch main으로 메인으로 전환합니다. branch merge feature/add-login으로 변경 사항을 병합합니다.
참고 사항
- 분기 이름은 고유해야 합니다.
- 병합 전에 충돌을 확인하는 것이 좋습니다.
- 분기 데이터는 로컬에 저장되며, 필요 시 공유 저장소와 동기화할 수 있습니다.
라이선스
MIT