codex-quest
v0.2.2
Published
Pixel-art RPG companion for Codex. Watch Codex reason, run commands, edit files, and quest through beautiful biomes as you code together.
Maintainers
Readme
Codex Quest
Pixel-art RPG companion for Codex sessions.
Codex Quest watches local Codex JSONL session logs and turns agent activity into animations: reasoning, shell commands, file edits, web searches, tool failures, plan updates, and context usage all become visible in a small Raylib window.
npm install -g codex-questRun it in a second terminal from the same project directory where Codex is working:
cxqUsage
cxq # Watch the current project's newest Codex session
cxq watch ~/dir # Watch a specific project's newest Codex session
cxq replay <file.jsonl> # Replay an existing Codex session
cxq doctor # Check paths, assets, and session JSONL structureCodex Quest reads sessions from:
~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonlThe live watcher selects the newest session whose session_meta.payload.cwd
matches the project being watched.
Development
go build -o cxq .
./cxq doctor
./cxq replay ~/.codex/sessions/YYYY/MM/DD/rollout-*.jsonl -s 20Studio mode is available in debug builds:
go build -tags debug -o cxq . && ./cxq studioRequires Go 1.21+ and CGO because Raylib uses C bindings.
