Agent Quest - v0.2.0

Agent Quest 0.2.0 — Ultra-mode agents & Retina-crisp rendering

Agent Quest now shows every hero that ultra mode spawns, names heroes after what they're actually doing, and renders the whole village at your display's native resolution.

This release adds support for Claude Code's ultra mode: workflow-orchestrated subagents — which previously never appeared on the map — now walk the village like any other hero. It also ships much sharper text and sprites on hi-DPI/Retina displays, smarter hero labels sourced from session metadata, and model badges for the new Claude 5 family (Fable and Mythos). Everything keeps working across both Claude Code and Codex.

Highlights

• Ultra-mode agents on the map — agents spawned by Claude Code's ultra mode / Workflow orchestration are now discovered and rendered live. Their transcripts live one level deeper than classic Task subagents (subagents/workflows/wf_<runId>/), so they were invisible before; orchestration journals and metadata files are filtered out so no phantom heroes appear.
• Smarter hero labels — subagent heroes are now named from the metadata the CLI writes next to each transcript. Classic Task subagents get their exact description (e.g. "Verify Claude Code lifecycle hooks"); workflow agents get an Explore: <task> style label instead of eight identical truncated prompts.
• Retina-crisp rendering — the Phaser canvas now renders at physical pixels instead of CSS pixels. On a Retina display that's 4× the pixels for the same screen area: building labels, hero name tags, and sprite art stop looking grainy. The canvas follows window resizes and live DPR changes (browser zoom, dragging the window between displays).
• Claude 5 model badges — heroes and the Detail Panel recognise claude-fable-5 with a dedicated FABLE badge, and unknown model families get an auto-derived badge and color — so Mythos models (claude-mythos-5) show a MYTHOS badge out of the box, no update required.

Notes

• Workflow agents follow the same rules as classic subagents: they appear on the map and in the Party Bar, but never fire notifications, so a large fan-out can't spam you.
• Hi-DPI rendering caps the backing store at 3× to keep VRAM bounded on high-density mobile screens.
• The map editor still renders at CSS resolution; it will pick up the same treatment in a future release.

Agent Quest - v0.1.0

Agent Quest 0.1.0 — Notifications & session report cards

Agent Quest now tells you the moment a hero needs you, and lets you review what each session actually did.

This release adds a full notification system (desktop, sound, and in-app toasts) that fires only when an agent has genuinely finished its turn or hit an error — plus a per-session Report card summarising activity, tools, files, and token usage. Everything works across both Claude Code and Codex.

Highlights

• Notifications — get a desktop notification, a sound, and a dismissable in-app toast when a main agent finishes its turn ("your move") or ends with an error. Alerts are debounced so mid-turn pauses never trigger false alarms, and subagents stay silent so the Task fan-out doesn't spam you.
• Notification center — a bell in the Top Bar with an unread badge and a dropdown history of recent alerts, each clickable to jump to the agent.
• Settings panel — a new ⚙️ menu to toggle desktop notifications, sounds (with volume), in-app toasts, per-category alerts, and a "do not disturb" switch. Preferences are saved locally.
• Reliable turn-end (optional) — one-click enable of a Claude Code Stop hook so turn completion is detected instantly and accurately. The hook is merged safely into your settings.json and removable just as easily. Claude-only; Codex reports turn-end natively.
• Clearer agent states — the waiting state ("finished, your move") is now shown consistently as a pill across the Party Bar, Detail Panel, and Top Bar, and no longer flickers back to active.
• Completed sessions — a collapsible "Completed" section in the Party Bar keeps finished sessions reviewable instead of letting them vanish.
• Session Report card — a new "Report" tab in the Detail Panel showing duration, tool calls, an activity breakdown, top tools, files changed, errors, and Claude token usage (input / output / cache read / cache write). Works for live and completed sessions, and for Codex (minus tokens).
• Mobile Top Bar — a hamburger drawer so the Top Bar works on phones.
• Improved building-label legibility under zoom.

Notes

• Notifications are computed in the browser. Desktop notifications require the browser's permission and are unreliable on Safari (an OS-level limitation) — the in-app toasts and sound work everywhere.
• The Stop hook integration is opt-in and Claude-only. With it off, Agent Quest still detects turn-end from the session logs, just slightly less precisely.
• The Report shows token counts (per session, excluding that session's subagents) — no dollar cost, to avoid per-model price drift. Codex doesn't report token usage, so its Report omits the token section.

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 / CODEX source badges across hero labels, Party Bar, Activity Feed, and Detail Panel.
• Added Claude model badges such as OPUS, SONNET, and HAIKU where 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

• HeroAvatar extracted as a reusable component for multiple sizes.
• New useFeedPrefs and usePartyPrefs hooks with debounced localStorage persistence and unmount flush.
• activityFeedUtils now 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:clicked and selection:changed events 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
  your machine (/.claude, ~/.claude-work, ~/.claude-personale, …) and
  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).