프로젝트 소개

Agent Factory(`af`)는 AI 코딩 에이전트의 플릿을 동시에 실행하기 위한 도구로, 격리된 작업 공간과 통일된 제어 평면을 제공합니다. Claude Code, Codex, Aider, Gemini, Amp, opencode, Devin 등 다양한 에이전트를 지원합니다. 각 에이전트는 자체 git 브랜치와 git 작업 트리에서 작동하여 병렬 에이전트가 체크아웃을 공유하지 않고, 결과가 표준 git 브랜치로 반환되어 쉽게 검토하고 병합할 수 있습니다. 이 시스템은 상태를 유지하고, 클라이언트 창이 닫혀도 세션을 활성 상태로 유지하며, 반복 작업을 예약하고, 웹 클라이언트를 제공하는 백그라운드 데몬에 의해 구동됩니다. 사용자는 동일한 데몬 상태에 연결된 세 가지 주요 표면을 통해 Agent Factory와 상호 작용할 수 있습니다: 1. **웹 클라이언트**: 기본적으로 `http://localhost:8443`에서 접근 가능하며, 세션 관리, 실제 터미널 보기, 작업 처리, 설정 구성 등을 위한 브라우저 기반 인터페이스를 제공합니다. 2. **터미널 UI(TUI)**: git 저장소 내에서 `af` 명령을 통해 실행되며, 세션 관리를 위한 밀도 높은 인터페이스를 제공하고, 에이전트 터미널에 직접 상호 작용하고 전체 화면으로 연결할 수 있습니다. 3. **CLI**: `af sessions` 및 `af tasks`와 같은 명령에 대해 JSON 출력을 제공하여, 스크립팅 및 다른 자동화 도구와의 통합을 통해 세션을 생성, 프롬프트, 감시, 아카이브할 수 있습니다. 핵심 개념은 다음과 같습니다: - **세션**: 특정 작업을 수행하는 개별 에이전트로, 자체 수명 주기를 갖습니다. - **작업 트리**: 충돌을 방지하기 위해 각 세션에 대해 격리된 체크아웃 및 브랜치입니다. - **데몬**: 상태를 관리하고 클라이언트를 제공하는 백그라운드 프로세스입니다. - **작업**: cron을 통해 예약되거나 감시 명령에 의해 트리거되는 프롬프트입니다. - **계정**: 다양한 로그인을 관리하기 위한 에이전트의 명명된 자격 증명 홈입니다. 설치에는 Linux, macOS, 또는 WSL2에서 tmux, git, 그리고 최소 하나의 지원되는 에이전트 CLI가 필요합니다. 쉘 스크립트를 통해 설치하거나 Go로 소스에서 빌드할 수 있습니다. 이 도구는 또한 컨테이너에서 세션을 실행하거나 SSH를 통해 원격 머신에서 실행하는 것을 지원합니다.