pi-extensions 0.1.21 → 0.1.23

package/.github/workflows/skill-apply-optimize.yml

@@ -0,0 +1,19 @@
+name: Apply Skill Optimization
+on:
+  issue_comment:
+    types: [created]
+
+jobs:
+  apply:
+    if: >-
+      github.event.issue.pull_request &&
+      contains(github.event.comment.body, '/apply-optimize')
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: tesslio/skill-review-and-optimize@d81583861aaf29d1da7f10e6539efef4e27b0dd5
+        with:
+          mode: 'apply'

package/.github/workflows/skill-review.yml

@@ -0,0 +1,17 @@
+name: Skill Review & Optimize
+on:
+  pull_request:
+    paths: ['**/SKILL.md']
+
+jobs:
+  review:
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - uses: tesslio/skill-review-and-optimize@d81583861aaf29d1da7f10e6539efef4e27b0dd5
+        with:
+          optimize: 'true'
+          tessl-token: ${{ secrets.TESSL_API_TOKEN }}

package/.github/workflows/weather-native-bridge.yml

@@ -0,0 +1,86 @@
+name: weather-native-bridge
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build-prebuilt:
+    name: build (${{ matrix.target }})
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: macos-14
+            target: aarch64-apple-darwin
+          - runner: macos-14
+            target: x86_64-apple-darwin
+          - runner: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+          - runner: windows-latest
+            target: x86_64-pc-windows-msvc
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Setup Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}
+
+      - name: Install bridge dependencies
+        working-directory: weather/native/weathr-bridge
+        run: npm install --no-package-lock
+
+      - name: Build prebuilt binary
+        working-directory: weather/native/weathr-bridge
+        run: npx napi build --platform --release --dts native.d.ts --target ${{ matrix.target }}
+
+      - name: Upload binary artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: bindings-${{ matrix.target }}
+          path: weather/native/weathr-bridge/pi_weather_bridge.*.node
+          if-no-files-found: error
+
+  publish-platform-packages:
+    name: publish prebuilt packages
+    runs-on: ubuntu-latest
+    needs: build-prebuilt
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          registry-url: https://registry.npmjs.org
+
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: weather/native/weathr-bridge/artifacts
+
+      - name: Prepare npm package folders
+        working-directory: weather
+        run: npm run native:prepare-packages
+
+      - name: Sync artifacts into npm package folders
+        working-directory: weather
+        run: npm run native:sync-artifacts
+
+      - name: Publish platform packages
+        working-directory: weather
+        run: npm run native:publish-packages
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/extending-pi/SKILL.md

@@ -1,30 +1,61 @@
 ---
 name: extending-pi
-description: Guide for extending Pi — decide between skills, extensions, prompt templates, themes, context files, or custom models, then create and package them. Use when someone wants to extend Pi, add capabilities, create a skill, build an extension, or make a Pi package.
+description: Guide for extending Pi — decide between skills, extensions, prompt templates, themes, context files, or custom models, then scaffold files, configure manifests, and package them. Use when someone wants to extend Pi, add capabilities, create a skill, build an extension, make a Pi package, scaffold extension files, or configure a manifest.json.
 ---
 
 # Extending Pi
 
-Help the user decide what to build and where to find guidance.
+Help the user decide what to build, scaffold the right files, and point to detailed guidance.
 
 ## What to build
 
