mrkeyoor.com_
Mon 02 Nov 01:14 UTC
AI Toolsevaluationupdated 31 Oct 2026

agent-of-empires review

Use Agent of Empires when you need agent status, worktrees and browser access around persistent coding-agent sessions on Linux or macOS. Agent of Empires runs each agent in its own tmux session. Our run on 2026-09-28 at commit e019ffd completed installation and a development build, but tests timed out; it does not establish that an interactive agent workflow works.

+15stars / 7d
Verdict

Agent of Empires is worth evaluating when you need management features around several persistent coding-agent sessions. Our dated sandbox run supports installation and development-build success, with an unfinished test run and no interactive validation. Begin with a disposable repository, verify session identity and reconnection, then decide whether its dashboard adds enough to your existing tmux workflow.

We ran it

Lab card: what happened when we ran agent-of-empiresScreenshot of agent-of-empires (www.agent-of-empires.com)
Install✓ · 42s493 packages
Build✓ · 490s
Tests✗ timed out · 900sran, no count parsed
Repo1790 files~522,938 lines of source · 28.6 MB · 15 CI workflows · tests dir

Answers from our run

Does agent-of-empires build from source?

Dependencies installed in 42 seconds (493 packages), and the build succeeded in 490 seconds. We cloned commit e019ffd into a clean Debian container with 3 CPUs and no project-specific setup.

Do agent-of-empires's tests pass?

We could not finish them: the suite was still running after 15 minutes in our container.

Who should not use agent-of-empires?

Readers seeking a coding agent or model: this is a session manager around separately launched tools.

What are the alternatives to agent-of-empires?

tmux, cmux. Agent of Empires is worth evaluating when you need management features around several persistent coding-agent sessions.

Setup3/5Installation and development compilation completed in our sandbox, but tmux setup and interactive agent operation were not verified.
Docs3/5The matching README covers prerequisites, persistence, platform limits and starting commands; linked guides were not supplied in full.
CommunityN/AThe supplied extracts do not establish sustained maintenance, support response times or independently measured adoption.
Maturity2/5The development build completed, but tests timed out and session recovery was not exercised. This rating reflects limited verification.

Discussed on

  1. hnShow HN: Agent-of-empires: OpenCode and Claude Code session manager118 points
  2. hnShow HN: Agent-of-empires: opencode & claudecode session manager8 points
  3. hnShow HN: I've implemented multi-repo workspace support in Agent of Empires6 points
  4. hnShow HN: Version 1.0 of agent-of-empires CLI agent orchestration tool3 points

Who it’s for

Developers supervising several coding-agent sessions across branches or repositories.
Linux and macOS users who want a dashboard around persistent tmux sessions.
Developers who need browser access and a diff viewer alongside their agents.

Who it’s NOT for

Readers seeking a coding agent or model: this is a session manager around separately launched tools.
Native Windows workflows: the project documents Windows support only through WSL2.
Anyone requiring a completed test run or verified interactive workflow before adoption: our recorded sandbox run establishes neither.
Users whose existing tmux sessions already provide enough organization.

Setup reality

Our run on 2026-09-28 used commit e019ffd in our lab-rust:1 sandbox with 3 CPUs and 12 GB of memory. The harness recorded installation success in 42 seconds, build success in 490 seconds, and a test timeout after 900 seconds with exit code 124. The build tail identifies the dev profile as unoptimized with debug information; this was not a verified release build.

The matching README requires tmux and lists Docker as optional for sandboxing. Our command outcomes do not demonstrate agent authentication, interactive attachment, browser operation, container isolation or recovery. The attached record has no aggregate test counts and no audit result.

Should you add Agent of Empires to your workflow?

Choose Agent of Empires if persistent sessions alone leave you needing agent status, worktree management, browser access and diff review. Keep plain tmux if persistence and manual session switching cover your needs. The distinction is documented in the README at our tested commit, rather than established by an interactive comparison in our sandbox.

Agent of Empires runs each agent in its own tmux session. Its README says those sessions keep running when the TUI closes or SSH disconnects. AoE adds a management interface around them; you still need the coding tools you intend to launch.

What our sandbox established

Our run on 2026-09-28 used commit e019ffd, whose full hash is e019ffd5f445bc44e2c211d79e7c9349303b8efa. Installation completed in 42 seconds, and the build completed in 490 seconds. Tests timed out after 900 seconds with exit code 124.

