Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Agent of Empires

A terminal session manager for Linux and macOS using tmux to aid in management and monitoring of AI coding agents, written in Rust.

Agent of Empires TUI

Features

  • TUI Dashboard - Visual interface to manage all your AI coding sessions
  • Session Management - Create, attach, detach, and delete sessions
  • Group Organization - Organize sessions into hierarchical folders
  • Status Detection - Automatic status detection for Claude Code and OpenCode
  • tmux Integration - Sessions persist in tmux for reliability
  • Multi-profile Support - Separate workspaces for different projects
  • Git Worktrees - Run parallel agents on different branches of the same repo

How It Works

Agent of Empires (aoe) is a wrapper around tmux, the terminal multiplexer. Each AI coding session you create is actually a tmux session under the hood.

Once you attach to a session, you’re working directly in tmux. Basic tmux knowledge helps:

tmux CommandWhat It Does
Ctrl+b dDetach from session (return to Agent of Empires)
Ctrl+b [Enter scroll/copy mode
Ctrl+b n / Ctrl+b pNext/previous window

If you’re new to tmux, the key thing to remember is Ctrl+b d to detach and return to the TUI.