pi-extensions 0.1.9

package/agent-guidance/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@tmustier/pi-agent-guidance",
+  "version": "0.1.0",
+  "description": "Loads provider-specific context files (CLAUDE.md, CODEX.md, GEMINI.md) based on current model.",
+  "license": "MIT",
+  "author": "Thomas Mustier",
+  "keywords": [
+    "pi-package"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tmustier/pi-extensions.git",
+    "directory": "agent-guidance"
+  },
+  "bugs": "https://github.com/tmustier/pi-extensions/issues",
+  "homepage": "https://github.com/tmustier/pi-extensions/tree/main/agent-guidance",
+  "pi": {
+    "extensions": [
+      "agent-guidance.ts"
+    ]
+  }
+}

package/agent-guidance/setup.sh

@@ -0,0 +1,75 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+PI_AGENT_DIR="$HOME/.pi/agent"
+
+echo "Setting up agent-guidance..."
+mkdir -p "$PI_AGENT_DIR/extensions"
+
+AGENTS_FILE="$PI_AGENT_DIR/AGENTS.md"
+CLAUDE_FILE="$PI_AGENT_DIR/CLAUDE.md"
+
+create_placeholder() {
+    cat > "$AGENTS_FILE" << 'EOF'
+# AGENTS.md
+
+Universal guidelines for all AI models.
+
+<!-- Add your cross-model guidance here -->
+EOF
+}
+
+# Handle missing AGENTS.md
+if [ ! -f "$AGENTS_FILE" ]; then
+    if [ -f "$CLAUDE_FILE" ] || [ -L "$CLAUDE_FILE" ]; then
+        echo ""
+        echo "  ⚠️  No AGENTS.md found in $PI_AGENT_DIR/"
+        echo "     You have an existing CLAUDE.md which was being used by Pi"
+        echo "     across all models - if you want that guidance to continue"
+        echo "     to apply across all models, it should be in AGENTS.md."
+        echo ""
+        read -p "     Copy CLAUDE.md content to AGENTS.md? [y/N] " -n 1 -r
+        echo ""
+        if [[ $REPLY =~ ^[Yy]$ ]]; then
+            cp "$CLAUDE_FILE" "$AGENTS_FILE"
+            echo "     Copied CLAUDE.md → AGENTS.md"
+            echo "     CLAUDE.md kept for Claude-specific guidance (edit as needed)."
+        else
+            create_placeholder
+            echo "     Created placeholder AGENTS.md."
+        fi
+        echo ""
+    else
+        create_placeholder
+        echo ""
+        echo "  ⚠️  No AGENTS.md found - created placeholder."
+        echo "     Add your cross-model guidance there."
+        echo ""
+    fi
+fi
+
+# Symlink extension
+target="$PI_AGENT_DIR/extensions/agent-guidance.ts"
+if [ -L "$target" ]; then
+    echo "  agent-guidance.ts already linked"
+else
+    ln -sf "$SCRIPT_DIR/agent-guidance.ts" "$target"
+    echo "  Linked agent-guidance.ts"
+fi
+
+echo ""
+echo "Done!"
+echo ""
+echo "Template provider files in $SCRIPT_DIR/templates/:"
+echo "  CLAUDE.md  (Anthropic)"
+echo "  CODEX.md   (OpenAI)"
+echo "  GEMINI.md  (Google)"
+echo ""
+echo "To install:"
+echo "  ln -s $SCRIPT_DIR/templates/CLAUDE.md $PI_AGENT_DIR/"
+echo "  ln -s $SCRIPT_DIR/templates/CODEX.md $PI_AGENT_DIR/"
+echo "  ln -s $SCRIPT_DIR/templates/GEMINI.md $PI_AGENT_DIR/"
+echo ""
+echo "Or all:"
+echo "  ln -s $SCRIPT_DIR/templates/*.md $PI_AGENT_DIR/"

package/agent-guidance/templates/CLAUDE.md

