How to set up Docker sandboxing in Agent of Empires?

Use the --sandbox flag when adding a session via CLI or configure it in the TUI. The sandbox uses Docker containers with shared volumes for authentication, as detailed in the Docker Sandbox guide on the documentation site.

Agent of Empires vs agent-deck: which is better for AI agents?

Agent of Empires is built in Rust with tmux integration and Docker sandboxing, offering robust isolation and git features. Agent-deck uses Go and Bubble Tea, but AoE is more focused on terminal persistence and security for parallel workflows.

Is Agent of Empires available for Windows?

No, it's specifically designed for Linux and macOS. Windows users would need to use WSL or seek alternative tools for AI agent management.

Can I use Agent of Empires with custom AI tools not listed?

The tool auto-detects installed agents from a predefined list. For custom tools, you might need to configure them manually via per-repo config or hooks, but this isn't explicitly documented for unsupported agents.

How to manage sessions when using mobile SSH clients?

Run 'aoe' inside a tmux session when connecting from mobile clients like Termius, and use Ctrl+b L to toggle back to the AoE interface, as mentioned in the troubleshooting section for mobile SSH clients.

What happens if Claude Code flickers in AoE?

This is a known issue with Claude Code itself, not AoE, as noted in the troubleshooting section with a link to the Claude Code GitHub issue. AoE's TUI may display flickering but doesn't cause it.

Open-Awesome

agent-of-empires

MITRustv1.13.1

A terminal session manager for AI coding agents that runs multiple agents in parallel using tmux and git worktrees.

Visit Website GitHub

2.9k stars277 forks0 contributors

What is agent-of-empires?

Agent of Empires is a terminal session manager built for AI coding agents that allows developers to run multiple agents in parallel across different branches of their codebase. It provides isolated sessions using tmux and optional Docker sandboxing, with a TUI dashboard for monitoring and management. The tool solves the problem of managing concurrent AI agent workflows efficiently and securely.

Target Audience

Developers and engineers who use multiple AI coding agents (like Claude Code, Copilot CLI, or Gemini CLI) and need to manage them simultaneously across different projects or git branches. It's particularly useful for those working on complex codebases requiring parallel experimentation.

Value Proposition

Developers choose Agent of Empires because it offers a dedicated, integrated environment for AI agents with features like git worktree support, Docker isolation, and a visual TUI—reducing context switching and improving workflow efficiency compared to manual terminal management.

Overview

Manage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile. Also supports Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, Factory Droid Coding.

Use Cases

Best For

Running multiple AI coding agents simultaneously on different git branches
Isolating AI agent sessions with Docker for security and reproducibility
Managing parallel AI-assisted coding experiments in a single codebase
Monitoring and switching between active AI agent sessions via a terminal dashboard
Reviewing and editing code changes from AI agents without leaving the terminal
Setting up project-specific configurations and hooks for AI agent workflows

Not Ideal For

Windows developers needing cross-platform AI agent management
Teams not using tmux or preferring GUI-based tools
Projects with minimal AI agent usage or single-branch workflows
Environments where Docker is unavailable or sandboxing is overkill

Pros & Cons

Pros

Multi-Agent Orchestration

Supports a wide range of AI coding agents like Claude Code and Copilot CLI, enabling simultaneous management across different branches as listed in the features.

Git Worktree Integration

Facilitates parallel agents on different git branches using worktrees, allowing concurrent experimentation without repository conflicts, as highlighted in the guides.

Docker Sandboxing Security

Provides optional container isolation with shared authentication volumes for enhanced security, detailed in the Docker sandboxing documentation.

Persistent Tmux Sessions

Leverages tmux for session persistence, ensuring agents run in the background even when the TUI is closed, as explained in the 'How It Works' section.

Cons

Tmux Dependency

Requires tmux installation and familiarity with its shortcuts (e.g., Ctrl+b d), adding a learning curve and dependency that may not suit all users.

Platform Limitation

Only available for Linux and macOS, excluding Windows users and limiting cross-platform team adoption without workarounds like WSL.

Limited AI Tool Compatibility

Auto-detection is restricted to a predefined list of AI tools; custom or newly released agents may not be supported without manual configuration.

Frequently Asked Questions

Related Projects

cc-switch

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

Stars120,629

Forks8,099

Last commit15 hours ago

Screenpipe

YC (S26) | Record your screen 24/7 and plug into your agents. Local, private, secure. Connect to OpenClaw, Hermes agent and 100+ apps

Stars20,458

Forks2,019

Last commit7 hours ago

ast-grep

⚡A CLI tool for code structural search, lint and rewriting. Written in Rust

Stars15,171

Forks419

Last commit14 hours ago

espanso

A Privacy-first, Cross-platform Text Expander written in Rust

Stars14,144

Forks436

Last commit2 days ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub