# Agent of Empires

Podium publishes this catalog and sells an agent development environment. Podium chooses the products, criteria, sources and wording, so treat these pages as vendor-authored research. Check important claims against the linked primary sources. The same evidence rules apply to Podium and its competitors, but they do not remove this conflict of interest.

Page: https://adecomparison.com/ade/agent-of-empires/
Website: https://www.agent-of-empires.com/
Research: covered

Method: https://adecomparison.com/method/

Rank by must-haves met, then preferences, then name. Read each finding's checked date. Findings stay published after their scheduled recheck. Checks over six months old may be outdated.

## agent-of-empires:ACC-01

Finding: aoe serve starts the released browser dashboard. The dashboard has structured phone-browser access. aoe provides terminal UI and product-owned CLI commands. Browser/CLI can create sessions, send prompts and inspect work; read-only remote mode limits interaction. No native phone application is built by this release.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/README.md
Locator: Overview; How it works; FAQ
Finding: AoE manages parallel persistent tmux sessions on Linux/macOS, with CLI/TUI/browser/API access, optional worktrees/containers, phone browser access and SSH reconnect. Windows is WSL2 only.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/cli/reference.md
Locator: aoe add; send; ps; agents; acp
Finding: CLI creates, lists, sends to, forks and removes sessions. Custom commands and ACP agent/model/effort selection are supported; named resume/fork examples include Claude, Codex, OpenCode and Pi.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/web-dashboard.md
Locator: Launch; access modes; security
Finding: The shipped dashboard drives sessions from a browser; tmux and persistent structured workers survive browser crashes. Remote access supports authenticated tunnel modes and read-only views.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/Cargo.toml
Locator: Cargo features and binary targets; release workflows; web client; repository build tree searched for ios/android app targets
Finding: The scoped Cargo application ships terminal/CLI and an embedded web dashboard. Release and client build targets contain no native iOS/Android app; phone access uses the responsive browser dashboard.
Retrieved: 2026-11-13

## agent-of-empires:ACC-02

Finding: Docs list Claude Code, OpenCode, Codex CLI, Gemini CLI, Cursor CLI, Pi and other agent CLIs as supported and auto-detected; CLI examples document Claude Code, OpenCode, Codex and Pi session/fork integrations. Custom agent commands and configured ACP adapters can be selected per session. Terminal agents use persistent tmux sessions while structured views use ACP workers. Agent of Empires v1.22.3 registers Antigravity with the agy executable, install command, permission flag and status detector.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08. Antigravity source pass: v1.22.3 (8d2921c4e2960038b98d29e52ed8742ab4d52c6e).

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.
Antigravity terminal launch is supported; the released session-resume table does not verify resume or fork for this agent.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/README.md
Locator: Overview; How it works; FAQ
Finding: AoE manages parallel persistent tmux sessions on Linux/macOS, with CLI/TUI/browser/API access, optional worktrees/containers, phone browser access and SSH reconnect. Windows is WSL2 only.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/cli/reference.md
Locator: aoe add; send; ps; agents; acp
Finding: CLI creates, lists, sends to, forks and removes sessions. Custom commands and ACP agent/model/effort selection are supported; named resume/fork examples include Claude, Codex, OpenCode and Pi.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/web-dashboard.md
Locator: Launch; access modes; security
Finding: The shipped dashboard drives sessions from a browser; tmux and persistent structured workers survive browser crashes. Remote access supports authenticated tunnel modes and read-only views.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8d2921c4e2960038b98d29e52ed8742ab4d52c6e/docs/index.md#L27-L29
Locator: docs/index.md lines 27-29 (Supported agents), release v1.22.3 commit 8d2921c
Finding: The supported-agent list names Claude Code, OpenCode, Mistral Vibe, Codex CLI, Gemini CLI, Antigravity CLI, Cursor CLI, Copilot CLI, Pi, Oh My Pi, Factory Droid, Hermes, Kiro CLI, Qwen Code, Kimi Code and Prime Agent, auto-detected when installed.
Retrieved: 2026-11-10

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8d2921c4e2960038b98d29e52ed8742ab4d52c6e/src/agents.rs#L923-L932
Locator: src/agents.rs lines 923-932, v1.22.3, commit 8d2921c4e2960038b98d29e52ed8742ab4d52c6e
Finding: Agent of Empires v1.22.3 registers Antigravity with the agy executable, install command, permission flag and status detector.
Retrieved: 2026-11-10

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8d2921c4e2960038b98d29e52ed8742ab4d52c6e/docs/guides/session-resume.md#L15-L25
Locator: docs/guides/session-resume.md lines 15-25, v1.22.3, commit 8d2921c4e2960038b98d29e52ed8742ab4d52c6e
Finding: Agent of Empires v1.22.3 registers Antigravity with the agy executable, install command, permission flag and status detector.
Retrieved: 2026-11-10

