# Install aoe with Homebrew Terminal session manager for AI coding agents. Version 1.12.0 via Homebrew; verified 2026-07-04. ## Install ```sh sudo av install brew:aoe ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install aoe ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:aoe - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.12.0 - **Source summary:** Terminal session manager for AI coding agents - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Last updated:** 2026-07-04T16:53:41+09:00 - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - aoe (cli) - aoe (alias) ## Dependencies - openssl@3 - tmux ## Build dependencies - node - pkgconf - rust ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.12.0 - Package-manager updated: 2026-07-04 - Local data: ok - Upstream repository: https://github.com/agent-of-empires/agent-of-empires - Upstream latest detected: v1.12.0 (current) ## Project history and usage Agent of Empires is a Rust terminal session manager for AI coding agents. It wraps tmux, git worktrees, optional container sandboxes, and a browser dashboard around tools such as Claude Code, Codex CLI, OpenCode, Gemini CLI, Cursor CLI, Copilot CLI, and others. ### Project history The project README frames AoE as an answer to the operational problem created by running many coding agents at once: tracking which session is active, blocked, idle, or messy. Its core abstraction is a persistent tmux session per agent, with an AoE TUI and optional web dashboard on top. AoE's official documentation expanded beyond a simple TUI into a full workflow tool. The current docs cover a web dashboard, structured ACP view, remote phone access, git worktrees, multi-repo workspaces, Docker and Podman sandboxing, diff review, repo config, hooks, sound and push notifications, shell completions, and an HTTP API. ### Adoption history AoE entered package-manager culture through a Homebrew formula named `aoe`, and its README advertises Homebrew, Nix, curl-install, and source-build paths. That packaging choice is central to its audience: developers who already install AI-agent CLIs and want a single manager installed like any other terminal tool. The README says the project is maintained by the Agent of Empires community with support from Mozilla.ai and includes public channels such as GitHub issues, a roadmap board, Discord, YouTube, and social accounts. It also acknowledges inspiration from `agent-deck`, another terminal-oriented agent session manager. ### How it is used The documented quick start is `aoe` to launch the TUI, `aoe add --cmd claude` to create a session, and `aoe serve` to start the web dashboard. AoE keeps sessions alive in tmux after terminals close and lets users reattach or inspect status later. Configuration is layered. Official docs state that global config, profile config, and repo config are resolved in order, with repo-local `.agent-of-empires/config.toml` able to define hooks, sandbox behavior, worktree settings, and default agents for a project. ### Why package nerds care AoE is interesting to package nerds because it packages a fast-moving AI-agent workflow as a normal CLI with shell completions, config files, a service-like web mode, and update logic. It also exposes the messy integration edges of modern dev tooling: tmux, containers, worktrees, browser UIs, multiple agent CLIs, and per-repo policy. ### Timeline - 2025: Early public tags such as `v0.0.1` appear in the upstream Git repository. - 2025: README documents Homebrew installation with `brew install aoe`. - 2026: Official docs describe layered global, profile, and repo configuration for AoE. ### Related projects - tmux provides AoE's persistent terminal session substrate. - agent-deck is acknowledged by the upstream README as an inspiration. - Claude Code, Codex CLI, OpenCode, Gemini CLI, Cursor CLI, Copilot CLI, and other agent CLIs are managed by AoE. ### Sources - - - - - ## Security Notes No matching local secret-handling manifest was found for aoe. Nucleus package metadata is still published here so future coverage has a stable package URL. ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Linux: $XDG_CONFIG_HOME/agent-of-empires/config.toml, ~/.config/agent-of-empires/config.toml, .agent-of-empires/config.toml - macOS: ~/.agent-of-empires/config.toml, $XDG_CONFIG_HOME/agent-of-empires/config.toml, .agent-of-empires/config.toml ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** aoe - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Related links - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [openssl@3](https://www.automicvault.com/pkg/brew/openssl-3/) - Runtime dependency declared by Homebrew. - [tmux](https://www.automicvault.com/pkg/brew/tmux/) - Runtime dependency declared by Homebrew. - [node](https://www.automicvault.com/pkg/brew/node/) - Build dependency declared by Homebrew. - [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew. - [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew. - [gbox](https://www.automicvault.com/pkg/brew/gbox/) - Shares av.db curated category or tags: ai-agents, cli, developer-tools. - [kagent](https://www.automicvault.com/pkg/brew/kagent/) - Shares av.db curated category or tags: ai-agents, cli, developer-tools. - [nanobot](https://www.automicvault.com/pkg/brew/nanobot/) - Shares av.db curated category or tags: ai-agents, cli, developer-tools. - [oh-my-agent](https://www.automicvault.com/pkg/brew/oh-my-agent/) - Shares av.db curated category or tags: ai-agents, cli, developer-tools. - [omnara](https://www.automicvault.com/pkg/brew/omnara/) - Shares av.db curated category or tags: ai-agents, cli, developer-tools. - [ralph-orchestrator](https://www.automicvault.com/pkg/brew/ralph-orchestrator/) - Shares av.db curated category or tags: ai-agents, cli, developer-tools. - [sesh](https://www.automicvault.com/pkg/brew/sesh/) - Shares av.db curated category or tags: cli, developer-tools, session-manager, terminal. - [tmuxp](https://www.automicvault.com/pkg/brew/tmuxp/) - Shares av.db curated category or tags: cli, developer-tools, session-manager, terminal. - [gitlogue](https://www.automicvault.com/pkg/brew/gitlogue/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, openssl, openssl-3. ## Combined YAML source View the package source record on GitHub. [combined/aoe.yml](https://github.com/automic-vault/db/blob/main/combined/aoe.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph