pi-extensions 0.1.9

package/ralph-wiggum/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@tmustier/pi-ralph-wiggum",
+  "version": "0.1.1",
+  "description": "Long-running agent loops for iterative development in Pi.",
+  "license": "MIT",
+  "author": "Thomas Mustier",
+  "keywords": [
+    "pi-package"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tmustier/pi-extensions.git",
+    "directory": "ralph-wiggum"
+  },
+  "bugs": "https://github.com/tmustier/pi-extensions/issues",
+  "homepage": "https://github.com/tmustier/pi-extensions/tree/main/ralph-wiggum",
+  "pi": {
+    "extensions": [
+      "index.ts"
+    ],
+    "skills": [
+      "SKILL.md"
+    ]
+  }
+}

package/raw-paste/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.1.1 - 2026-01-16
+- Fix crash on Pi v0.47+ caused by CustomEditor signature change.
+
+## 0.1.0 - 2026-01-13
+- Initial release.

package/raw-paste/README.md

@@ -0,0 +1,52 @@
+# Raw Paste Extension
+
+/paste to arm a one-shot raw paste so large clipboard content stays fully editable in the editor (no paste markers).
+Useful for template prompts that need slight edits or when you need to refer to the text you pasted.
+
+## Without /paste -> the text is condensed
+<img width="1487" height="104" alt="Screenshot 2026-01-09 at 17 38 31" src="https://github.com/user-attachments/assets/d6a0793e-3ef3-4c3b-83c8-f6ca10f0db51" />
+
+## With /paste -> you can see raw text
+<img width="1487" height="387" alt="Screenshot 2026-01-09 at 17 39 35" src="https://github.com/user-attachments/assets/292c059a-8b06-40c2-abdd-795c0699336a" />
+
+
+## Install
+
+```bash
+pi install npm:@tmustier/pi-raw-paste
+```
+
+```bash
+pi install git:github.com/tmustier/pi-extensions
+```
+
+Then filter to just this extension in `~/.pi/agent/settings.json`:
+
+```json
+{
+  "packages": [
+    {
+      "source": "git:github.com/tmustier/pi-extensions",
+      "extensions": ["raw-paste/index.ts"]
+    }
+  ]
+}
+```
+
+## Usage
+
+- Command: `/paste`
+- No default keybinding
+
+After arming, paste normally (for example `Cmd+V` on macOS).
+
+Optional: add your own keybinding in `raw-paste/index.ts` if your terminal supports it.
+
+## Notes
+
+- Terminal.app and Warp intercept `Cmd+V` and `Cmd+Shift+V`, so the extension cannot see those keys.
+- Use `/paste` before pasting in those terminals.
+
+## Changelog
+
+See `CHANGELOG.md`.

package/raw-paste/index.ts

@@ -0,0 +1,112 @@
+import { CustomEditor, type ExtensionAPI, type ExtensionContext } from "@mariozechner/pi-coding-agent";
+
+const PASTE_START = "\x1b[200~";
+const PASTE_END = "\x1b[201~";
+const PASTE_END_LEN = PASTE_END.length;
+
+class RawPasteEditor extends CustomEditor {
+	private rawPasteArmed = false;
+	private rawPasteBuffer = "";
+	private isInRawPaste = false;
+	private onArm?: () => void;
+
+	constructor(
+		tui: ConstructorParameters<typeof CustomEditor>[0],
+		theme: ConstructorParameters<typeof CustomEditor>[1],
+		keybindings: ConstructorParameters<typeof CustomEditor>[2],
+		onArm?: () => void,
+	) {
+		super(tui, theme, keybindings);
+		this.onArm = onArm;
+	}
+
+	armRawPaste(): void {
+		this.rawPasteArmed = true;
+		this.onArm?.();
+	}
+
+	private flushRawPaste(content: string): void {
+		const normalized = content.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+		for (const char of normalized) {
+			super.handleInput(char);
+		}
+	}
+
+	private handleRawPasteInput(data: string): boolean {
+		let handled = false;
+
+		if (data.includes(PASTE_START)) {
+			this.isInRawPaste = true;
+			this.rawPasteBuffer = "";
+			data = data.replace(PASTE_START, "");
+			handled = true;
+		}
+
+		if (this.isInRawPaste) {
+			this.rawPasteBuffer += data;
+			const endIndex = this.rawPasteBuffer.indexOf(PASTE_END);
+			if (endIndex !== -1) {
+				const pasteContent = this.rawPasteBuffer.substring(0, endIndex);
+				const remaining = this.rawPasteBuffer.substring(endIndex + PASTE_END_LEN);
+				this.rawPasteBuffer = "";
+				this.isInRawPaste = false;
+				this.rawPasteArmed = false;
+
+				if (pasteContent.length > 0) {
+					this.flushRawPaste(pasteContent);
+				}
+				if (remaining.length > 0) {
+					this.handleInput(remaining);
+				}
+			}
+			return true;
+		}
+
+		return handled;
+	}
+
+	handleInput(data: string): void {
+		if (this.rawPasteArmed || this.isInRawPaste) {
+			if (this.handleRawPasteInput(data)) {
+				return;
+			}
+		}
+
+		super.handleInput(data);
+	}
+}
+
+export default function (pi: ExtensionAPI) {
+	let editor: RawPasteEditor | null = null;
+
+	const notifyArmed = (ctx: ExtensionContext): void => {
+		if (!ctx.hasUI) return;
+		ctx.ui.notify("Raw paste armed. Paste now.", "info");
+	};
+
+	const armRawPaste = (ctx: ExtensionContext): void => {
+		if (!editor) {
+			if (ctx.hasUI) ctx.ui.notify("Raw paste editor not ready.", "warning");
+			return;
+		}
+
+		editor.armRawPaste();
+	};
+
+	pi.on("session_start", (_event, ctx) => {
+		if (!ctx.hasUI) return;
+
+		ctx.ui.setEditorComponent((tui, theme, keybindings) => {
+			editor = new RawPasteEditor(tui, theme, keybindings, () => notifyArmed(ctx));
+			return editor;
+		});
+	});
+
+	pi.registerCommand("paste", {
+		description: "Arm raw paste for the next paste operation",
+		handler: async (_args, ctx) => {
+			armRawPaste(ctx);
+		},
+	});
+
+}

package/raw-paste/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@tmustier/pi-raw-paste",
+  "version": "0.1.0",
+  "description": "One-shot raw paste support for Pi (/paste).",
+  "license": "MIT",
+  "author": "Thomas Mustier",
+  "keywords": [
+    "pi-package"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tmustier/pi-extensions.git",
+    "directory": "raw-paste"
+  },
+  "bugs": "https://github.com/tmustier/pi-extensions/issues",
+  "homepage": "https://github.com/tmustier/pi-extensions/tree/main/raw-paste",
+  "pi": {
+    "extensions": [
+      "index.ts"
+    ]
+  }
+}

package/tab-status/CHANGELOG.md

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

package/tab-status/README.md

@@ -0,0 +1,61 @@
+# tab-status
+
+Manage as many parallel Pis as your mind can handle without forgetting any of them.
+
+Adds little modifiable indicators to tab titles:
+- ✅ means done and committed
+- 🚧 means done without a commit - Pi might need you to answer a question
+- 🛑 means the agent is blocked (no messages or tool calls for 180s while running) or stopped due to an error
+- `running...` means agent turn in progress - you can check back later
+
+The more tabs you have open, the better it is.
+
+![tab-status](assets/tab-status.png)
+
+## Install
+
+### Pi package manager
+
+```bash
+pi install npm:@tmustier/pi-tab-status
+```
+
+```bash
+pi install git:github.com/tmustier/pi-extensions
+```
+
+Then filter to just this extension in `~/.pi/agent/settings.json`:
+
+```json
+{
+  "packages": [
+    {
+      "source": "git:github.com/tmustier/pi-extensions",
+      "extensions": ["tab-status/tab-status.ts"]
+    }
+  ]
+}
+```
+
+### Local clone
+
+```bash
+ln -s ~/pi-extensions/tab-status/tab-status.ts ~/.pi/agent/extensions/
+```
+
+Or add to `~/.pi/agent/settings.json`:
+
+```json
+{
+  "extensions": ["~/pi-extensions/tab-status/tab-status.ts"]
+}
+```
+
+## Todo
+
+- [x] Status indicators in terminal tabs
+- [ ] Central location to view and navigate to specific tabs across terminal windows
+
+## Changelog
+
+See `CHANGELOG.md`.

package/tab-status/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@tmustier/pi-tab-status",
+  "version": "0.1.0",
+  "description": "Terminal tab status indicators for Pi sessions.",
+  "license": "MIT",
+  "author": "Thomas Mustier",
+  "keywords": [
+    "pi-package"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tmustier/pi-extensions.git",
+    "directory": "tab-status"
+  },
+  "bugs": "https://github.com/tmustier/pi-extensions/issues",
+  "homepage": "https://github.com/tmustier/pi-extensions/tree/main/tab-status",
+  "pi": {
+    "extensions": [
+      "tab-status.ts"
+    ]
+  }
+}

package/tab-status/tab-status.ts