## agent-of-empires:ACC-03

Finding: Agent credentials and native stores remain harness-specific. Claude sandbox refresh credentials are shared, while history stores are separate. Managed Codex resume/fork requires an API-key route; ChatGPT login is explicitly refused for those operations. This does not establish a global ban on launching Codex.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/sandbox.md
Locator: Configuration; Private stores; Shared credentials
Finding: Optional Docker (default), Podman or Apple Container runs the agent in a private container with the project mounted at /workspace, configurable CPU and memory limits and per-session agent stores. Claude refresh credentials are shared across sandbox sessions, with documented refresh conflicts. The guide documents no network policy settings.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/session-resume.md
Locator: Managed contexts; Refusals
Finding: Resume/fork support depends on harness, store and OS. Codex with ChatGPT login is explicitly refused for managed resume/fork, and unsandboxed macOS Codex has additional limits.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8d2921c4e2960038b98d29e52ed8742ab4d52c6e/docs/structured-view.md#L18-L36
Locator: docs/structured-view.md lines 18-36 (agent, adapter, install and auth table), release v1.22.3 commit 8d2921c
Finding: Each agent authenticates through its own CLI login or provider key: Claude via claude auth login or ANTHROPIC_API_KEY, Codex via codex login or OPENAI_API_KEY, Gemini via API key, OAuth or Vertex. Gemini CLI is marked deprecated upstream for individual accounts; Cursor and others run in the terminal view.
Retrieved: 2026-11-10

## agent-of-empires:ACC-04

Finding: Install AoE and tmux on Linux/macOS, then add an installed agent or start the dashboard. AoE can be run over SSH on a user-controlled host; sessions persist across SSH disconnect.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/README.md
Locator: Overview; How it works; FAQ
Finding: AoE manages parallel persistent tmux sessions on Linux/macOS, with CLI/TUI/browser/API access, optional worktrees/containers, phone browser access and SSH reconnect. Windows is WSL2 only.
Retrieved: 2026-11-08

## agent-of-empires:ACC-05

Finding: CLI includes add, list/ps, send, wait, fork and session lifecycle operations. The daemon exposes an HTTP session-management API. An optional inbound MCP server exposes typed session tools after explicit enablement. Daemon token/passphrase/login mode governs API/MCP access; passphrase walls cannot be bypassed by a bearer token.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/cli/reference.md
Locator: aoe add; send; ps; agents; acp
Finding: CLI creates, lists, sends to, forks and removes sessions. Custom commands and ACP agent/model/effort selection are supported; named resume/fork examples include Claude, Codex, OpenCode and Pi.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/api.md
Locator: Session endpoints; MCP server
Finding: HTTP and typed MCP operations expose session management. Authentication and read-only restrictions vary by daemon launch mode.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/mcp-control.md
Locator: Turn it on; Authentication; Limits
Finding: MCP control is opt-in, off by default; it exposes session operations under daemon credentials. It adds no per-tool permissions beyond the connected users access.
Retrieved: 2026-11-08

## agent-of-empires:ACC-06