These are observations from our sandbox, configured with 3 CPUs, 12 GB of memory and image lab-rust:1. Our harness records each step's success flag, elapsed time, exit code, timeout flag and retained log tail. The build tail names agent-of-empires v1.17.2 and ends with a completed dev profile, explicitly described as unoptimized with debug information. Build success here means compilation completed; it does not establish that a deployed CLI or agent workload worked.

The retained test tail contains individual passing entries but no completed suite footer. The attached aggregate test-count field is null. We therefore cannot give a passing total, failure total or pass rate, or identify why the run exceeded its limit. The timeout is an unfinished run, not evidence that every remaining test failed. Recorded parser summaries, where available, would still require complete-log reconciliation before establishing exhaustive unique coverage.

We did not verify interactive agent sessions, credentials, browser access, mobile access, container boundaries or recovery. The record contains no audit result, so advisory totals and scan coverage are unknown. This correction uses the existing stored run; no new execution took place. The MrKeyoor testing-methodology page explains command outcomes and their limits, but its current text does not establish which methodology revision governed this September run.

Setup begins with tmux

The matching README requires tmux on Linux or macOS and documents Windows only through WSL2. It lists installation through a script, Homebrew, Nix or a source build. Docker is optional for sandboxing; the feature list also names Podman and Apple Containers.

Worktrees and containers address different decisions. Worktrees give concurrent tasks separate checkouts. Choosing container sandboxing adds a separate runtime boundary whose configuration still needs review. Our successful build validates neither isolation nor the behavior of a particular agent inside it.

Start with a disposable repository and one agent. Check attachment, status changes, diffs and reconnection before adding parallel sessions or remote access. This is a suggested evaluation sequence, not a workflow we completed in the recorded run.

Recovery reports need their dates and status

Issue 3516 describes conversation cross-assignment during recovery when several sessions share a working directory and capture relies on the newest matching transcript. The supplied issue page records closure as completed on 2026-09-04 through pull request 3678.

That makes the report useful historical context, rather than evidence that the issue remains open at our later tested commit. Closure also does not prove that our sandbox exercised the fix or that every recovery scenario works. If recovery matters to your workflow, verify that each resumed pane opens its intended conversation.

When another tool fits better

Plain tmux supports detaching sessions and reattaching them later. Choose it when you want that persistence and can organize agents yourself. It is also AoE's underlying dependency, so it can complement AoE as a direct attachment path.

cmux is a native macOS terminal with tabs, notifications and an embedded browser. Consider it when you want the terminal application itself to organize your workspaces. Its documentation distinguishes restored application state and agent resume commands from keeping arbitrary processes alive; it offers tmux integration for live detach and reattach. It can therefore complement a tmux workflow rather than replace its persistence layer.

How to read our scores

These are editorial assessments, not measurements or adoption rankings. For setup, documentation and maturity, 1 means the supplied evidence shows a blocking gap, 2 means substantial limits remain, 3 means a usable baseline with explicit qualifications, 4 requires broader verified coverage, and 5 requires thorough verification within the stated scope. Documentation scores reflect only material actually supplied. Community remains unassessed because the extracts do not establish response times, sustained maintenance or adoption.

Setup receives 3 because installation and compilation completed but runtime prerequisites and interactive operation remain unverified. Documentation receives 3 because the matching README explains prerequisites, persistence, platform limits and entry points, while the linked guides were not supplied in full. Maturity receives 2 because our test command did not finish and recovery was not exercised; this describes the limits of this assessment, not a finding that the software is generally unreliable.

Alternatives

ProjectWhat it isPick it when
tmux gh↗A terminal multiplexer with detachable sessions.Choose plain tmux when persistence and manual session management are sufficient. It also remains a complement and dependency when using AoE.
cmux gh↗A native macOS terminal with workspace tabs, notifications and an embedded browser.Consider cmux when you want a desktop terminal workspace on macOS. Check its resume and tmux integration behavior separately if live process persistence is essential.

Sources

  1. Agent of Empires README
  2. Agent of Empires 1.15.0 release
  3. Cross-assigned conversation issue 3516
  4. CJK session-title regression 3536
  5. macOS signing issue 2643
  6. Web terminal scroll issue 3322

More ai tools reviews

kornia · skills · anarlog · pr-agent · agent-sprite-forge · KiroCrew · the whole board →