Switching between terminals to keep track of your agents?Follow Claude Code and Codex sessions in one fantasy village. Each agent is a hero; each building shows what it’s doing.
The village in motion. An animated preview from the repository.
01 / Activity, at a glance
Less switching tabs. More seeing the whole party.
Keep working in your terminal. Agent Quest discovers active sessions and turns their activity into a scene you can follow at a glance.
01 / Reading & searching
The Library
Read / Grep / Glob
The hero visits the Library to read files and search through code.
02 / Writing & editing
The Forge
Edit / Write
The hero heads to the Forge to write new code and edit files.
03 / Commands & tests
The Arena
Bash
Shell commands and tests bring the hero to the Arena.
04 / Debugging
The Alchemist
Debugging
When errors need fixing, the hero works at the Alchemist’s workshop.
05 / Thinking & planning
The Castle
Thinking
The Castle is where the hero goes while the agent reasons and plans its next steps.
06 / Reviewing & delegating
The Watchtower
Agent / review
The hero visits the Watchtower to review code and dispatch subagents.
07 / Git operations
The Chapel
Commit / Push / Merge
Commits, pushes and merges take the hero to the Chapel.
08 / Waiting
The Tavern
Idle
Between tasks, the hero rests at the Tavern while waiting for your input.
Current release / 0.3.1
More agents, more visibility into context
As skills, plugins and subagents multiply, understanding what fills each conversation becomes essential. Agent Quest 0.3.0 shows context usage in Claude Code and Codex, loaded instructions and how much delegated work returns to the parent.
Skills and context
Compare current usage with the available window and see which skills were loaded, how often and their estimated instruction size.
Distributed work
Follow agent families: subagent context peaks, returned results and material kept outside the main conversation.
Reports to improve
Export Markdown or JSON and review context, calls and delegation against the task’s objective, with another AI if useful.
Figures marked ~ are estimates. Context kept outside the main conversation is not a measurement of money saved.
The activity feed, party bar and detail panel keep the actual work close. Follow your agents across projects, including multiple Claude Code installations.
The village after dark, with weather effects.
The built-in map editor.
03 / Make it your own
Your party. Your corner of the world.
Move beyond the default layout with the built-in tile map editor. Shape your village, then watch its heroes go about their work.
04 / Begin your quest
From repository to village.
Install Bun 1.1 or later, then run these commands in your terminal.
git clone https://github.com/FulAppiOS/Agent-Quest.git
cd Agent-Quest
bun install
bun start
The dashboard opens at localhost:4445. Start a Claude Code or Codex session and your heroes appear.
Choose your platform
Manual installation supports macOS, Linux and Windows through WSL2. Codex has been tested on macOS; support on Linux and Windows is not yet verified.
On a Mac?
The repository also includes a guided one-line installer and an agentquest command for launching and updating your installation.
It monitors your existing Claude Code and Codex sessions. Continue using your coding tools as usual; the dashboard reflects their activity.
What do I need?
Bun 1.1 or later and a Claude Code or Codex installation with session logs. Without detected sessions, the dashboard opens but the village stays empty.
Can I view it from another device?
Yes, with optional LAN mode. By default, the servers listen only on localhost. LAN mode makes session details accessible to other people on the same network: enable it only on a trusted network. See the repository for setup details.
Agent Quest / Field notes
News & guides
Practical ways to follow your Claude Code and Codex sessions, solve setup issues and make the dashboard your own.
AGENT MONITORING / FANTASY WORLD
Browse all guides →
