superdario 1.6.0

package/hooks/agent_from_env.sh

@@ -0,0 +1,9 @@
+#!/bin/sh
+# Sourced by the Claude Code hook scripts. Grok Build also runs ~/.claude/settings.json hooks (Claude compat mode)
+# and marks its hook processes with GROK_HOOK_EVENT: hand those over to Grok's own hook file when it exists,
+# otherwise report the event as Grok so the game plays as Grok instead of Claude.
+AGENT="claude"
+if [ -n "$GROK_HOOK_EVENT" ]; then
+  if [ -f "${GROK_HOME:-$HOME/.grok}/hooks/dario.json" ]; then exit 0; fi
+  AGENT="grok"
+fi

package/hooks/agent_hook.sh

@@ -0,0 +1,9 @@
+#!/bin/sh
+# Shared hook for Codex CLI and Grok Build: `agent_hook.sh <codex|grok> <event>`, event JSON on stdin.
+# Runs in the background so the agent is never delayed; prints nothing and exits 0 so nothing is blocked.
+AGENT="$1"
+EVENT="$2"
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+PAYLOAD="$(cat)"
+( printf '%s' "$PAYLOAD" | "$ROOT/bin/dario" hook "$EVENT" --agent "$AGENT" >/dev/null 2>&1 & )
+exit 0

package/hooks/notification.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+# Claude Code "Notification" hook: flags permission prompts and idle waits so the game can call you back.
+# Runs in the background so the prompt is never delayed; prints nothing so no context is injected.
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+. "$ROOT/hooks/agent_from_env.sh"
+PAYLOAD="$(cat)"
+( printf '%s' "$PAYLOAD" | "$ROOT/bin/dario" hook notification --agent "$AGENT" >/dev/null 2>&1 & )
+exit 0

package/hooks/post_tool_use.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+# Claude Code "post_tool_use" hook: a tool finished: the HUD goes back to thinking.
+# Runs in the background so the prompt is never delayed; prints nothing so no context is injected.
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+. "$ROOT/hooks/agent_from_env.sh"
+PAYLOAD="$(cat)"
+( printf '%s' "$PAYLOAD" | "$ROOT/bin/dario" hook post_tool_use --agent "$AGENT" >/dev/null 2>&1 & )
+exit 0

package/hooks/pre_tool_use.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+# Claude Code "pre_tool_use" hook: a tool is about to run: shows "Bash · npm test" style detail in the game HUD.
+# Runs in the background so the prompt is never delayed; prints nothing so no context is injected.
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+. "$ROOT/hooks/agent_from_env.sh"
+PAYLOAD="$(cat)"
+( printf '%s' "$PAYLOAD" | "$ROOT/bin/dario" hook pre_tool_use --agent "$AGENT" >/dev/null 2>&1 & )
+exit 0

package/hooks/stop.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+# Claude Code "Stop" hook: tells the running game that Claude has finished answering.
+# Runs in the background so the prompt is never delayed; prints nothing so no context is injected.
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+. "$ROOT/hooks/agent_from_env.sh"
+PAYLOAD="$(cat)"
+( printf '%s' "$PAYLOAD" | "$ROOT/bin/dario" hook stop --agent "$AGENT" >/dev/null 2>&1 & )
+exit 0

package/hooks/user_prompt_submit.sh

@@ -0,0 +1,8 @@
+#!/bin/sh
+# Claude Code "UserPromptSubmit" hook: marks Claude as working and opens Dario in a new terminal.
+# Runs in the background so the prompt is never delayed; prints nothing so no context is injected.
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+. "$ROOT/hooks/agent_from_env.sh"
+PAYLOAD="$(cat)"
+( printf '%s' "$PAYLOAD" | "$ROOT/bin/dario" hook user_prompt_submit --agent "$AGENT" >/dev/null 2>&1 & )
+exit 0

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "superdario",
+  "version": "1.6.0",
+  "description": "Super Dario: your coding agent's mascot in a terminal endless runner that opens on every Claude Code, Codex or Grok prompt.",
+  "keywords": [
+    "claude-code",
+    "codex",
+    "grok",
+    "terminal",
+    "game",
+    "endless-runner",
+    "mascot",
+    "hooks"
+  ],
+  "homepage": "https://dario-xxx.web.app",
+  "license": "MIT",
+  "author": "Eventually Solutions",
+  "type": "module",
+  "bin": {
+    "dario": "bin/dario"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "hooks",
+    "skills",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.18"
+  },
+  "os": [
+    "darwin"
+  ],
+  "scripts": {
+    "start": "bin/dario play",
+    "test": "node --test 'tests/**/*.test.ts'",
+    "typecheck": "tsc --noEmit",
+    "build:dist": "scripts/build_dist.sh",
+    "prepublishOnly": "npm test && scripts/build_dist.sh"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "esbuild": "^0.28.2",
+    "typescript": "^5.9.0"
+  }
+}