@@ -0,0 +1,179 @@
+/**
+ * Update the terminal tab title with Pi run status (:new/:running/:✅/:🚧/:🛑).
+ */
+import type {
+	ExtensionAPI,
+	ExtensionContext,
+	SessionStartEvent,
+	SessionSwitchEvent,
+	BeforeAgentStartEvent,
+	AgentStartEvent,
+	AgentEndEvent,
+	TurnStartEvent,
+	ToolCallEvent,
+	ToolResultEvent,
+	SessionShutdownEvent,
+} from "@mariozechner/pi-coding-agent";
+import type { AgentMessage } from "@mariozechner/pi-agent-core";
+import type { AssistantMessage, StopReason } from "@mariozechner/pi-ai";
+import { basename } from "node:path";
+
+type StatusState = "new" | "running" | "doneCommitted" | "doneNoCommit" | "timeout";
+
+type StatusTracker = {
+	state: StatusState;
+	running: boolean;
+	sawCommit: boolean;
+};
+
+const STATUS_TEXT: Record<StatusState, string> = {
+	new: ":new",
+	running: ":running...",
+	doneCommitted: ":✅",
+	doneNoCommit: ":🚧",
+	timeout: ":🛑",
+};
+
+const INACTIVE_TIMEOUT_MS = 180_000;
+const GIT_COMMIT_RE = /\bgit\b[^\n]*\bcommit\b/;
+
+export default function (pi: ExtensionAPI) {
+	const status: StatusTracker = {
+		state: "new",
+		running: false,
+		sawCommit: false,
+	};
+	let timeoutId: ReturnType<typeof setTimeout> | undefined;
+	const nativeClearTimeout = globalThis.clearTimeout;
+
+	const cwdBase = (ctx: ExtensionContext): string => basename(ctx.cwd || "pi");
+
+	const setTitle = (ctx: ExtensionContext, next: StatusState): void => {
+		status.state = next;
+		if (!ctx.hasUI) return;
+		ctx.ui.setTitle(`pi - ${cwdBase(ctx)}${STATUS_TEXT[next]}`);
+	};
+
+	const clearTabTimeout = (): void => {
+		if (timeoutId === undefined) return;
+		nativeClearTimeout(timeoutId);
+		timeoutId = undefined;
+	};
+
+	const resetTimeout = (ctx: ExtensionContext): void => {
+		clearTabTimeout();
+		timeoutId = setTimeout(() => {
+			if (status.running && status.state === "running") {
+				setTitle(ctx, "timeout");
+			}
+		}, INACTIVE_TIMEOUT_MS);
+	};
+
+	const markActivity = (ctx: ExtensionContext): void => {
+		if (status.state === "timeout") {
+			setTitle(ctx, "running");
+		}
+		if (!status.running) return;
+		resetTimeout(ctx);
+	};
+
+	const resetState = (ctx: ExtensionContext, next: StatusState): void => {
+		status.running = false;
+		status.sawCommit = false;
+		clearTabTimeout();
+		setTitle(ctx, next);
+	};
+
+	const beginRun = (ctx: ExtensionContext): void => {
+		status.running = true;
+		status.sawCommit = false;
+		setTitle(ctx, "running");
+		resetTimeout(ctx);
+	};
+
+	const getStopReason = (messages: AgentMessage[]): StopReason | undefined => {
+		for (let i = messages.length - 1; i >= 0; i -= 1) {
+			const message = messages[i];
+			if (message.role === "assistant") {
+				return (message as AssistantMessage).stopReason;
+			}
+		}
+		return undefined;
+	};
+
+	const handlers = [
+		[
+			"session_start",
+			async (_event: SessionStartEvent, ctx: ExtensionContext) => {
+				resetState(ctx, "new");
+			},
+		],
+		[
+			"session_switch",
+			async (event: SessionSwitchEvent, ctx: ExtensionContext) => {
+				resetState(ctx, event.reason === "new" ? "new" : "doneCommitted");
+			},
+		],
+		[
+			"before_agent_start",
+			async (_event: BeforeAgentStartEvent, ctx: ExtensionContext) => {
+				markActivity(ctx);
+			},
+		],
+		[
+			"agent_start",
+			async (_event: AgentStartEvent, ctx: ExtensionContext) => {
+				beginRun(ctx);
+			},
+		],
+		[
+			"turn_start",
+			async (_event: TurnStartEvent, ctx: ExtensionContext) => {
+				markActivity(ctx);
+			},
+		],
+		[
+			"tool_call",
+			async (event: ToolCallEvent, ctx: ExtensionContext) => {
+				if (event.toolName === "bash") {
+					const command = typeof event.input.command === "string" ? event.input.command : "";
+					if (command && GIT_COMMIT_RE.test(command)) {
+						status.sawCommit = true;
+					}
+				}
+				markActivity(ctx);
+			},
+		],
+		[
+			"tool_result",
+			async (_event: ToolResultEvent, ctx: ExtensionContext) => {
+				markActivity(ctx);
+			},
+		],
+		[
+			"agent_end",
+			async (event: AgentEndEvent, ctx: ExtensionContext) => {
+				status.running = false;
+				clearTabTimeout();
+				const stopReason = getStopReason(event.messages);
+				if (stopReason === "error") {
+					setTitle(ctx, "timeout");
+					return;
+				}
+				setTitle(ctx, status.sawCommit ? "doneCommitted" : "doneNoCommit");
+			},
+		],
+		[
+			"session_shutdown",
+			async (_event: SessionShutdownEvent, ctx: ExtensionContext) => {
+				clearTabTimeout();
+				if (!ctx.hasUI) return;
+				ctx.ui.setTitle(`pi - ${cwdBase(ctx)}`);
+			},
+		],
+	] as const;
+
+	for (const [event, handler] of handlers) {
+		pi.on(event, handler as (event: unknown, ctx: ExtensionContext) => void);
+	}
+}