Finding: Configured MCP server definitions are forwarded to structured-view agents when a session starts; terminal sessions load MCP config through the agent's own CLI. Inbound AoE control MCP and outbound MCP forwarding are separate integrations.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/mcp-control.md
Locator: Turn it on; Authentication; Limits
Finding: MCP control is opt-in, off by default; it exposes session operations under daemon credentials. It adds no per-tool permissions beyond the connected users access.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/mcp-servers.md
Locator: MCP forwarding
Finding: AoE forwards configured MCP server definitions to structured-view agents when a session starts; terminal sessions run the agent's own CLI, which loads MCP configuration itself. This is distinct from AoE's inbound control MCP server.
Retrieved: 2026-11-08

## agent-of-empires:PLAN-01

Finding: Users create local agent sessions through CLI, TUI or dashboard. This is session creation rather than evidence of separate product-owned issues.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/README.md
Locator: Overview; How it works; FAQ
Finding: AoE manages parallel persistent tmux sessions on Linux/macOS, with CLI/TUI/browser/API access, optional worktrees/containers, phone browser access and SSH reconnect. Windows is WSL2 only.
Retrieved: 2026-11-08

## agent-of-empires:PLAN-04

Finding: Profiles, repository configuration/hooks and custom agent commands configure session behavior.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/README.md
Locator: Overview; How it works; FAQ
Finding: AoE manages parallel persistent tmux sessions on Linux/macOS, with CLI/TUI/browser/API access, optional worktrees/containers, phone browser access and SSH reconnect. Windows is WSL2 only.
Retrieved: 2026-11-08

## agent-of-empires:PLAN-06

Finding: Core AoE and its first-party Board plugin organize session cards. They do not provide a task/issue record independent of an agent session.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Source inspection covers the scoped release only. Unanswered atomic questions remain unknown; no live scenario was run.

Source: https://github.com/agent-of-empires/plugin-kanban/blob/21638a15a1a9c49906946246b6a3a314c776e90c/README.md
Locator: The Board; requirements and installation; core src/session/storage.rs and src/session/mod.rs; plugin worker/src state models
Finding: The first-party Board plugin states every non-dismissed Session is one Card, with Stage and Signal columns. Its persisted workflow stages annotate sessions rather than independent product-owned issues. Core storage likewise persists sessions and groups.
Retrieved: 2026-11-13

## agent-of-empires:COORD-01

Finding: Agents run in parallel across separate branches/worktrees.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/README.md
Locator: Overview; How it works; FAQ
Finding: AoE manages parallel persistent tmux sessions on Linux/macOS, with CLI/TUI/browser/API access, optional worktrees/containers, phone browser access and SSH reconnect. Windows is WSL2 only.
Retrieved: 2026-11-08

## agent-of-empires:COORD-03

Finding: AoE exposes session control commands and a read-only MCP server, but this scoped release supplies no coordinator agent role with worker delegation and communication tools.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Source inspection covers the scoped release only. Unanswered atomic questions remain unknown; no live scenario was run.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/src/server/mcp.rs
Locator: McpServer tool_router and ServerHandler instructions; docs/api.md MCP tools; shipped skill/package tree and CLI/session commands searched for coordinator, orchestrator and delegation
Finding: The shipped MCP server exposes read-only list_sessions and whoami tools. Source/client/skill inspection finds session creation/send CLI commands but no AoE-supplied coordinator agent role or delegation recipe that owns worker assignment and supervision; harness-internal subagents remain separate.
Retrieved: 2026-11-13

## agent-of-empires:COORD-04

Finding: The optional first-party Cron plugin starts structured sessions and delivers prompts on host-local cron schedules. Missed times are skipped; plugin installation and a running host are required.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Source inspection covers the scoped release only. Unanswered atomic questions remain unknown; no live scenario was run.

