ClaudeManager

AI manager agent that sits on top of Agent of Empires. Talk to one Claude Code session that knows what all your other sessions are doing.

You: "What's everyone working on?"

Manager: 3 sessions active:
  poppyai-web    — running — editing CarouselNode component
  competitor-tool — waiting — finished idempotency fix, needs review
  auth-service    — waiting — asking about dropping legacy_sessions table

You: "Tell auth-service yes, drop the table"

Manager: Sent to auth-service: "Yes, drop the table"

How it works

  AoE manages sessions (tmux, status detection, TUI)
       │
       ▼
  ClaudeManager MCP server (wraps `aoe` CLI)
       │
       ▼
  Manager CC session (you talk to this)

Agent of Empires handles the infrastructure: tmux sessions, status detection (running/waiting/idle), TUI dashboard. ClaudeManager adds a conversational AI layer on top, so you can ask questions about your sessions and coordinate them by talking to one agent.

Prerequisites

• Bun
• Agent of Empires installed and in PATH

Setup

1. Install dependencies

cd ClaudeManager
bun install

2. Add the MCP server to your Claude Code config

Add to your .mcp.json (project or global):

{
  "mcpServers": {
    "claude-manager": {
      "command": "bun",
      "args": ["run", "/path/to/ClaudeManager/src/cli/index.ts", "serve"]
    }
  }
}

3. Copy the manager template

Copy templates/CLAUDE.md to the project where you'll run the manager session. This tells Claude Code how to act as a manager agent.

4. Start managing

Open a Claude Code session in that project. It now has MCP tools to see and control all your AoE sessions.

MCP Tools

Tool	Description
list_sessions	List all AoE sessions with status
get_status	Summary: counts of running/waiting/idle sessions
get_session_details	Detailed info for one session
capture_session_output	Read recent terminal output of a session
send_message	Send instruction to a waiting session
list_groups	List session groups
create_session	Create a new AoE session
stop_session	Stop a session
health_check	Check if AoE is installed

What you can do

• "What's everyone working on?" — sees all sessions, reads their recent output, synthesizes status
• "Tell auth-service to drop the table" — injects instructions into a waiting session
• "When competitor-tool finishes, tell poppyai to pull types" — coordinates cross-repo work
• "Create a new session in ~/projects/mobile-app" — spins up a new AoE session
• "Stop the auth-service session" — stops a session

License

MIT