프로젝트 소개

Agent Fleet은 AI 코딩 에이전트를 플릿(fleet) 형태로 실행하기 위한 셀프 호스팅 콘솔입니다. 이 서비스의 핵심은 노트북을 닫아도 에이전트가 계속 작동한다는 점입니다. 팀원들이 하나의 브라우저 콘솔에서 에이전트를 공유하며, 터미널 앞에 앉아 있을 필요 없이 Discord, Slack 또는 휴대폰을 통해 진행 상황을 확인하거나 다음 지침을 보낼 수 있습니다. README에 명시된 지원 에이전트 CLI는 Claude Code, Codex CLI, GitHub Copilot CLI, Antigravity CLI, Cursor CLI, Kiro 및 OpenCode입니다. 각 팀원은 격리된 사용자별 환경(cgroup CPU 및 메모리 할당량이 적용된 Docker 컨테이너 또는 Docker가 없는 네이티브 에디션의 bubblewrap 샌드박스)을 가지며, 여기에는 영구 홈 디렉토리와 자체 git 작업 복사본이 포함됩니다. 세션은 브라우저에서 시작, 추적 및 제어됩니다. 셀프 호스팅 방식이므로 기업은 자체 인프라에 배포를 실행하여 자격 증명, 소스 코드 및 대화 내용을 조직 내부로 유지할 수 있습니다. 동일한 코어가 Docker Compose를 사용하는 단일 Linux 호스트와 AWS ECS 모두에서 실행됩니다. 저장소에 설명된 콘솔 기능은 다음과 같습니다: - 에이전트 CLI, 모델, 추론 노력(reasoning effort), 시작 모드, 그리고 새로운 git worktree 또는 기존 작업 복사본 실행 여부를 선택하는 실행 대화 상자. - 에이전트의 질문, 계획 및 권한 요청이 카드로 표시되어 즉시 응답할 수 있는 채팅 미러. - 분할 창: 채팅 미러, PTY를 통해 셸 세션에 연결된 라이브 터미널, 작업 트리 변경 사항을 나란히 배치하며, 각 창은 별도의 탭으로 분리할 수 있습니다. - 콘솔 내 Git 도구: 선택한 커밋의 diff 옆에 커밋 그래프 표시, 작업 복사본 및 worktree별 스테이징 및 커밋 기능. - 사용량 탭: 24시간/7일/30일 단위의 기능별 누적 토큰 차트, 토큰, 호출, 캐시 읽기, API 환산 비용 및 미측정 호출에 대한 KPI 타일, 기능/에이전트/모델별 세부 내역 제공. 토큰이 보고되지 않은 호출은 0이 아닌 별도로 집계됩니다. 인터페이스는 영어와 일본어로 제공되며 설정에서 사용자별로 전환할 수 있습니다. 두 언어 모두 스크린샷이 제공됩니다. 배포 옵션은 20분 내에 결정할 수 있도록 문서화되어 있습니다: compose(기본값, 단일 Linux 호스트의 Docker 팀), native(Docker 없음, 단일 사용자, 예: WSL2 또는 개인 Linux 박스), ecs / ecs-ec2(태스크 수준 격리가 적용된 AWS), ec2-single(AWS, 소규모 팀, 단일 VM의 Compose). 릴리스 번들은 GHCR에서 고정된 이미지를 가져와 별도의 배포 저장소에 게시하며, 명령 절차는 해당 운영 위치(deploy/compose, deploy/native, deploy/aws/ecs)에 함께 있습니다. 트리에서 빌드하려면 .env.example을 복사하고 AF_MASTER_KEY와 같은 비밀 키를 생성하며, 사용자별 워크스페이스 이미지를 빌드하고 docker compose를 실행해야 합니다. Caddy는 Let's Encrypt를 통해 TLS를 처리하며, 로그인은 제어 평면 자체의 OAuth를 사용합니다. 문서는 독자에 따라 나뉩니다: guide/는 방법론을 설명하며 모든 워크스페이스 컨테이너에 포함되어 콘솔의 "User guide" 항목에서 열 수 있습니다. docs/는 코드의 작동 방식과 이유를 설명합니다. 소스는 workspace/(에이전트 및 이미지), control-plane/, console/로 구성되며, 로컬 개발 스택은 deploy/local/run-dev.sh를 통해 시작됩니다(local = Docker, wsl, native, reset). README는 용어도 정의합니다: Workspace는 홈 볼륨과 실행 프로세스를 가진 한 사용자의 영구 컨테이너 환경이며, Working copy는 Workspace 내에 클론된 git 저장소의 작업 디렉토리입니다. Session은 대화, 설정 및 실행 상태의 논리적 단위로 작업 복사본에 연결됩니다. 세션이 반드시 터미널을 의미하지는 않습니다. Codex, OpenCode, Copilot, Cursor 및 Kiro는 채팅 뷰에서 구동되는 관리형 실행 방식이 기본값인 반면(Codex와 OpenCode는 세션별 CLI 프로세스 없이 공유 런타임에서 실행), Claude, Antigravity 및 일반 셸/SSM 세션은 터미널을 사용합니다. 이 프로젝트는 Apache License 2.0 하에 라이선스가 부여되었으며, README에서는 각 기업이 암호화 및 격리 구현을 감사할 수 있도록 자격 증명 처리 도구의 소스를 공개하는 것이 이 프로젝트의 강점 중 하나라고 언급합니다. 기여 안내는 CONTRIBUTING.md에, 취약점 보고 및 위협 모델은 SECURITY.md에 기재되어 있습니다.