Source: https://github.com/agent-of-empires/plugin-cron/blob/5e207e4f0358a51fb36036cc6ef80e991b0683a9/README.md
Locator: Install; Configure jobs; Scheduling behavior; Security model; core plugins/featured.toml
Finding: The official Cron plugin creates structured AoE sessions and delivers the configured first prompt on a five-field cron schedule, without a human. Jobs use host-local time and skip missed runs; install requires API 9+, and the scoped core featured index pins plugin 1.0.0.
Retrieved: 2026-11-13

## agent-of-empires:COORD-05

Finding: Session lifecycle and global killall controls stop workers; killall is explicitly destructive and unprompted. aoe send and the browser send prompts to running sessions.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/cli/reference.md
Locator: aoe add; send; ps; agents; acp
Finding: CLI creates, lists, sends to, forks and removes sessions. Custom commands and ACP agent/model/effort selection are supported; named resume/fork examples include Claude, Codex, OpenCode and Pi.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/web-dashboard.md
Locator: Launch; access modes; security
Finding: The shipped dashboard drives sessions from a browser; tmux and persistent structured workers survive browser crashes. Remote access supports authenticated tunnel modes and read-only views.
Retrieved: 2026-11-08

## agent-of-empires:COORD-07

Finding: Structured view supports explicit model and reasoning effort choices subject to cached provider options.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/cli/reference.md
Locator: aoe add; send; ps; agents; acp
Finding: CLI creates, lists, sends to, forks and removes sessions. Custom commands and ACP agent/model/effort selection are supported; named resume/fork examples include Claude, Codex, OpenCode and Pi.
Retrieved: 2026-11-08

## agent-of-empires:RUN-01

Finding: AoE runs agents on the operator local or SSH host and optionally the configured container runtime. The scoped source provides no vendor-operated execution service.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/README.md
Locator: Overview; How it works; FAQ
Finding: AoE manages parallel persistent tmux sessions on Linux/macOS, with CLI/TUI/browser/API access, optional worktrees/containers, phone browser access and SSH reconnect. Windows is WSL2 only.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/web-dashboard.md
Locator: Launch; access modes; security
Finding: The shipped dashboard drives sessions from a browser; tmux and persistent structured workers survive browser crashes. Remote access supports authenticated tunnel modes and read-only views.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/src/containers/runtime.rs
Locator: RuntimeKind and ContainerRuntime; src/containers/execution.rs; session launch paths; docs/guides/sandbox.md; inspected backend choices, remote endpoints, vm, qemu, firecracker
Finding: The complete sandbox runtime enum routes Docker, Podman and Apple Container. Agent work uses the operator host or user-controlled remote/container endpoint, without an ADE-vendor compute service. The Apple Container choice is a named first-party integration with that engine.
Retrieved: 2026-11-13

## agent-of-empires:RUN-02

Finding: Optional worktrees and Docker/Podman/Apple Container sandboxes separate sessions. The Apple Container option runs each Linux session container in a lightweight VM on Apple silicon; this is not generalized to Docker/Podman. Credential sharing limitations remain documented.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/sandbox.md
Locator: Configuration; Private stores; Shared credentials
Finding: Optional Docker (default), Podman or Apple Container runs the agent in a private container with the project mounted at /workspace, configurable CPU and memory limits and per-session agent stores. Claude refresh credentials are shared across sandbox sessions, with documented refresh conflicts. The guide documents no network policy settings.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/worktrees.md
Locator: Worktree creation and lifecycle
Finding: Git worktrees isolate session working copies/branches; they are separate from container security controls.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/src/containers/runtime.rs
Locator: RuntimeKind and ContainerRuntime; src/containers/execution.rs; session launch paths; docs/guides/sandbox.md; inspected backend choices, remote endpoints, vm, qemu, firecracker
Finding: The complete sandbox runtime enum routes Docker, Podman and Apple Container. Agent work uses the operator host or user-controlled remote/container endpoint, without an ADE-vendor compute service. The Apple Container choice is a named first-party integration with that engine.
Retrieved: 2026-11-13

