by FulAppiOS
Real-time gamified dashboard for monitoring Claude Code and Codex AI agents in a medieval fantasy setting
# Add to your Claude Code skills
git clone https://github.com/FulAppiOS/Agent-QuestLast scanned: 8/24/2026
{
"issues": [
{
"file": "README.md",
"line": 57,
"type": "remote-install",
"message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://bun.sh/install | bash\"",
"severity": "low"
}
],
"status": "PASSED",
"scannedAt": "2026-08-24T04:43:07.949Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}Agent-Quest is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by FulAppiOS. Real-time gamified dashboard for monitoring Claude Code and Codex AI agents in a medieval fantasy setting. It has 108 GitHub stars.
Yes. Agent-Quest passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/FulAppiOS/Agent-Quest" and add it to your Claude Code skills directory (see the Installation section above).
Agent-Quest is primarily written in TypeScript. It is open-source under FulAppiOS on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh Agent-Quest against similar tools.
No comments yet. Be the first to share your thoughts!
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Use Claude Code CLI or Codex as usual — each agent session auto-spawns a hero on the dashboard, live.
Agent Quest is a browser-based monitoring dashboard that visualizes active Claude Code and Codex agent sessions as fantasy heroes in a 2D village. Each running agent becomes a hero who walks between buildings based on what it's doing: Read sends it to the Library, Edit to the Forge, Bash to the Arena, and so on.
Claude Code and Codex sessions happen in a terminal — useful, but not very alive. When you run several agents at once (across projects, across ~/.claude* installations and ~/.codex), it's hard to feel what they're actually doing. Agent Quest turns that invisible activity into something you can glance at: a little village where every hero is an agent, and where they walk tells you what they're up to.
~/.claude* directory (supports multiple installations like ~/.claude-work, ~/.claude-personale) and of ~/.codex if presentpostToolUse hooks — Claude Code only; Codex doesn't expose hooks)Required
curl -fsSL https://bun.sh/install | bash~/.claude* directories, and/or ~/.codex, with session logs). Without either, the dashboard still starts, but the village stays empty and a banner tells you so.Optional
npm run … command form. If you only have Bun installed, every npm run X in this README has an equivalent bun run X.Agent Quest can be set up in two equivalent ways — pick the one that matches your platform:
git clone + bun install + bun start. Three commands, full control, works everywhere (macOS, Linux, Windows via WSL2).curl | bash that installs Bun if missing, clones the repo, installs dependencies, creates a global agentquest command, and launches the app.They do the same work under the hood. Every daily command has an equivalent:
| With the CLI | Without (classic) |
|---|---|
agentquest |
bun start |
agentquest update |
git pull --ff-only && bun install |
agentquest update is a convenience command for end users running an installed copy that tracks origin/main. It is not the contributor workflow for feature branches.
Three commands — works on macOS, Linux, and Windows via WSL2:
git clone https://github.com/FulAppiOS/Agent-Quest.git
cd Agent-Quest
bun install
bun start
That's it: your browser opens on http://localhost:4445 and the village appears.
Optional — create an agentquest shortcut so you can launch from any directory:
mkdir -p ~/.local/bin
ln -s "$PWD/bin/agentquest" ~/.local/bin/agentquest
After the symlink you can run agentquest (alias of bun start) and agentquest update (alias of git pull --ff-only && bun install) from anywhere.
Agent Quest ships with a bundled CC0 pixel-art sprite pack (under client/public/assets/themes/tiny-swords-cc0/), so there's nothing else to download.
The one-line installer script is macOS-only; Agent Quest itself runs on macOS and Linux, and via WSL2 on Windows — see the manual install above.
curl -fsSL https://raw.githubusercontent.com/FulAppiOS/Agent-Quest/main/install.sh | bash
The installer prints exactly what it's going to do and asks before touching anything. It checks/installs Bun, clones into ~/agent-quest (override with --dir <path>), runs bun install, creates an agentquest shortcut in ~/.local/bin/, and offers to launch right away. When it finishes, your browser opens on http://localhost:4445 and the village appears.
From the next session onwards:
agentquest # same as `agentquest start` — launches and opens the browser
agentquest update # git pull + bun install (preserves local map edits)
bun: command not found — install Bun first, then re-run the Quick start:
curl -fsSL https://bun.sh/install | bash
Cannot find module … on startup — dependencies weren't installed. From the repo root:
bun install
EADDRINUSE on port 4444 or 4445 — another process holds the port. Either free it or override the port via env (see Configuration). To see what is holding it and kill it:
lsof -ti:4444,4445 | xargs kill -9
agentquest: command not found after install — ~/.local/bin is not in your $PATH. Add it:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
Empty village with a "No Claude Code or Codex installation detected" banner — expected when no ~/.claude* or ~/.codex directory with session logs exists. Start a Claude Code or Codex session and heroes appear automatically (the banner disappears on its own).
Assets look broken or the app blocks at boot with "missing asset" screens — see Missing assets.
Defaults work out of the box. To customize ports or URLs, copy the example env files:
cp server/.env.example server/.env
cp client/.env.example client/.env
| Variable | Where | Default | Purpose |
|---|---|---|---|
PORT |
server | 4444 |
HTTP + WebSocket port |
CLIENT_URL |
server | http://localhost:4445 |
CORS origin |
CLIENT_PORT |
client | 4445 |
Vite dev server port |
VITE_SERVER_URL |
client | http://localhost:4444 |
Server HTTP base |
VITE_WS_URL |
client | ws://localhost:4444/ws |
Server WebSocket URL |
npm start # server + client concurrently (or: bun start)
npm run dev:server # server only (:4444) (or: bun run dev:server)
npm run dev:client # client only (:4445) (or: bun run dev:client)
npm run check:assets # verify every bundled sprite is on disk (or: bun run check:assets)
cd server && bun test # run server tests
For installed end-user copies that follow main, agentquest update runs the equivalent of git pull --ff-only && bun install while preserving local map edits. Contributors on feature branches should use normal Git commands instead.
If you accidentally delete or move files under client/public/assets/themes/tiny-swords-cc0/ (hero spritesheets, building PNGs, terrain, decorations), Agent Quest will tell you:
bun run check:assets any time to verify the whole bundled pack ahead of starting the app. Exits non-zero with a detailed list if anything is missing — good for CI or pre-commit.Restore with:
git checkout -- client/public/assets/themes/tiny-swords-cc0/
By default the dev servers only listen on localhost for security. To share the village with other devices on the same Wi-Fi (phone, tablet, another laptop), opt in with a single env flag:
# macOS / Linux — one-off, for this run only
AGENT_QUEST_LAN=1 agentquest # (or: AGENT_QUEST_LAN=1 bun start)
# Permanent — decide once, then just run `agentquest`
echo "AGENT_QUEST_LAN=1" >> ~/agent-quest/server/.env
echo "AGENT_QUEST_LAN=1" >> ~/agent-quest/client/.env
agentquest
Any env var documented in this README works identically with agentquest — just prefix it on the command line, or add it to the two .env files for a persistent choice.
At startup the server prints reachable LAN URLs, for example:
[Server] LAN mode enabled — reachable from other devices at:
[Server] http://192.168.1.42:4444 (API) | http://192.168.1.42:4445 (UI)
Open the UI URL on the other device. The client auto-detects the host s