agent-of-empires/agent-of-empires

Agent of Empires (AoE) – 빠른 개요

정의: Linux 또는 macOS에서 AI 코딩 에이전트를 실행, 모니터링, 제어할 수 있는 경량 세션 관리자입니다. 각 에이전트는 자체 영구 tmux 세션에서 실행되므로 터미널을 닫거나 SSH 연결이 끊겨도 작업이 계속 실행됩니다.

중요한 이유: 여러 LLM 기반 코딩 어시스턴트(Claude, GPT-4 등)를 실험할 때 종종 별도의 환경, git worktree, 또는 컨테이너 샌드박스가 필요합니다. AoE는 깔끔한 TUI, 웹 대시보드(데스크톱 + 모바일), CLI, HTTP API로 이를 모두 통합합니다.

---

핵심 기능

기능	설명
다중 인터페이스	TUI, 웹 UI, CLI, HTTP API – 워크플로에 맞는 것을 선택하세요.
영구 세션	에이전트는 tmux 내에서 실행되며 터미널 종료, SSH 끊김, 또는 충돌에도 생존합니다.
Git worktree 및 다중 저장소 지원	에이전트별로 별도의 worktree를 관리하여 브랜치별 작업을 쉽게 합니다.
컨테이너 샌드박싱	Docker, Podman, 또는 Apple Containers를 통한 선택적 격리.
구조화된 뷰 및 diff 리뷰어	에이전트 출력, 파일 diff, 상태를 깔끔한 UI로 확인; 모바일 친화적 뷰.
사용자 지정 명령 및 훅	반복 가능한 설정을 위해 에이전트별 명령, 저장소 훅, 프로필 정의.
알림 및 상태 감지	에이전트가 작업을 완료하거나 오류가 발생할 때 실시간 피드백.

---

작동 방식

1. AoE는 추가하는 각 AI 에이전트에 대해 tmux 세션을 생성합니다.
2. 세션은 지정한 명령(예: Claude Code의 경우 claude)을 실행합니다.
3. AoE는 세션을 추적하고 TUI, 웹 UI, 또는 API를 통해 상태를 노출합니다.
4. 상태를 잃지 않고 분리(Ctrl+b d) 후 다시 연결할 수 있습니다.
5. 선택적 샌드박싱은 세션을 Docker/Podman/Apple Container 내에서 실행하여 호스트를 깨끗하게 유지합니다.

---

시작하기

# 설치 (tmux 필요, Docker 선택 사항)
brew install aoe                     # macOS Homebrew
# 또는
curl -fsSL https://raw.githubusercontent.com/agent-of-empires/agent-of-empires/main/scripts/install.sh | bash

# TUI 실행
 aoe

# 코딩 에이전트 추가 (Claude Code 예시)
aoe add --cmd claude

# 웹 대시보드 시작 (모든 브라우저에서 접근)
aoe serve

전체 문서: 빠른 시작, CLI 참조, API 문서는 README에서 연결됩니다.

---

AoE 사용 시기

• 다중 에이전트: 각각 고유한 git 컨텍스트를 가진 여러 LLM 기반 코더를 나란히 실행.
• 장기 실행 작업: SSH 세션 또는 터미널 충돌에도 에이전트 유지.
• 격리 필요: 호스트를 오염시키지 않고 컨테이너에서 코드 테스트.
• 팀 가시성: 웹 대시보드를 공유하여 협업자가 노트북이나 휴대폰에서 진행 상황을 볼 수 있게 함.

---

제한 사항

• Linux/macOS에서만 작동 (Windows는 WSL2 통해).
• tmux에 의존; 기본 Windows 지원 없음.
• AI 도구 지원은 명령줄에서 호출할 수 있는 모든 것이며, AoE 자체는 모델을 제공하지 않습니다.

---

기여 및 커뮤니티

• Discord: 매주 화요일 오전 9시(ET) 라이브 오피스 아워.
• GitHub: 로드맵을 팔로우하고, 이슈를 열고, CONTRIBUTING.md 지침에 따라 PR을 제출하세요.
• 라이선스: MIT(소량의 Apache-2.0 구성 요소 포함).

---

결론: Agent of Empires는 AI 코딩 에이전트를 위한 실용적인 오픈소스 오케스트레이터로, tmux를 재발명하지 않고도 영구적이고 샌드박스 처리되며 관찰 가능한 세션을 제공합니다.