Source: https://github.com/apple/container/blob/16e8d488ee1d9ede35ab9cf21b9973ffdc9361b3/docs/technical-overview.md
Locator: How does container run my container? One lightweight VM per container; paired with AoE sandbox runtime selection apple_container.
Finding: Apple Container runs each Linux container in its own lightweight virtual machine on Apple silicon. AoE explicitly offers this named sandbox runtime and its pinned runtime implementation invokes the Apple container CLI. This establishes per-session VM isolation only for that optional macOS backend.
Retrieved: 2026-11-13

## agent-of-empires:RUN-03

Finding: The TUI can reattach persistent tmux sessions after reconnect. Native resume/fork has harness/store-specific requirements and explicit refusals; transcript visibility alone is insufficient. ChatGPT-authenticated Codex and unsandboxed macOS Codex are among the documented managed-resume refusals.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/README.md
Locator: Overview; How it works; FAQ
Finding: AoE manages parallel persistent tmux sessions on Linux/macOS, with CLI/TUI/browser/API access, optional worktrees/containers, phone browser access and SSH reconnect. Windows is WSL2 only.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/session-resume.md
Locator: Managed contexts; Refusals
Finding: Resume/fork support depends on harness, store and OS. Codex with ChatGPT login is explicitly refused for managed resume/fork, and unsandboxed macOS Codex has additional limits.
Retrieved: 2026-11-08

## agent-of-empires:RUN-04

Finding: Sandbox seeding uses private agent stores and a shared Claude credential file with documented refresh behavior.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/sandbox.md
Locator: Configuration; Private stores; Shared credentials
Finding: Optional Docker (default), Podman or Apple Container runs the agent in a private container with the project mounted at /workspace, configurable CPU and memory limits and per-session agent stores. Claude refresh credentials are shared across sandbox sessions, with documented refresh conflicts. The guide documents no network policy settings.
Retrieved: 2026-11-08

## agent-of-empires:RUN-06

Finding: TUI/browser status detection and CLI ps provide a runtime session overview. No induced-failure consistency test was run.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/README.md
Locator: Overview; How it works; FAQ
Finding: AoE manages parallel persistent tmux sessions on Linux/macOS, with CLI/TUI/browser/API access, optional worktrees/containers, phone browser access and SSH reconnect. Windows is WSL2 only.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/cli/reference.md
Locator: aoe add; send; ps; agents; acp
Finding: CLI creates, lists, sends to, forks and removes sessions. Custom commands and ACP agent/model/effort selection are supported; named resume/fork examples include Claude, Codex, OpenCode and Pi.
Retrieved: 2026-11-08

## agent-of-empires:RUN-08

Finding: Optional per-container CPU and memory limits are configurable; no global compute-aware queue is established.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/sandbox.md
Locator: Configuration; Private stores; Shared credentials
Finding: Optional Docker (default), Podman or Apple Container runs the agent in a private container with the project mounted at /workspace, configurable CPU and memory limits and per-session agent stores. Claude refresh credentials are shared across sandbox sessions, with documented refresh conflicts. The guide documents no network policy settings.
Retrieved: 2026-11-08

## agent-of-empires:TEAM-02

Finding: Optional self-hosted CityHall provides human roles with permission keys and OpenID Connect SSO for AoE. The standalone AoE daemon remains a single-user service.

Verification: sourced
Checked: 2026-11-13
Scheduled recheck: 2027-03-13
Plan: Optional self-hosted CityHall deployment
Surface: AoE browser and mobile-web dashboard
Version: AoE 8b1a7cc; optional CityHall d1b02fae908f0793b6c78d4e9700002e07481a0d

Source inspection covers the scoped release only. Unanswered atomic questions remain unknown; no live scenario was run.

Source: https://github.com/agent-of-empires/cityhall/blob/d1b02fae908f0793b6c78d4e9700002e07481a0d/README.md
Locator: Intro; Running; CLI; api/src/handlers/roles.rs and api/src/handlers/oidc.rs; api/src/migration/m0005_create_roles.rs and m0007_create_oidc_settings.rs
Finding: CityHall is the first-party self-hostable distributed server for Agent of Empires. It ships user accounts, configurable roles and permission keys, and OpenID Connect single sign-on. These are CityHall controls; the standalone AoE daemon uses token/passphrase authentication.
Retrieved: 2026-11-13

