What is Agent of Empires?
Agent of Empires is an open-source session manager for developers running AI coding agents on Linux and macOS. Agent of Empires organizes parallel agents across branches and provides terminal and browser interfaces for monitoring their work. Each agent has a persistent session, with optional Git worktree and container isolation. The repository states that Mozilla.ai supports the project and that agent-deck inspired the project.
What Agent of Empires can do
Agent of Empires adds agent-aware management around tmux sessions rather than replacing the underlying session system. Supported coding tools include Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, and Factory Droid Coding. Agent of Empires combines session monitoring, repository organization, and review interfaces so developers can manage agents through a terminal, a browser, command-line commands, or an HTTP API.
- Agent of Empires detects agent status and provides notifications.
- Agent of Empires manages Git worktrees and multi-repository workspaces.
- Agent of Empires supports Docker, Podman, and Apple Containers sandboxing.
- Agent of Empires provides diff review, profiles, and repository hooks.
- Agent of Empires supports custom agent commands.
- Agent of Empires offers structured mobile views and desktop terminal access.
How Agent of Empires works
Agent of Empires runs each agent in a separate tmux session that continues after the terminal interface closes, an SSH connection disconnects, or the terminal crashes. Reopening Agent of Empires restores access to those sessions, which remain until deleted. The documented workflow uses aoe to launch the terminal interface, aoe add --cmd claude to create a Claude Code session, and aoe serve to start the web dashboard.
Who Agent of Empires is for
Agent of Empires is for developers who work with multiple AI coding agents and need to switch between terminal and browser monitoring. Linux and macOS users can manage parallel work across branches, while remote users can reconnect over SSH without losing running sessions. Desktop browser access includes a dashboard, terminal, and diffs; phone access provides a structured view for checking agent work away from a desktop.
- Agent of Empires supports parallel coding work across branches.
- Agent of Empires enables browser-based monitoring from a phone.
- Agent of Empires keeps remote agent sessions available across SSH disconnects.
- Agent of Empires supports reviewing changes through a diff viewer.
Agent of Empires licensing and installation
Agent of Empires is available as an open-source project under the MIT License rather than a stated subscription plan. Installation options include Homebrew and a shell installation script, with Nix and source builds covered in the installation documentation. Agent of Empires requires tmux on Linux or macOS, while Docker is optional for sandboxing. The repository also identifies an Apache-licensed code exception in its third-party notices.
Agent of Empires strengths and limitations
Agent of Empires combines persistent sessions with agent status detection, worktree management, container sandboxing, and browser-based review. Developers can still attach directly to any Agent of Empires session through tmux, retaining access to the underlying terminal workflow. Agent of Empires also provides CLI and HTTP API references alongside quick-start documentation. Setup remains dependent on the documented operating-system requirements and local tmux installation.
- Agent of Empires requires tmux for session management.
- Agent of Empires runs on Linux and macOS.
- Agent of Empires supports Windows only through WSL2 because of tmux and POSIX process-handling dependencies.
Agent of Empires FAQ
What is Agent of Empires?
Agent of Empires is an open-source session manager for AI coding agents on Linux and macOS. Agent of Empires runs agents in parallel across branches and provides terminal, browser, CLI, and HTTP API access, with persistent tmux sessions and optional worktree or container isolation.
Which coding agents does Agent of Empires support?
Agent of Empires supports Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, and Factory Droid Coding. Agent of Empires provides the aoe agents command to show the current supported-agent list and availability on the user's machine.
Does Agent of Empires keep agents running after the terminal closes?
Agent of Empires keeps agents running in background tmux sessions when the terminal interface closes, SSH disconnects, or the terminal crashes. Agent of Empires restores access when reopened, and sessions are removed only when the user deletes them.
Does Agent of Empires work on Windows?
Agent of Empires works on Windows only through WSL2 because Agent of Empires depends on tmux and POSIX process handling. Agent of Empires otherwise targets Linux and macOS, with tmux required and Docker optional for sandboxing.
Can Agent of Empires be accessed from a phone?
Agent of Empires provides browser access with a structured view for phones. Agent of Empires also offers a desktop browser dashboard with terminal and diff views, and the documented aoe serve command starts the web dashboard.
How is Agent of Empires licensed?
Agent of Empires is an open-source project distributed under the MIT License. Agent of Empires identifies an exception for src/tui/hyperlink.rs, which contains code derived from herdr under the Apache License 2.0, with details in the repository's third-party notices.
From the community
No reviews yet
Be the first to review this tool. What you write helps the next person choose.