-| Goal | Build a… | Where |
-|------|----------|-------|
-| Teach Pi a workflow or how to use a tool/API/CLI | **Skill** | Read `skill-creator/SKILL.md` for detailed guidance |
-| Give Pi a new tool, command, or runtime behavior | **Extension** | Read Pi docs: `docs/extensions.md` |
-| Reuse a prompt pattern with variables | **Prompt template** | Read Pi docs: `docs/prompt-templates.md` |
-| Set project-wide coding guidelines | **Context file** | `AGENTS.md` in project root or `.pi/agent/` — just markdown |
-| Change Pi's appearance | **Theme** | Read Pi docs: `docs/themes.md` |
-| Add a model or provider | **Custom model** | Read Pi docs: `docs/models.md` (JSON) or `docs/custom-provider.md` (extension) |
-| Share any of the above | **Package** | Read Pi docs: `docs/packages.md` |
+| Goal | Build a… | Key files to create | Where |
+|------|----------|-------------------|-------|
+| Teach Pi a workflow or how to use a tool/API/CLI | **Skill** | `SKILL.md` with YAML frontmatter + markdown body | Read `skill-creator/SKILL.md` for detailed guidance |
+| Give Pi a new tool, command, or runtime behavior | **Extension** | `manifest.json` + `src/index.ts` entry point | Read Pi docs: `docs/extensions.md` |
+| Reuse a prompt pattern with variables | **Prompt template** | `.md` file with `{{variable}}` placeholders | Read Pi docs: `docs/prompt-templates.md` |
+| Set project-wide coding guidelines | **Context file** | `AGENTS.md` in project root or `.pi/agent/` — just markdown | No extra docs needed |
+| Change Pi's appearance | **Theme** | `theme.json` with color and font definitions | Read Pi docs: `docs/themes.md` |
+| Add a model or provider | **Custom model** | `models.json` or extension with provider registration | Read Pi docs: `docs/models.md` (JSON) or `docs/custom-provider.md` (extension) |
+| Share any of the above | **Package** | `manifest.json` with dependencies and entry points | Read Pi docs: `docs/packages.md` |
 
 ## Skill vs Extension — the fuzzy boundary
 
-If `bash` + instructions can do it, prefer a **skill** (simpler, no code to maintain). If you need event hooks, typed tools, UI components, or policy enforcement, use an **extension**.
+If `bash` + instructions can do it, prefer a **Skill** (simpler, no code to maintain). If you need event hooks, typed tools, UI components, or policy enforcement, use an **Extension**.
 
 Examples:
 - "Pi should know our deploy process" → **Skill** (workflow instructions)
 - "Pi should confirm before `rm -rf`" → **Extension** (event interception)
 - "Pi should use Brave Search" → **Skill** (instructions + CLI scripts)
 - "Pi should have a structured `db_query` tool" → **Extension** (registerTool)
+
+## Minimal working examples
+
+**Skill** — place in `.pi/skills/my-skill/SKILL.md`:
+```markdown
+---
+name: my-skill
+description: Does X when the user asks to Y.
+---
+# My Skill
+Step 1: ...
+Step 2: ...
+```
+
+**Extension** — create `manifest.json` + `src/index.ts`:
+```json
+{ "name": "my-extension", "version": "0.1.0", "entry": "src/index.ts" }
+```
+```typescript
+import { registerTool } from "@anthropic/pi-sdk";
+registerTool("my_tool", { description: "..." }, async (input) => { /* ... */ });
+```
+
+## Quick-start steps
+
+1. **Pick the artifact type** from the table above.
+2. **Scaffold the files** — create the key files using the minimal examples above.
+3. **Validate locally**:
+   - Skills: place `SKILL.md` in `.pi/skills/<name>/` and invoke the skill — if it doesn't trigger, check that `name` and `description` in frontmatter are set correctly.
+   - Extensions: run `pi ext install .` — if it fails with "missing entry", verify the `entry` path in `manifest.json` points to an existing file.
+4. **Package and share** — follow `docs/packages.md` to bundle and publish.