## agent-of-empires:TEAM-03

Finding: An MCP client has the same access as the keyboard user; AoE adds no per-tool permissions. Remote serving supports authenticated HTTPS tunnels, rotating tokens and read-only mode.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/web-dashboard.md
Locator: Launch; access modes; security
Finding: The shipped dashboard drives sessions from a browser; tmux and persistent structured workers survive browser crashes. Remote access supports authenticated tunnel modes and read-only views.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/mcp-control.md
Locator: Turn it on; Authentication; Limits
Finding: MCP control is opt-in, off by default; it exposes session operations under daemon credentials. It adds no per-tool permissions beyond the connected users access.
Retrieved: 2026-11-08

## agent-of-empires:TEAM-05

Finding: Diff line comments can be edited and sent as a follow-up prompt with the captured snippet. Stale diff comments move to a marked block; localStorage scope is per session.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/diff-view.md
Locator: Comparisons; Inline review
Finding: Diff UI supports comparison bases and line comments sent as follow-up prompts. Comments are localStorage per session and move to a stale block when code changes.
Retrieved: 2026-11-08

## agent-of-empires:SHIP-01

Finding: The browser/TUI diff viewer displays changes against selectable comparison bases.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/diff-view.md
Locator: Comparisons; Inline review
Finding: Diff UI supports comparison bases and line comments sent as follow-up prompts. Comments are localStorage per session and move to a stale block when code changes.
Retrieved: 2026-11-08

## agent-of-empires:SHIP-03

Finding: AoE manages session worktrees and branches, without a built-in PR creation/management workflow in this scoped core.

Verification: sourced
Checked: 2026-11-08
Scheduled recheck: 2026-12-08
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/worktrees.md
Locator: Worktree creation and lifecycle
Finding: Git worktrees isolate session working copies/branches; they are separate from container security controls.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/src/git/worktree/mod.rs
Locator: worktree creation/removal; CLI and server routes; docs/agents/issue-tracker.md; searched pull_request, gh pr and create_pr across application paths
Finding: The scoped core manages worktrees and session branches. Searches of CLI, server, Git and first-party Board paths find no built-in PR creation/management workflow. Developer instructions under docs/agents/issue-tracker.md describe external gh commands for contributors, not a shipped ADE workflow.
Retrieved: 2026-11-13

## agent-of-empires:OWN-01

Finding: AoE uses MIT with a separately documented Apache-2.0-derived hyperlink file.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2027-02-06
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/LICENSE
Locator: MIT grant
Finding: AoE is MIT licensed, with an Apache-2.0-derived file separately disclosed in THIRD_PARTY_NOTICES.
Retrieved: 2026-11-08

## agent-of-empires:OWN-02

Finding: The full daemon, session manager and optional web dashboard run on user-controlled Linux/macOS hosts.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-11-22
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/README.md
Locator: Overview; How it works; FAQ
Finding: AoE manages parallel persistent tmux sessions on Linux/macOS, with CLI/TUI/browser/API access, optional worktrees/containers, phone browser access and SSH reconnect. Windows is WSL2 only.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/guides/web-dashboard.md
Locator: Launch; access modes; security
Finding: The shipped dashboard drives sessions from a browser; tmux and persistent structured workers survive browser crashes. Remote access supports authenticated tunnel modes and read-only views.
Retrieved: 2026-11-08

## agent-of-empires:OWN-03

Finding: Anonymous telemetry is off by default and requires opt-in. aoe telemetry disable or DO_NOT_TRACK disables telemetry; reset-id rotates the local installation ID.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-11-22
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/telemetry.md
Locator: Defaults; Controls; Never sent
Finding: Anonymous telemetry is opt-in, off by default. aoe telemetry disable and DO_NOT_TRACK suppress sending; settings expose consent and reset controls.
Retrieved: 2026-11-08

