A peaceful RTS for Claude Code, Codex, OpenCode & Koda

Age ofAgents

Watch your AI coding sessions grow a calm, living pixel realm. Every session is a settler that walks out of the keep, gathers and builds; the tool it runs decides which workshop it visits, subagents become workers, and tokens fill the storehouse. No combat — just a quiet kingdom of work, at a glance.

npx age-of-agents
age-of-agents on npmone command, no install · needs Node 22+
age-of-agents · localhost:5173
Age of Agents — a peaceful fantasy realm with a keep, mage tower, market and library
The idea

Every session settles the realm

A calm, second-monitor view of what your agents are quietly doing — no change to how you use the CLI.

🧑‍🌾

Session → Settler

Start a Claude Code, Codex, OpenCode or Koda session and a settler walks out of the keep, carrying your prompt as its task for the day.

🏚️

Tools → Workshops

The settler heads to the building that matches the work — the forge for edits, the mage tower for web research, the mine for the terminal.

⛏️

Subagents → Workers

When a session spawns subagents, they appear as little workers busying themselves around their settler.

🌾

Tokens → Harvest

Tokens read and produced fill the storehouse. Settlers ponder while thinking, rest when waiting, and stroll home when the day's work is done.

🏛️

Projects → Cities

Run many projects at once and each becomes a city you can switch between — open one to peek at optional Beads tasks and a Graphify code map in the Architect's Hall.

Under the hood

How it works

Read-only, local, calm. The server knows what a session is doing; the client decides where each settler goes.

01 · source

Transcript

Reads sessions from ~/.claude, ~/.codex, ~/.opencode & ~/.koda

02 · server

State machine

Facts → thinking / working / resting / idle

03 · wire

WebSocket

Broadcasts a HeroSnapshot per session

04 · client

PixiJS realm

Renders settlers, HUD, minimap & panels

Session detail side panel showing task, tokens and activity
Inspect any settler

The session, in full

Click a settler to open its ledger: the current task, the tool in hand, tokens produced and read, and a calm stream of recent actions — the whole session at a glance.

  • Live task & objective tracking
  • Token economy (produced / read)
  • Recent-actions activity timeline
  • Per-session status & helpers
Get started

One command, no install

No accounts, no cloud. It runs entirely on your machine and only reads your sessions locally.

zsh — age-of-agents
# run it instantly — watches ~/.claude, ~/.codex, ~/.opencode & ~/.koda sessions
 npx age-of-agents            # prints the URL
 npx age-of-agents --demo     # calm demo, fake sessions
 npx age-of-agents --open     # open the browser too

# or from source
 git clone https://github.com/agentsmill/age-of-agents
 cd age-of-agents && npm install && npm run demo