@@ -0,0 +1,5 @@
+# CLAUDE.md
+
+Claude-specific guidelines. Loaded when using Anthropic models.
+
+<!-- Add your Claude-specific preferences here -->

package/agent-guidance/templates/CODEX.md

@@ -0,0 +1,92 @@
+# CODEX.md
+
+Adapted from [steipete/agent-scripts](https://github.com/steipete/agent-scripts/blob/main/AGENTS.MD).
+
+Work style: telegraph; noun-phrases ok; drop grammar; min tokens.
+
+## Agent Protocol
+- PRs: use `gh pr view/diff` (no URLs).
+- Guardrails: use `trash` for deletes when available.
+- Need upstream file: stage in `/tmp/`, then cherry-pick; never overwrite tracked.
+- Bugs: add regression test when it fits.
+- Keep files <~500 LOC; split/refactor as needed.
+- Commits: Conventional Commits (`feat|fix|refactor|build|ci|chore|docs|style|perf|test`).
+- CI: `gh run list/view` (rerun/fix til green).
+- Prefer end-to-end verify; if blocked, say what's missing.
+- New deps: quick health check (recent releases/commits, adoption).
+- Web: search early; quote exact errors; prefer 2024–2025 sources.
+- Style: telegraph. Drop filler/grammar. Min tokens.
+
+## Screenshots
+- Size: `sips -g pixelWidth -g pixelHeight <file>` (prefer 2×).
+- Optimize: `imageoptim <file>` (install: `brew install imageoptim-cli`).
+- Replace asset; keep dimensions; commit; run gate; verify CI.
+
+## Docs
+- Start: check for docs list script; open docs before coding.
+- Follow links until domain makes sense.
+- Keep notes short; update docs when behavior/API changes (no ship w/o docs).
+
+## PR Feedback
+- Active PR: `gh pr view --json number,title,url --jq '"PR #\\(.number): \\(.title)\\n\\(.url)"'`.
+- PR comments: `gh pr view …` + `gh api …/comments --paginate`.
+- Replies: cite fix + file/line; resolve threads only after fix lands.
+- When merging a PR: thank the contributor in `CHANGELOG.md`.
+
+## Flow & Runtime
+- Use repo's package manager/runtime; no swaps w/o approval.
+- Use background tasks for long jobs; tmux only for interactive/persistent (debugger/server).
+
+## Build / Test
+- Before handoff: run full gate (lint/typecheck/tests/docs).
+- CI red: `gh run list/view`, rerun, fix, push, repeat til green.
+- Keep it observable (logs, panes, tails).
+
+## Git
+- Safe by default: `git status/diff/log`. Push only when user asks.
+- `git checkout` ok for PR review / explicit request.
+- Branch changes require user consent.
+- Destructive ops forbidden unless explicit (`reset --hard`, `clean`, `restore`, `rm`, …).
+- Don't delete/rename unexpected stuff; stop + ask.
+- No repo-wide S/R scripts; keep edits small/reviewable.
+- Avoid manual `git stash`; if Git auto-stashes during pull/rebase, that's fine.
+- If user types a command ("pull and push"), that's consent for that command.
+- No amend unless asked.
+- Big review: `git --no-pager diff --color=never`.
+- Multi-agent: check `git status/diff` before edits; ship small commits.
+
+## Language/Stack Notes
+- Swift: validate `swift build` + tests; keep concurrency attrs right.
+- TypeScript: use repo PM; keep files small; follow existing patterns.
+
+## Critical Thinking
+- Fix root cause (not band-aid).
+- Unsure: read more code; if still stuck, ask w/ short options.
+- Conflicts: call out; pick safer path.
+- Unrecognized changes: assume other agent; keep going; focus your changes. If it causes issues, stop + ask user.
+- Leave breadcrumb notes in thread.
+
+## Tools
+
+### trash
+- Move files to Trash: `trash …` (safer than rm).
+
+### gh
+- GitHub CLI for PRs/CI/releases. Given issue/PR URL: use `gh`, not web search.
+- Examples: `gh issue view <url> --comments -R owner/repo`, `gh pr view <url> --comments --files -R owner/repo`.
+
+### tmux
+- Use only when you need persistence/interaction (debugger/server).
+- Quick refs: `tmux new -d -s shell`, `tmux attach -t shell`, `tmux list-sessions`, `tmux kill-session -t shell`.
+
+<frontend_aesthetics>
+Avoid "AI slop" UI. Be opinionated + distinctive.
+
+Do:
+- Typography: pick a real font; avoid Inter/Roboto/Arial/system defaults.
+- Theme: commit to a palette; use CSS vars; bold accents > timid gradients.
+- Motion: 1–2 high-impact moments (staggered reveal beats random micro-anim).
+- Background: add depth (gradients/patterns), not flat default.
+
+Avoid: purple-on-white clichés, generic component grids, predictable layouts.
+</frontend_aesthetics>

package/agent-guidance/templates/GEMINI.md

@@ -0,0 +1,5 @@
+# GEMINI.md
+
+Gemini-specific guidelines. Loaded when using Google models.
+
+<!-- Add your Gemini-specific preferences here -->

package/arcade/CHANGELOG.md

@@ -0,0 +1,4 @@
+# Changelog
+
+## 0.1.0 - 2026-01-13
+- Initial release.

package/arcade/README.md

@@ -0,0 +1,85 @@
+# arcade
+
+[Snake](https://github.com/badlogic/pi-mono/blob/main/packages/coding-agent/examples/extensions/snake.ts) is cool, but have you tried:
+
+- **sPIce-invaders** (`/spice-invaders`) - type `clawd` for a special challenge that gets harder every level
+- **picman** (`/picman`)
+- **ping** (`/ping`) - in a similar vein to [patriceckhart's](https://github.com/patriceckhart/pi-ng-pong)
+- **tetris** (`/tetris`)
+- **mario-not** (`/mario-not`) - Mario-style platformer (experimental)
+
+<table>
+  <tr>
+    <td><img src="assets/spice-invaders.png" width="400"/></td>
+    <td><img src="assets/picman.png" width="400"/></td>
+  </tr>
+  <tr>
+    <td><img src="assets/ping.png" width="400"/></td>
+    <td><img src="assets/tetris.png" width="400"/></td>
+  </tr>
+</table>
+
+## Install
+
+### Pi package manager
+
+```bash
+pi install npm:@tmustier/pi-arcade
+```
+
+```bash
+pi install git:github.com/tmustier/pi-extensions
+```
+
+Then filter to just the games in `~/.pi/agent/settings.json`:
+
+```json
+{
+  "packages": [
+    {
+      "source": "git:github.com/tmustier/pi-extensions",
+      "extensions": [
+        "arcade/spice-invaders.ts",
+        "arcade/picman.ts",
+        "arcade/ping.ts",
+        "arcade/tetris.ts",
+        "arcade/mario-not/mario-not.ts"
+      ]
+    }
+  ]
+}
+```
+
+### Local clone
+
+```bash
+# All games
+ln -s ~/pi-extensions/arcade/*.ts ~/.pi/agent/extensions/
+ln -s ~/pi-extensions/arcade/mario-not/mario-not.ts ~/.pi/agent/extensions/
+
+# Or individual games
+ln -s ~/pi-extensions/arcade/spice-invaders.ts ~/.pi/agent/extensions/
+ln -s ~/pi-extensions/arcade/picman.ts ~/.pi/agent/extensions/
+ln -s ~/pi-extensions/arcade/ping.ts ~/.pi/agent/extensions/
+ln -s ~/pi-extensions/arcade/tetris.ts ~/.pi/agent/extensions/
+ln -s ~/pi-extensions/arcade/mario-not/mario-not.ts ~/.pi/agent/extensions/
+```
+
+Or add to `~/.pi/agent/settings.json`:
+
+```json
+{
+  "extensions": [
+    "~/pi-extensions/arcade/spice-invaders.ts",
+    "~/pi-extensions/arcade/picman.ts",
+    "~/pi-extensions/arcade/ping.ts",
+    "~/pi-extensions/arcade/tetris.ts",
+    "~/pi-extensions/arcade/mario-not/mario-not.ts"
+  ]
+}
+```
+
+## Changelog
+
+See `CHANGELOG.md`.
+

package/arcade/mario-not/README.md

@@ -0,0 +1,30 @@
+# mario-not (experimental)
+
+Mario-style TUI platformer. This project is experimental and tuning is in flux.
+
+## Run
+
+- Command: `/mario-not`
+- Extension entrypoint: `arcade/mario-not/mario-not.ts`
+
+## Controls
+
+- Move: Left/Right arrows, A/D, L
+- Jump: Up, Space, H
+- Walk toggle: X (run is default)
+- Pause: P
+- Stop: S
+- Quit: Q or Esc
+
+## Dev
+
+Tests:
+
+```bash
+node --test arcade/mario-not/tests/*.test.js
+npx tsc --noEmit -p arcade/mario-not/tsconfig.json
+```
+
+Spec:
+
+- `arcade/mario-not/spec.md`

package/arcade/mario-not/boss.js

@@ -0,0 +1,103 @@
+// @ts-check
+"use strict";
+
+const { moveHorizontal, resolveVertical, overlaps } = require("./collision.js");
+const { spawnParticles, setCue } = require("./effects.js");
+const { BOSS_W, BOSS_H, BOSS_INVULN_TIME, BOSS_SCORE, GAME_MODES } = require("./constants.js");
+
+/** @typedef {import("./types").GameState} GameState */
+/** @typedef {import("./types").BossState} BossState */
+
+/** @param {GameState} state */
+function updateBoss(state) {
+	const boss = state.boss;
+	if (!boss || !boss.alive) return;
+
+	const cfg = state.config;
+	const dt = cfg.dt;
+
+	// Update invulnerability
+	if (boss.invuln > 0) {
+		boss.invuln = Math.max(0, boss.invuln - dt);
+	}
+
+	// Apply gravity
+	boss.vy = Math.min(boss.vy + cfg.gravity * dt, cfg.maxFall);
+
+	// Move horizontally
+	const blocked = moveHorizontal(state.level, boss, dt, BOSS_W, BOSS_H);
+	if (blocked) {
+		boss.vx = -boss.vx; // Bounce off walls
+	}
+
+	// Resolve vertical movement
+	resolveVertical(state.level, boss, dt, undefined, BOSS_H, BOSS_W, true);
+
+	// Check if boss fell into pit
+	if (boss.y >= state.level.height + 1) {
+		boss.alive = false;
+		defeatBoss(state);
+	}
+}
+
+/** @param {GameState} state @param {number} prevY @returns {boolean} - true if player took damage */
+function resolveBossCollision(state, prevY) {
+	const boss = state.boss;
+	if (!boss || !boss.alive) return false;
+
+	const player = state.player;
+	const playerH = player.size === "big" ? 2 : 1;
+	const prevBottom = prevY + playerH;
+	const currBottom = player.y + playerH;
+	const falling = currBottom > prevBottom + 0.0001;
+
+	// Check collision with boss (2x2)
+	if (overlaps(player.x, player.y, 1, playerH, boss.x, boss.y - 1, BOSS_W, BOSS_H)) {
+		const stomp = falling && prevBottom <= boss.y - 1 + 0.1 && currBottom >= boss.y - 1;
+		if (stomp && boss.invuln <= 0) {
+			// Player stomped on boss
+			damageBoss(state);
+			player.vy = -state.config.jumpVel * 0.7;
+			return false;
+		} else if (boss.invuln <= 0) {
+			// Player touched boss from side - take damage
+			return true;
+		}
+	}
+	return false;
+}
+
+/** @param {GameState} state */
+function damageBoss(state) {
+	const boss = state.boss;
+	if (!boss || !boss.alive) return;
+
+	boss.health -= 1;
+	boss.invuln = BOSS_INVULN_TIME;
+	spawnParticles(state, boss.x + 1, boss.y - 1, 4);
+
+	if (boss.health <= 0) {
+		boss.alive = false;
+		defeatBoss(state);
+	} else {
+		// Boss gets faster when damaged
+		const speedMult = 1 + (boss.maxHealth - boss.health) * 0.2;
+		boss.vx = Math.sign(boss.vx) * 1.5 * speedMult;
+		setCue(state, `BOSS ${boss.health}/${boss.maxHealth}`, 0.5, false);
+	}
+}
+
+/** @param {GameState} state */
+function defeatBoss(state) {
+	state.score += BOSS_SCORE;
+	spawnParticles(state, state.boss?.x || 0, state.boss?.y || 0, 8);
+	setCue(state, "BOSS DEFEATED!", 0, true);
+	state.mode = GAME_MODES.levelClear;
+}
+
+module.exports = {
+	updateBoss,
+	resolveBossCollision,
+	damageBoss,
+	defeatBoss,
+};

package/arcade/mario-not/camera.js

@@ -0,0 +1,59 @@
+// @ts-check
+"use strict";
+
+/**
+ * @typedef {Object} Level
+ * @property {number} width
+ */
+
+/**
+ * @typedef {Object} PlayerState
+ * @property {number} x
+ */
+
+/**
+ * @typedef {Object} Config
+ * @property {number} viewportWidth
+ */
+
+/**
+ * @typedef {Object} GameState
+ * @property {Level} level
+ * @property {PlayerState} player
+ * @property {Config} config
+ * @property {number} cameraX
+ */
+
+/** @param {number} value @param {number} min @param {number} max @returns {number} */
+function clamp(value, min, max) {
+	return Math.max(min, Math.min(max, value));
+}
+
+/** @param {GameState} state @param {number} [viewportWidth] @returns {number} */
+function getCameraX(state, viewportWidth) {
+	const width = typeof viewportWidth === "number" ? viewportWidth : state.config.viewportWidth;
+	const maxX = Math.max(0, state.level.width - width);
+	return clamp(state.cameraX || 0, 0, maxX);
+}
+
+/** @param {GameState} state @returns {number} */
+function updateCamera(state) {
+	const width = state.config.viewportWidth;
+	const maxX = Math.max(0, state.level.width - width);
+	let cameraX = state.cameraX || 0;
+	const lead = Math.floor(width * 0.25);
+	const minX = cameraX + lead;
+	const maxXZone = cameraX + lead;
+	if (state.player.x < minX) {
+		cameraX = clamp(state.player.x - lead, 0, maxX);
+	} else if (state.player.x > maxXZone) {
+		cameraX = clamp(state.player.x - lead, 0, maxX);
+	}
+	state.cameraX = cameraX;
+	return cameraX;
+}
+
+module.exports = {
+	getCameraX,
+	updateCamera,
+};

package/arcade/mario-not/collision.js

@@ -0,0 +1,91 @@
+// @ts-check
+"use strict";
+
+const { isSolidAt } = require("./tiles.js");
+
+/** @typedef {import("./types").Level} Level */
+
+/** @param {Level} level @param {number} x @param {number} y @param {number} height @returns {boolean} */
+function hitsSolid(level, x, y, height) {
+	if (isSolidAt(level, x, y)) return true;
+	if (height > 1 && isSolidAt(level, x, y - (height - 1))) return true;
+	return false;
+}
+
+/** @param {Level} level @param {number} x @param {number} y @param {boolean} allowBottomFall @returns {boolean} */
+function isSolidBelow(level, x, y, allowBottomFall) {
+	if (allowBottomFall && Math.floor(y) >= level.height) return false;
+	return isSolidAt(level, x, y);
+}
+
+/**
+ * @param {Level} level
+ * @param {{ x: number, y: number, vx: number, vy: number, onGround: boolean }} entity
+ * @param {number} dt
+ * @param {(tileX: number, tileY: number) => void} [onHeadBump]
+ * @param {number} [height]
+ * @param {number} [width]
+ * @param {boolean} [allowBottomFall]
+ */
+function resolveVertical(level, entity, dt, onHeadBump, height, width, allowBottomFall) {
+	const entityHeight = typeof height === "number" ? height : 1;
+	const entityWidth = typeof width === "number" ? width : 1;
+	const nextY = entity.y + entity.vy * dt;
+	const leftX = entity.x + 0.001;
+	const rightX = entity.x + entityWidth - 0.001;
+	if (entity.vy >= 0) {
+		const footY = nextY + 1;
+		if (isSolidBelow(level, leftX, footY, !!allowBottomFall) || isSolidBelow(level, rightX, footY, !!allowBottomFall)) {
+			entity.y = Math.floor(footY) - 1;
+			entity.vy = 0;
+			entity.onGround = true;
+		} else {
+			entity.y = nextY;
+			entity.onGround = false;
+		}
+	} else {
+		const headY = nextY - (entityHeight - 1);
+		if (isSolidAt(level, leftX, headY) || isSolidAt(level, rightX, headY)) {
+			const tileY = Math.floor(headY);
+			entity.y = tileY + entityHeight;
+			entity.vy = 0;
+			if (onHeadBump) {
+				const leftTileX = Math.floor(leftX);
+				const rightTileX = Math.floor(rightX);
+				onHeadBump(leftTileX, tileY);
+				if (rightTileX !== leftTileX) onHeadBump(rightTileX, tileY);
+			}
+		} else {
+			entity.y = nextY;
+		}
+	}
+}
+
+/**
+ * @param {Level} level
+ * @param {{ x: number, y: number, vx: number }} entity
+ * @param {number} dt
+ * @param {number} width
+ * @param {number} height
+ * @returns {boolean}
+ */
+function moveHorizontal(level, entity, dt, width, height) {
+	if (!entity.vx) return false;
+	const nextX = entity.x + entity.vx * dt;
+	const probeX = entity.vx > 0 ? nextX + width - 0.001 : nextX + 0.001;
+	if (hitsSolid(level, probeX, entity.y, height)) return true;
+	entity.x = nextX;
+	return false;
+}
+
+/** @param {number} ax @param {number} ay @param {number} aw @param {number} ah @param {number} bx @param {number} by @param {number} bw @param {number} bh @returns {boolean} */
+function overlaps(ax, ay, aw, ah, bx, by, bw, bh) {
+	return ax < bx + bw && ax + aw > bx && ay < by + bh && ay + ah > by;
+}
+
+module.exports = {
+	hitsSolid,
+	resolveVertical,
+	moveHorizontal,
+	overlaps,
+};

package/arcade/mario-not/colors.js

@@ -0,0 +1,36 @@
+// @ts-check
+"use strict";
+
+// ANSI color codes for terminal output
+const COLORS = {
+	reset: "\x1b[0m",
+	red: "\x1b[31m",
+	green: "\x1b[32m",
+	yellow: "\x1b[33m",
+	blue: "\x1b[34m",
+	magenta: "\x1b[35m",
+	cyan: "\x1b[36m",
+	white: "\x1b[37m",
+	gray: "\x1b[90m",
+	brightRed: "\x1b[91m",
+	brightGreen: "\x1b[92m",
+	brightYellow: "\x1b[93m",
+	brightCyan: "\x1b[96m",
+	orange: "\x1b[38;5;208m",
+	brown: "\x1b[38;5;94m",
+};
+
+/**
+ * Wrap a string with color codes
+ * @param {string} text
+ * @param {string} color
+ * @returns {string}
+ */
+function colorize(text, color) {
+	return `${color}${text}${COLORS.reset}`;
+}
+
+module.exports = {
+	COLORS,
+	colorize,
+};