## agent-of-empires:OWN-04

Finding: Agent of Empires is free and open source with no paid ADE plan in the checked offering. Model/agent costs are separate: structured adapters accept user-supplied provider API keys as well as the supported agent sign-in routes.

Verification: sourced
Checked: 2026-11-10
Scheduled recheck: 2026-11-24
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: First-party pricing read 2026-11-10; structured provider credentials at 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4

Pricing refers to the free ADE application. Agent/model subscriptions, user-owned provider API usage and operator compute are separate; no purchase or billing test ran.

Source: https://www.agent-of-empires.com/
Locator: Closing install section: 'Take command of your agents'
Finding: The site describes Agent of Empires as free and open source under the MIT license; no paid plan or pricing page is shown.
Retrieved: 2026-11-10

Source: https://github.com/agent-of-empires/agent-of-empires/blob/main/LICENSE
Locator: MIT License, permission grant
Finding: The MIT license grants permission to use, copy, modify and distribute the software free of charge.
Retrieved: 2026-11-10

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/docs/structured-view.md
Locator: Supported adapters authentication table; Provider credentials allowlist; structured-view/controls.md Not logged in and API-key setup.
Finding: The structured adapters support provider-owned API credentials: Claude accepts ANTHROPIC_API_KEY, Codex accepts OPENAI_API_KEY, and OpenCode receives multiple named provider API keys. The control guide explicitly tells users to set their own key where aoe serve runs, restart the daemon and restart the agent. Model-provider billing is separate from the free AoE application.
Retrieved: 2026-11-13

## agent-of-empires:OWN-06

Finding: README links public issues, documentation and community channels. The latest retrieved release is v1.22.1 dated 2026-11-06.

Verification: agent-cross-checked
Checked: 2026-11-08
Scheduled recheck: 2026-11-22
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: Repository 8b1a7cc8525cc4be8949c9c6077b70cd42c265e4; first-party source pass 2026-11-08.

Only the cited atomic findings are established. Remaining atomic requirements and the full rubric scenario remain unverified.

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8b1a7cc8525cc4be8949c9c6077b70cd42c265e4/README.md
Locator: Overview; How it works; FAQ
Finding: AoE manages parallel persistent tmux sessions on Linux/macOS, with CLI/TUI/browser/API access, optional worktrees/containers, phone browser access and SSH reconnect. Windows is WSL2 only.
Retrieved: 2026-11-08

Source: https://github.com/agent-of-empires/agent-of-empires/releases/tag/v1.22.1
Locator: Release heading and notes
Finding: Public release v1.22.1 was published 2026-11-06.
Retrieved: 2026-11-08

## agent-of-empires:OWN-08

Finding: Agent of Empires is a free MIT-licensed download installed through Homebrew or a shell script; no paid plan is shown. Agent and model costs are paid to their providers.

Verification: agent-cross-checked
Checked: 2026-11-10
Scheduled recheck: 2026-11-24
Plan: Not specified
Surface: AoE terminal UI and CLI; AoE browser and mobile-web dashboard
Version: v1.22.3 (commit 8d2921c)

Free scenarios, usage caps and card requirements for the underlying agents were not checked. No installed-product test was run.

Source: https://www.agent-of-empires.com/
Locator: Closing install section: 'Take command of your agents'
Finding: The site describes Agent of Empires as free and open source under the MIT license; no paid plan or pricing page is shown.
Retrieved: 2026-11-10

Source: https://github.com/agent-of-empires/agent-of-empires/blob/8d2921c4e2960038b98d29e52ed8742ab4d52c6e/README.md#L72-L80
Locator: README.md lines 72-80 (Installation), release v1.22.3 commit 8d2921c
Finding: aoe installs through Homebrew or a public install script; the README names no price, account or paid plan.
Retrieved: 2026-11-10