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

Updating

aoe update

The aoe update command detects how aoe was installed (Homebrew, the curl install script, Nix, or Cargo) and dispatches to the right upgrade mechanism. For Nix and Cargo it prints the manual upgrade command instead of attempting an automatic update, since those cases need external tooling.

Inside the TUI, press u when the update bar is visible to run the same flow without leaving the app. Press Ctrl+x to dismiss the bar for the current session.

Uninstall

To remove Agent of Empires:

aoe uninstall

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