agent-of-empires/agent-of-empires

해결하는 문제

Agent of Empires (AoE)는 여러 AI 코딩 에이전트를 동시에 관리하는 어려움을 해결합니다. 터미널 충돌이나 SSH 연결 끊김 시 에이전트 진행 상황이 손실되는 것을 방지하고, 서로 다른 Git 브랜치 또는 격리된 환경에서 에이전트를 병렬로 실행하여 기본 코드베이스가 엉망이 되는 것을 방지하는 구조화된 방법을 제공합니다.

작동 방식

AoE는 세션 관리자 역할을 하며 AI 에이전트를 영구적인 tmux 세션으로 래핑합니다. 이를 통해 사용자가 연결을 끊더라도 에이전트가 백그라운드에서 계속 실행되도록 보장합니다. tmux 위에 관리 계층을 추가하여 TUI(터미널 사용자 인터페이스), 웹 대시보드 및 HTTP API를 제공하고 에이전트 상태(실행 중, 대기 중, 유휴 상태 등)를 모니터링하고 diff를 검토할 수 있습니다.

대상 독자

AI 코딩 에이전트(예: Claude Code)를 사용하고 여러 에이전트를 병렬로 실행하며, 다양한 기기(웹 대시보드를 통한 휴대폰 포함)에서 이를 모니터링하고, Docker, Podman 또는 Apple Containers를 통해 작업이 샌드박스 처리되도록 보장하려는 개발자.

주요 기능

• 영구 세션: tmux를 사용하여 터미널 상태와 관계없이 에이전트가 계속 실행되도록 합니다.
• 다중 인터페이스 관리: TUI, 웹 대시보드, CLI 및 HTTP API를 통해 에이전트를 제어합니다.
• 코드 격리: 브랜치별 작업을 위한 Git worktrees 및 컨테이너 샌드박싱(Docker, Podman, Apple Containers)을 지원합니다.
• 에이전트 인식 상태: 에이전트가 실행 중, 유휴 상태 또는 오류 상태인지 감지합니다.
• 원격 액세스: 데스크톱 또는 모바일의 브라우저를 통해 모니터링 및 상호 작용을 허용합니다.