agent-of-empires/agent-of-empires

What it solves

Agent of Empires (AoE) solves the difficulty of managing multiple AI coding agents simultaneously. It prevents the loss of agent progress when terminals crash or SSH connections drop, and provides a structured way to run agents in parallel across different Git branches or in isolated environments to prevent them from messing up your main codebase.

How it works

AoE acts as a session manager that wraps AI agents in persistent tmux sessions. This ensures that agents continue running in the background even if the user disconnects. It adds a layer of management on top of tmux, providing a TUI (Terminal User Interface), a web dashboard, and an HTTP API to monitor agent status (such as whether they are running, waiting, or idle) and review diffs.

Who it’s for

Developers who use AI coding agents (like Claude Code) and want to run multiple agents in parallel, monitor them from different devices (including mobile phones via the web dashboard), and ensure their work is sandboxed via Docker, Podman, or Apple Containers.

Highlights

• Persistent Sessions: Uses tmux to keep agents running regardless of terminal state.
• Multi-Surface Management: Control agents via TUI, web dashboard, CLI, and HTTP API.
• Coded Isolation: Supports Git worktrees for branch-specific work and container sandboxing (Docker, Podman, Apple Containers).
• Agent-Aware Status: Detects if agents are running, idle, or in an error state.
• Remote Access: Allows monitoring and interaction via a browser on desktop or mobile.