package/skills/dario/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: dario
+description: Dario is the Claude-mascot endless runner that lives in the terminal (Chrome dino style). Use for /dario, "play dario", "open the game", Dario scores/high score, turning Dario auto-launch on or off, picking the terminal it opens in, stopping the game, or installing/uninstalling its Claude Code hooks.
+allowed-tools: Bash(dario *), Bash(dario), Bash(~/.local/bin/dario *), Bash(~/.dario/app/bin/dario *)
+---
+
+# Dario
+
+Dario ("Super Dario") is a zero-dependency TypeScript terminal game (Node >= 22.18); `dario status`
+prints where it is installed (website installs live in `~/.dario/app`). Claude's orange pixel mascot runs forever
+Mario-style: stomps bugs (+100), bonks ? blocks that pop mushrooms or sponsor logos
+(+200 on pickup), jumps pipes, ducks under ghosts and collects gold tokens. The player is the
+agent the game was launched from (Claude from the Claude Code hook; Codex/Grok detected from env
+or set with `dario character`), and the other two agents are the stompable enemies.
+Score = distance + 25 per coin + bonuses (no token counter in the HUD). Best scores live in `~/.config/dario/scores.json`.
+The run starts with 3 lives: a hit costs one (short blink of invulnerability), some ? blocks pop a heart (1-UP)
+that adds a life (credited to the sponsor whose block it came from). Two modes: VIBE CODER (default, play any
+time) and PRO CODER (the game only runs while the agent is working on a prompt; start/resume are locked otherwise).
+There is a global leaderboard in Firebase (project `dario-xxx`, Firestore `players`
+collection, anonymous auth session in `~/.config/dario/auth.json`). On the first play
+the game proposes the GitHub login (via `gh`), else the git user name, as the player
+name with a `[Y/n]` prompt; `dario name <new>` changes it. Game over shows the global
+top 5 and the player's rank.
+
+The CLI is `dario` (symlinked into `~/.local/bin`). If that is not on PATH use
+`~/.local/bin/dario` or `~/.dario/app/bin/dario` instead. `dario update` fetches the newest
+release from https://dario-xxx.web.app (npm installs update with `npm install -g superdario@latest`).
+
+## How Dario connects to Claude Code
+
+`dario install` writes three hooks into `~/.claude/settings.json`:
+
+| Hook               | Effect                                                                                 |
+| ------------------ | -------------------------------------------------------------------------------------- |
+| `UserPromptSubmit` | marks Claude as *working* and opens Dario in a new terminal tab/window (once, pid-locked) |
+| `Stop`             | marks Claude as *done*; the game shows a "CLAUDE IS DONE" banner                       |
+| `Notification`     | permission / idle prompts mark *attention*; the game shows "CLAUDE NEEDS YOUR INPUT"   |
+| `PreToolUse` / `PostToolUse` | the HUD shows what Claude is doing ("Bash · npm test", "Edit · game.ts") and rotating thinking verbs in between |
+
+So while a prompt is executing the user can play, and the HUD tells them when to
+come back. On *done* / *attention* the game auto-pauses and, if `dario focus` is
+on, the hook re-activates the app the prompt was sent from (captured at prompt
+time; from Warp it also sends Cmd+Shift+[ to go to the previous tab). The hook launches in the terminal the user is in (Warp, iTerm, Terminal,
+Ghostty, WezTerm, kitty, Alacritty, Tabby, Rio) or, with the launcher extension, inside the integrated
+terminal of Cursor, VS Code, VS Code Insiders, VSCodium, Windsurf, Kiro or Trae. `dario off` pauses the auto-launch, `dario on` resumes it.
+
+The same hooks exist for OpenAI Codex CLI (`~/.codex/hooks.json`) and xAI Grok Build
+(`~/.grok/hooks/dario.json`); `dario install` writes them when those folders exist, `dario agents`
+shows/changes them, and the game then plays as Codex or Grok. Codex users must approve the hooks once
+with `/hooks` inside Codex.
+
+## What to run for `$ARGUMENTS`
+
+Never run `dario play` from Claude: it needs an interactive TTY and would hang the tool.
+Always open the game with `dario launch`.
+
+| User intent                                   | Command                        |
+| --------------------------------------------- | ------------------------------ |
+| `/dario`, "play", "open the game", "start"    | `dario launch`                 |
+| "stop", "close the game"                      | `dario stop`                   |
+| "scores", "high score", "how am I doing"      | `dario scores` (or `--json`)   |
+| "ranking", "leaderboard", "who is first"      | `dario ranking` (`--pro` for the PRO CODER board, `--json`) |
+| "my name", "change name to X"                 | `dario name` / `dario name X`  |
+| "sponsors", "who sponsors the game"           | `dario sponsors`               |
+| "play as codex/grok", "character"             | `dario character <auto|claude|codex|grok>` (or `dario launch --as grok`) |
+| "pro mode", "vibe mode", "only while working" | `dario mode <vibe|pro>`        |
+| "status", "is it running", "are hooks on"     | `dario status`                 |
+| "on", "enable", "auto-launch on"              | `dario on`                     |
+| "off", "disable", "stop opening every prompt" | `dario off`                    |
+| "focus on/off", "don't switch me back"        | `dario focus <on|off>`         |
+| "terminal iterm" / "use warp"                 | `dario terminal <kind>`        |
+| "open it in Cursor / VS Code / Windsurf ..."  | `dario ide <cursor|vscode|vscode_insiders|vscodium|windsurf|kiro|trae>` (installs the launcher extension; reload the IDE window once) |
+| "hook it into Codex / Grok", "agents"         | `dario agents` (status) / `dario agents codex` / `dario agents grok` / `... off` |
+| "install", "set up hooks"                     | `dario install` then ask where it should open (see below) |
+| "uninstall", "remove hooks"                   | `dario uninstall`              |
+| "help"                                        | `dario help`                   |
+
+## Installing from the skill
+
+`dario install` cannot prompt when Claude runs it (no TTY), so do the wizard yourself:
+1. Run `dario install`.
+2. Run `dario terminal --list` and ask the user (AskUserQuestion) which entry they want; mark the
+   `(detected)` one as recommended.
+3. Apply it: `dario terminal <kind>` for a terminal app, or `dario ide <kind>` for an IDE (this
+   installs the Dario Launcher extension; tell the user to reload the IDE window once and allow the
+   URI the first time).
+4. If the install output lists Codex hooks as installed, remind the user to approve them once with
+   `/hooks` inside Codex.
+
+After running a command, relay the output briefly. For scores, summarise the
+high score, last score and token totals in one or two sentences.
+
+## Controls (for when the user asks)
+
+hold RIGHT / D = run, release to stop (macOS key-state helper, terminal-independent), LEFT / A = walk back on screen, C = settings panel on the title/pause screen,
+SPACE / UP / W = jump, DOWN / S = duck (also fast-fall mid-air), P = pause, R = restart, Q / ESC = quit.
+
+## Sponsors
+
+Sponsors buy a tier on https://dario-xxx.web.app/sponsor (Polar checkout via Cloud
+Functions in `functions/`), then draw or upload a pixel logo. Mystery box sponsors pay what they choose (from $29 / 30 days; the amount is their rank). Banner ($69.90 a day) and ranking ($29.90 a day, name only)
+sponsors book UTC days on a 30-day calendar; the game shows whoever booked today. Active sponsors are read
+from Firestore `sponsors` (status == active) and cached in `~/.config/dario/sponsors.json`
+for an hour. A *mystery* sponsor's logo (16×12 sextant pixel art or a coloured text plate) pops out of the blinking ? blocks and pays +300 points (growing by 100 each pickup) when grabbed;
+mystery sponsors are ranked (priority field, then who paid first): the top one gets the most blocks and the first block of a run.
+the day's *banner* sponsor (66×20, booked per day, the size of the title plate) sits next to the SUPER DARIO plate on the start screen and on top of the pause and game-over screens, with "sponsored by NAME" above it. Logo cells and the "sponsored by" line are OSC 8 hyperlinks.
+
+## Project layout
+
+- `src/game/` physics, spawning, collision, the `Game` loop
+- `src/render/` half-block pixel renderer, sprites, HUD, overlays
+- `src/launcher/` terminal detection and "open in new tab" strategies, pid lock
+- `src/claude/` status file watcher/writer, hook service, settings.json installer
+- `src/agents/` Codex / Grok hook-file installers; `src/ide/` the launcher extension for VS Code-style IDEs
+- `src/cli/` commands; `hooks/` the shell scripts Claude Code invokes
+- `npm test` runs the node:test suite, `npm run typecheck` runs tsc