package/usage-extension/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 0.1.2 - 2026-01-13
+- Add loading spinner while parsing session files (Esc to cancel)
+- Make data loading async to keep UI responsive
+- Thanks @nicobailon
+
+## 0.1.1 - 2026-01-12
+- Deduplicate assistant messages across branched sessions to avoid double-counting
+- Tokens total now excludes cache read/write tokens (cache remains in Cache column)
+- Thanks @nicobailon
+
+## 0.1.0 - 2026-01-10
+- Initial release
+- Collapsible provider/model view
+- Three time periods: Today, This Week, All Time
+- Token breakdown columns (dimmed for de-emphasis)

package/usage-extension/README.md

@@ -0,0 +1,120 @@
+# /usage - Usage Statistics Dashboard
+
+A Pi extension that displays aggregated usage statistics across all sessions.
+
+![Usage Statistics Screenshot](screenshot.png)
+
+## Compatibility
+
+- **Pi version:** 0.42.4+
+- **Last updated:** 2026-01-13
+
+## Installation
+
+### Pi package manager
+
+```bash
+pi install npm:@tmustier/pi-usage-extension
+```
+
+```bash
+pi install git:github.com/tmustier/pi-extensions
+```
+
+Then filter to just this extension in `~/.pi/agent/settings.json`:
+
+```json
+{
+  "packages": [
+    {
+      "source": "git:github.com/tmustier/pi-extensions",
+      "extensions": ["usage-extension/index.ts"]
+    }
+  ]
+}
+```
+
+### Local clone
+
+Add to your `~/.pi/agent/settings.json`:
+
+```json
+{
+  "extensions": [
+    "~/pi-extensions/usage-extension"
+  ]
+}
+```
+
+## Usage
+
+In Pi, run:
+```
+/usage
+```
+
+## Features
+
+### Time Periods
+
+| Period | Definition |
+|--------|------------|
+| **Today** | From midnight (00:00) today |
+| **This Week** | From Monday 00:00 of the current week |
+| **All Time** | All recorded sessions |
+
+Use `Tab` or `←`/`→` to switch between periods.
+
+### Timezone
+
+Time periods are calculated in the local timezone where Pi runs. If you want to override it, set the `TZ` environment variable (IANA timezone, e.g. `TZ=UTC` or `TZ=America/New_York`) before launching Pi.
+
+### Columns
+
+| Column | Description |
+|--------|-------------|
+| **Provider / Model** | Provider name, expandable to show models |
+| **Sessions** | Number of unique sessions |
+| **Msgs** | Number of assistant messages |
+| **Cost** | Total cost in USD (from API response) |
+| **Tokens** | Total tokens (input + output) |
+| **↑In** | Input tokens *(dimmed)* |
+| **↓Out** | Output tokens *(dimmed)* |
+| **Cache** | Cache read + write tokens *(dimmed)* |
+
+### Navigation
+
+| Key | Action |
+|-----|--------|
+| `Tab` / `←` `→` | Switch time period |
+| `↑` `↓` | Select provider |
+| `Enter` / `Space` | Expand/collapse provider to show models |
+| `q` / `Esc` | Close |
+
+## Provider Notes
+
+### Cost Tracking
+
+Cost data comes directly from the API response (`usage.cost.total`). Accuracy depends on the provider reporting costs.
+
+### Cache Tokens
+
+Cache token support varies by provider:
+
+| Provider | Cache Read | Cache Write |
+|----------|------------|-------------|
+| Anthropic | ✓ | ✓ |
+| Google | ✓ | ✗ |
+| OpenAI Codex | ✓ | ✗ |
+
+The "Cache" column combines both read and write tokens.
+
+## Data Source
+
+Statistics are parsed from session files in `~/.pi/agent/sessions/`. Each session is a JSONL file containing message entries with usage data. Assistant messages duplicated across branched session files are deduplicated by timestamp + total tokens (matching ccusage).
+
+Respects the `PI_CODING_AGENT_DIR` environment variable if set.
+
+## Changelog
+
+See `CHANGELOG.md`.