package/files-widget/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-files-widget",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "In-terminal file browser and viewer for Pi.",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -15,8 +15,8 @@
   "bugs": "https://github.com/tmustier/pi-extensions/issues",
   "homepage": "https://github.com/tmustier/pi-extensions/tree/main/files-widget",
   "peerDependencies": {
-    "@mariozechner/pi-coding-agent": "^0.50.0",
-    "@mariozechner/pi-tui": "^0.50.0"
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-tui": "*"
   },
   "scripts": {
     "postinstall": "node -e \"console.log('pi-files-widget: required deps: bat, delta, glow. Install with: brew install bat git-delta glow')\""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-extensions",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "license": "MIT",
   "private": false,
   "keywords": [
@@ -15,15 +15,11 @@
       "./arcade/tetris.ts",
       "./arcade/mario-not/mario-not.ts",
       "./code-actions/index.ts",
-      "./control/control.ts",
       "./files-widget/index.ts",
       "./raw-paste/index.ts",
       "./ralph-wiggum/index.ts",
-      "./review/review.ts",
-      "./relaunch/index.ts",
       "./tab-status/tab-status.ts",
-      "./usage-extension/index.ts",
-      "./ready-status/ready-status.ts"
+      "./usage-extension/index.ts"
     ],
     "skills": [
       "./extending-pi/SKILL.md",

package/ralph-wiggum/index.ts

@@ -602,6 +602,11 @@ Examples:
 		name: "ralph_start",
 		label: "Start Ralph Loop",
 		description: "Start a long-running development loop. Use for complex multi-iteration tasks.",
+		promptSnippet: "Start a persistent multi-iteration development loop with pacing and reflection controls.",
+		promptGuidelines: [
+			"Use this tool when the user explicitly wants an iterative loop, autonomous repeated passes, or paced multi-step execution.",
+			"After starting a loop, continue each finished iteration with ralph_done unless the completion marker has already been emitted.",
+		],
 		parameters: Type.Object({
 			name: Type.String({ description: "Loop name (e.g., 'refactor-auth')" }),
 			taskContent: Type.String({ description: "Task in markdown with goals and checklist" }),
@@ -653,6 +658,11 @@ Examples:
 		name: "ralph_done",
 		label: "Ralph Iteration Done",
 		description: "Signal that you've completed this iteration of the Ralph loop. Call this after making progress to get the next iteration prompt. Do NOT call this if you've output the completion marker.",
+		promptSnippet: "Advance an active Ralph loop after completing the current iteration.",
+		promptGuidelines: [
+			"Call this after making real iteration progress so Ralph can queue the next prompt.",
+			"Do not call this if there is no active loop, if pending messages are already queued, or if the completion marker has already been emitted.",
+		],
 		parameters: Type.Object({}),
 		async execute(_toolCallId, _params, _signal, _onUpdate, ctx) {
 			if (!currentLoop) {

package/ralph-wiggum/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-ralph-wiggum",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Long-running agent loops for iterative development in Pi.",
   "license": "MIT",
   "author": "Thomas Mustier",

package/usage-extension/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.1.4 - 2026-04-09
+- Scan session files recursively so nested subagent runs are included in `/usage`
+- Add deduped vs raw counting modes to compare copied branch history against raw file totals
+
 ## 0.1.3 - 2026-02-03
 - Add preview image metadata for the extension listing.
 

package/usage-extension/README.md

@@ -7,7 +7,7 @@ A Pi extension that displays aggregated usage statistics across all sessions.
 ## Compatibility
 
 - **Pi version:** 0.42.4+
-- **Last updated:** 2026-01-13
+- **Last updated:** 2026-04-09
 
 ## Installation
 
@@ -65,6 +65,15 @@ In Pi, run:
 
 Use `Tab` or `←`/`→` to switch between periods.
 
+### Count Modes
+
+| Mode | Definition |
+|------|------------|
+| **Deduped** | Default. Deduplicates copied assistant history across branched session files |
+| **Raw** | Counts every assistant message found in every session file |
+
+Both modes scan nested session files recursively, so subagent runs are included.
+
 ### 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.
@@ -87,6 +96,9 @@ Time periods are calculated in the local timezone where Pi runs. If you want to
 | Key | Action |
 |-----|--------|
 | `Tab` / `←` `→` | Switch time period |
+| `m` | Cycle count mode |
+| `d` | Switch to deduped mode |
+| `r` | Switch to raw mode |
 | `↑` `↓` | Select provider |
 | `Enter` / `Space` | Expand/collapse provider to show models |
 | `q` / `Esc` | Close |
@@ -111,7 +123,11 @@ 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).
+Statistics are parsed recursively from session files in `~/.pi/agent/sessions/`, including nested subagent runs such as `run-0/` directories. Each session is a JSONL file containing message entries with usage data.
+
+In **Deduped** mode, assistant messages duplicated across branched session files are deduplicated by timestamp + total tokens (matching the extension's previous behavior and keeping totals comparable with earlier releases).
+
+In **Raw** mode, every assistant message found in every session file is counted.
 
 Respects the `PI_CODING_AGENT_DIR` environment variable if set.