Claude Quest

For Claude Code users who want to actually see what their AI is doing.

Instead of watching text scroll by in a terminal, Claude Quest shows you a pixel-art character that reacts to every action in real-time. Reading files? Casting a spell. Running bash? Swinging into battle. Error? Taking damage. Success? Victory dance.

npm install -g claude-quest
cq

That's it. Open it alongside Claude Code and watch your coding session come alive.

Who This Is For

• Long session coders - Makes 4-hour Claude Code sessions feel like a co-op adventure
• Streamers & content creators - Your viewers see exactly what Claude is doing, beautifully
• Pixel art lovers - Paul Robertson-inspired animations that are genuinely gorgeous
• Anyone who thinks coding should be more fun - Because it should

Who This Isn't For

• People who find visual feedback distracting
• Minimalists who want nothing but terminal

What You Get

Real-Time Visualization

Every Claude Code action becomes an animation:

| Claude Action | What You See | |--------------|-----------| | Reading files | Casting spell | | Bash commands | Attack animation | | Writing code | Scribbling away | | Thinking | Contemplating | | Extended thinking | Intense focus + particle effects | | Success | Victory dance | | Error | Taking damage (recovers!) |

Two Modes

Vibin' - A cozy wizard's study. Flickering candles, twinkling stars through the window, bubbling potions. For focused work.

Quest! - Claude walks through four parallax biomes that cycle every 20 seconds:

• Enchanted Forest (fireflies, glowing mushrooms)
• Mountain Journey (snow peaks, pine forests)
• Midnight Quest (starlit ruins, crystal caves)
• Kingdom Road (castles, windmills)

The Mana Bar

Shows your remaining context window. Starts full at 200k tokens and drains as your conversation grows. When Claude compacts, it refills. Satisfying.

Customization

Hats and accessories. Wizard hat, crown, deal-with-it sunglasses. Because why not.

Installation

npm

npm install -g claude-quest

Direct Download

GitHub Releases - macOS, Linux, Windows

Usage

cq              # Watch current project
cq demo         # See all animations (no Claude Code needed)
cq watch ~/dir  # Watch specific project

Controls: W toggle walk mode, Tab toggle picker, ↑↓←→ customize accessories

How It Works

Reads Claude Code's local conversation logs (JSONL files). No API keys. No network calls. Just file watching.

The Craft

Inspired by Paul Robertson's legendary pixel art:

• 320x200 resolution (DOS-era homage)
• 24fps hand-crafted animations
• Secondary motion on everything (bob, sway, breathe)
• Atmospheric details (particles, flames, stars)

FAQ

Is this official? Community project. Not affiliated with Anthropic.

Works without Claude Code? Yes. cq demo runs standalone.

Why does this exist? Because staring at terminal text for hours is less fun than watching a pixel wizard battle bugs.

Development

Building from Source

git clone https://github.com/Michaelliv/claude-quest.git
cd claude-quest
go build -o cq .

Requires Go 1.21+ and CGO (Raylib needs C bindings).

Studio Mode

Studio mode is a development environment for working on sprites and animations. Not included in release builds.

go build -tags debug -o cq . && ./cq studio

Features:

• Animation picker (A) - Select and loop any animation
• Biome picker (B) - Switch between all 5 biomes
• Cosmetics picker (C/Tab) - Browse hats, faces, auras, trails
• Frame stepping - Pause (Space) and step through frames (< >)
• Speed control (- +) - Slow down to 0.125x or speed up to 4x
• Hot reload - Edit PNGs and see changes instantly, R to force reload
• Sprite regeneration (G) - Regenerate sprites from cmd/spritegen

See CLAUDE.md for full architecture details.

License

MIT