Installation

Prerequisites

  • tmux (required)
  • Docker (optional, for sandboxing agents in containers)
  • Node.js (optional, only needed when building the web dashboard from source with --features serve)

Install Agent of Empires

Run the install script:

curl -fsSL \
  https://raw.githubusercontent.com/njbrake/agent-of-empires/main/scripts/install.sh \
  | bash

Homebrew

brew install aoe

Build from Source

git clone https://github.com/njbrake/agent-of-empires
cd agent-of-empires
cargo build --release

The binary will be at target/release/aoe.

To include the web dashboard (browser access):

cargo build --release --features serve

This requires Node.js and npm. The web frontend is built automatically during compilation.

Verify Installation

aoe --version

Uninstall

To remove Agent of Empires:

aoe uninstall

This will guide you through removing the binary, configuration, and tmux settings.