himkt/cafleet

cafleet은(는) 무엇을 하나요?

🛰️ 에이전트 팀을 협업 코딩을 위해 재창조한 도구로, Claude Code와 Codex를 지원하며 완전한 코드 투명성을 제공합니다.

개요

cafleet은 여러 AI 코딩 에이전트(Claude Code, Codex)를 하나의 팀으로 구성하여 대규모 코드베이스에서 협업할 수 있게 해줍니다. 각 에이전트의 작업 내역과 코드 변경 사항이 완전히 투명하게 공개되어, 팀 리더가 전체 진행 상황을 쉽게 파악할 수 있습니다.

주요 기능

• 에이전트 팀 구성: 여러 에이전트 인스턴스를 동시에 실행하여 작업 분담
• 코드 투명성: 모든 코드 변경 사항과 에이전트 간 통신 기록이 투명하게 공개
• 다중 플랫폼 지원: Claude Code와 Codex 모두에서 동작
• 간편한 설정: 최소한의 설정으로 빠르게 시작 가능

설치 방법

# cafleet 설치
pip install cafleet

# 또는 GitHub에서 직접 설치
pip install git+https://github.com/himkt/cafleet.git

사용 방법

1. 프로젝트 디렉토리에서 cafleet 초기화:

   cafleet init
   

2. 에이전트 팀 구성 파일 편집 (cafleet.yaml):

   agents:
     - name: agent-1
       platform: claude-code
       role: architect
     - name: agent-2
       platform: codex
       role: implementer
   

3. 팀 실행:

   cafleet run
   

설정 옵션

옵션	설명	기본값
agents	에이전트 목록	필수
shared_context	공유 컨텍스트 크기	4096
log_level	로그 레벨	info

환경 변수

• CAFLEET_HOME: cafleet 설정 디렉토리 (기본값: ~/.cafleet)
• CLAUDE_CODE_API_KEY: Claude Code API 키 (Claude Code 사용 시 필요)
• CODEX_API_KEY: Codex API 키 (Codex 사용 시 필요)

예제

프로젝트 구조:

my-project/
├── src/
├── tests/
├── cafleet.yaml
└── README.md

cafleet.yaml 예시:

agents:
  - name: refactor-agent
    platform: claude-code
    role: refactor
    context_prompt: "리팩토링할 모듈의 기존 코드를 분석하고 개선 방법을 제안하세요."
  - name: test-agent
    platform: codex
    role: tester
    context_prompt: "리팩토링된 코드에 대한 단위 테스트를 작성하세요."

실행 명령어:

cafleet run --config cafleet.yaml

라이선스

MIT License

기여

버그 리포트, 기능 제안, 풀 리퀘스트는 GitHub 저장소에서 환영합니다.