Releases: FulAppiOS/Agent-Quest
Agent Quest - v0.0.3
Agent Quest 0.0.3 — Codex agents join the village
Agent Quest now supports both Claude Code and Codex agents.
This release turns Agent Quest into a dual-provider dashboard: keep using Claude Code or Codex as usual, and each active session appears live as a hero in the same fantasy village. Codex sessions are discovered from ~/.codex/sessions/, while Claude Code support continues to work with existing ~/.claude* installations.
Highlights
- Added first-class Codex agent support with a new Codex provider and rollout log parser.
- Claude Code and Codex providers now run side by side and feed the same real-time dashboard.
- Added
CLAUDE/CODEXsource badges across hero labels, Party Bar, Activity Feed, and Detail Panel. - Added Claude model badges such as
OPUS,SONNET, andHAIKUwhere model metadata is available. - Updated README, installer, CLI help text, tutorial, and empty-state copy to describe Claude Code + Codex support.
- Reworked the missing-install banner so it only warns when neither Claude Code nor Codex is available.
- Improved Detail Panel handling for long agent replies with a full-message modal.
- Added reliability fixes for Codex log watching, including partial JSONL buffering, stale rollout resume handling, malformed timestamp guards, and scan re-entrancy protection.
- Improved mixed-agent UI readability with source colors, expanded hero label colors, and cleaner Party Bar / Activity Feed layout.
- Fixed village interaction details, including building info panel positioning and empty-map deselection behavior.
Notes
Codex support has been tested on macOS. Windows and Linux support for Codex should work through the same ~/.codex/sessions/ log structure, but it has not been verified yet.
Claude Code’s optional low-latency postToolUse hook path remains Claude-only because Codex does not currently expose equivalent hooks.
Agent Quest 0.0.2
v0.0.2 — UI Refinements
This release focuses on the React overlays and hero selection flow. The Activity Feed, Party Bar, Detail Panel, and village selection now share clearer visual states, better agent identity, and more consistent styling.
Activity Feed
- New full / compact / closed fold states, persisted via localStorage, with a taller full view.
- Auto-detected category pills for Errors, Edits, Bash, Reads, Messages, Agent, and Other, with per-category row highlighting and live counters.
- Prompt and Reply entries rendered inline with markdown, visually distinct from tool rows.
- Per-row selection plus agent filtering from the feed.
- Scroll pinning, a Jump to latest button when you scroll back, and a new-entry badge while the feed is closed.
- VS Code path links with proper URL encoding.
- Right-click context menu actions for copying the path, copying detail, or filtering by agent.
Subagents
Subagents spawned via the Agent tool are now easier to identify across the UI:
- Readable names resolved server-side from the parent session's Agent tool input, with sensible fallbacks.
- A "subagent" marker rendered above spawned helpers in the village.
- Agent tool events grouped under their own Agent highlight category in the feed.
Party Bar
- Rewritten with full and icon-only fold states.
- Larger avatars (up to 66px) with a shared status overlay dot.
- Selection flash and pulse when a hero is selected.
- Shows active and idle agents only, sorted by status priority.
Hero Selection In The Village
- Hero sprites are now clickable in the Phaser scene.
- Selected heroes use a soft radial-gradient halo instead of flat sprite tinting.
- Clicking the background clears selection.
- Selection is now synchronized across the village, Party Bar, Activity Feed, and Detail Panel.
Detail Panel
Reworked for readability and freshness:
- Hero avatar and status dot in the header, with a larger hero-colored serif name.
- Larger typography, better spacing, and tabular numerics.
- A 1s ticker keeps Session duration fresh between server pushes.
- Current File, Current Command, and Last Message are hidden automatically when the agent is no longer live, to avoid stale "current" data.
- VS Code path links for Current File, Project, and Files Modified.
- Error sections now use their own tinted treatment, aligned with feed styling.
Color System
A more consistent color system replaces the previous mix of ad-hoc values:
- Shared hero palette (
HERO_LABEL_COLOR) reused across Phaser labels, Party Bar, Activity Feed, and Detail Panel. - Server-side color deduplication so agents with the same derived name do not immediately collide on the same color.
- Shared category palette for feed highlights.
- Shared status palette for Party Bar and Detail Panel indicators.
Shared Components And Utilities
HeroAvatarextracted as a reusable component for multiple sizes.- New
useFeedPrefsandusePartyPrefshooks with debounced localStorage persistence and unmount flush. activityFeedUtilsnow handles filtering, category detection, and path resolution, with unit test coverage.
Cleanup
- Removed the "By Agent" feed view.
- Replaced feed-row selection pulse with a simpler static highlight.
- Pruned dead CSS and legacy panel styling in the updated UI.
Under The Hood
- Added
hero:clickedandselection:changedevents for Phaser ↔ React selection sync. - Reduced-motion support for feed and Party Bar animations.
- Server now broadcasts Prompt and Reply activity log entries.
Known Limitations
- The Detail Panel still does not show real token usage or cost. The server initializes those fields to zero and does not populate them yet.
- Status transitions can still lag by about 10 seconds because agent state is re-derived on a periodic tick.
Full changelog: v0.0.1...v0.0.2
Agent Quest v0.0.1
Turn your Claude Code sessions into a living fantasy village. Every
running agent becomes a hero who walks between buildings based on what
it's doing: Read → Library, Edit → Forge, Bash → Arena, thinking → Castle,
and so on.
Highlights
- Zero-config auto-discovery — picks up every
/.claude* installation on/.claude, ~/.claude-work, ~/.claude-personale, …) and
your machine (
streams their sessions live. - Real-time dashboard — Party Bar, Activity Feed, Detail Panel, Minimap,
day/night cycle, rain + lightning, pan & zoom with touch support for
tablets. - Map editor — 5 slots, terrain/decorations/paths/NPCs, load the shipped
template or start from scratch, switch the active map on the fly. - Cross-platform CLI — one-line installer (curl … | bash) plus the
agentquest command (start, update, --help). - CC0 artwork — built on the Tiny Swords pixel-art pack by Pixel Frog (CC0
1.0).