Quick Start

Launch the TUI

The simplest way to use Agent of Empires is through the TUI dashboard:

aoe

This opens an interactive interface where you can:

• View all your coding sessions
• Create new sessions with n
• Attach to sessions with Enter
• Delete sessions with d
• Quit with q

CLI Quick Reference

Add a Session

# Add session in current directory
aoe add

# Add session with custom title
aoe add -t "my-feature"

# Add and launch immediately
aoe add -l

# Add session for specific project
aoe add /path/to/project

List Sessions

# Table format
aoe list

# JSON format
aoe list --json

Manage Sessions

# Attach to a session
aoe session attach my-session

# Start a stopped session
aoe session start my-session

# Stop a running session
aoe session stop my-session

# Show session details
aoe session show my-session

Check Status

# Summary of all sessions
aoe status

# Detailed status
aoe status -v

# JSON format (for scripts)
aoe status --json

Profiles

Profiles let you maintain separate workspaces:

# Use default profile
aoe

# Use a specific profile
aoe -p work

# Create a new profile
aoe profile create client-xyz

# List all profiles
aoe profile list

Configuration

Configuration is stored in ~/.agent-of-empires/:

~/.agent-of-empires/
├── config.toml           # Global configuration
├── profiles/
│   └── default/
│       ├── sessions.json # Session data
│       └── groups.json   # Group structure
└── logs/                 # Session logs

Environment Variables

Next Steps

• See the CLI Reference for complete command documentation
• Learn about Git Worktrees for parallel development