pi-extensions 0.1.17 → 0.1.20

package/README.md

@@ -6,7 +6,7 @@ Personal extensions for the [Pi coding agent](https://github.com/badlogic/pi-mon
 
 | Extension | Description |
 |-----------|-------------|
-| [/files](files-widget/) | In-terminal file browser and viewer widget. Navigate files, view diffs, select code, send comments to agent - without leaving Pi, and without interrupting your agent |
+| [/readfiles](files-widget/) | In-terminal file browser and viewer widget. Navigate files, view diffs, select code, send comments to agent - without leaving Pi, and without interrupting your agent |
 | [tab-status](tab-status/) | Manage as many parallel sessions as your mind can handle. Terminal tab indicators for <br>✅ done / 🚧 stuck / 🛑 timed out |
 | [ralph-wiggum](ralph-wiggum/) | Run arbitrarily-long tasks without diluting model attention. Flat version without subagents like [ralph-loop](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/ralph-loop) |
 | [agent-guidance](agent-guidance/) | Switch between Claude/Codex/Gemini with model-specific guidance (CLAUDE.md, CODEX.md, GEMINI.md) |
@@ -15,6 +15,13 @@ Personal extensions for the [Pi coding agent](https://github.com/badlogic/pi-mon
 | [/code](code-actions/) | Pick code blocks or inline snippets from assistant messages to copy, insert, or run with `/code` |
 | [arcade](arcade/) | Play minigames while your tests run: 👾 sPIce-invaders, 👻 picman, 🏓 ping, 🧩 tetris, 🍄 mario-not |
 
+## Skills
+
+| Skill | Description |
+|-------|-------------|
+| [pi-skill-creator](pi-skill-creator/) | Guidelines and templates for creating Pi skills. |
+| [ralph-wiggum](ralph-wiggum/) | Skill instructions for long-running development loops. |
+
 ## Install (pi package manager)
 
 ```bash

package/agent-guidance/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.1.3 - 2026-02-03
+
+### Changed
+- Publish metadata refresh (no runtime changes).
+
 ## 0.1.2 - 2026-02-02
 
 ### Changed

package/agent-guidance/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-agent-guidance",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Loads provider-specific context files (CLAUDE.md, CODEX.md, GEMINI.md) based on current model.",
   "license": "MIT",
   "author": "Thomas Mustier",

package/arcade/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+## 0.1.5 - 2026-02-03
+- Add preview video metadata for the extension listing.
+
 ## 0.1.4 - 2026-01-26
 - Fix Tetris pieces locking automatically after landing.
 

package/arcade/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-arcade",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Arcade minigames for the Pi coding agent.",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -21,6 +21,7 @@
       "ping.ts",
       "tetris.ts",
       "mario-not/mario-not.ts"
-    ]
+    ],
+    "video": "https://raw.githubusercontent.com/tmustier/pi-extensions/main/arcade/assets/demo.mp4"
   }
 }

package/code-actions/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+## 0.1.4 - 2026-02-03
+- Add preview image metadata for the extension listing.
+
 ## 0.1.2 - 2026-01-26
 - Add a src entry point so loading `code-actions/src` works with pi extension discovery.
 

package/code-actions/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-code-actions",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Pick code blocks or inline snippets from recent assistant messages to copy or insert.",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -17,6 +17,7 @@
   "pi": {
     "extensions": [
       "index.ts"
-    ]
+    ],
+    "image": "https://github.com/user-attachments/assets/0dc10a64-d61f-4b56-9684-5e448c759385"
   }
 }

package/files-widget/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to this extension will be documented in this file.
 
+## [0.1.14] - 2026-02-03
+
+### Added
+- Add preview video metadata for the extension listing.
+
 ## [0.1.13] - 2026-02-02
 
 ### Changed

package/files-widget/README.md

@@ -14,7 +14,7 @@ In-terminal file browser and diff viewer widget for Pi. Navigate files, view dif
 pi install npm:@tmustier/pi-files-widget
 ```
 
-Required deps (needed for /files):
+Required deps (needed for /readfiles):
 
 ```bash
 # macOS (Homebrew)
@@ -75,11 +75,11 @@ Then reference it in your settings:
 - `delta`: formatted diffs
 - `glow`: markdown rendering
 
-The `/files` browser requires these tools and will refuse to open until they are installed.
+The `/readfiles` browser requires these tools and will refuse to open until they are installed.
 
 ## Commands
 
-- `/files` - open the file browser
+- `/readfiles` - open the file browser
 - `/review` - open tuicr review flow
 - `/diff` - open critique (bunx critique)
 
@@ -127,4 +127,4 @@ If missing, `/review` or `/diff` will show a clear install prompt.
 - Folder LOCs are shown only when the folder is collapsed (expanded folders would duplicate counts).
 - Line counts load asynchronously; the header shows activity while counts are computed.
 - Large non-git folders load progressively and may show `[partial]` while loading in safe mode.
-- Git status refreshes every 3 seconds while `/files` is open.
+- Git status refreshes every 3 seconds while `/readfiles` is open.

package/files-widget/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-files-widget",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "In-terminal file browser and viewer for Pi.",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -24,6 +24,7 @@
   "pi": {
     "extensions": [
       "index.ts"
-    ]
+    ],
+    "video": "https://raw.githubusercontent.com/tmustier/pi-extensions/main/files-widget/demo.mp4"
   }
 }

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "pi-extensions",
-  "version": "0.1.17",
+  "version": "0.1.20",
+  "license": "MIT",
   "private": false,
   "keywords": [
     "pi-package"
@@ -25,6 +26,7 @@
       "./ready-status/ready-status.ts"
     ],
     "skills": [
+      "./pi-skill-creator/SKILL.md",
       "./ralph-wiggum/SKILL.md"
     ]
   }

package/pi-skill-creator/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.2.0 - 2026-02-05
+- Consolidate into standalone SKILL.md: remove references/ directory (design-patterns, workflows, output-patterns).
+- Reframe directives as context throughout — add "Context over directives" principle.
+- Add Activation principle (description is the sole trigger).
+- Fold Pi-specific reference guidelines (one level deep, no duplication) into step 7.
+- Clarify optional frontmatter fields, `disable-model-invocation`, and name rules.
+
+## 0.1.0 - 2026-02-05
+- Initial release.

package/pi-skill-creator/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thomas Mustier
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/pi-skill-creator/README.md

@@ -0,0 +1,6 @@
+# pi-skill-creator
+
+Guidelines and templates for creating Pi skills that follow the Agent Skills format.
+
+## Installation
+`pi install npm:@tmustier/pi-skill-creator`

package/pi-skill-creator/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: pi-skill-creator
+description: Create or update Pi skills (SKILL.md plus optional scripts, references, or assets). Use when someone asks to design a new Pi skill, refine an existing one, or structure skills for Pi discovery or packaging.
+---
+
+# Pi Skill Creator
+
+Provide guidance for creating effective Pi skills.
+
+## Principles
+
+- **Conciseness**: the agent is already very capable - only domain-specific knowledge, workflows, and tooling it can't infer earn their token cost.
+- **Progressive disclosure**: Pi loads skills in tiers - frontmatter (always in context), body (on trigger), bundled resources (on demand) - so splitting content across them keeps context lean.
+- **Activation**: Pi decides whether to load a skill based solely on the frontmatter `description`. "When to use" information in the body comes too late.
+- **Context over directives**: the agent makes better decisions when it understands why. For tasks requiring judgment, context like "X helps Y because Z" is more robust than instructions like "You MUST do X".
+
+## Pi Agent Skills format
+
+- Required frontmatter: `name`, `description`. Directory name must equal `name`.
+- Name rules: 1–64 chars, lowercase letters/digits/hyphens, no leading/trailing/consecutive hyphens.
+- Optional frontmatter: `license`, `compatibility`, `metadata` (arbitrary key-value pairs for tooling), `allowed-tools` (restrict which tools the skill may invoke).
+- `disable-model-invocation`: when set, Pi won't auto-trigger the skill; the user must invoke it explicitly with `/skill:name`.
+- Paths are relative to the skill directory; `{baseDir}` placeholders are not supported.
+- Skill locations: `~/.pi/agent/skills/`, `.pi/skills/`, `skills/` in a package, settings `skills`, or `--skill <path>`.
+
+## Recommended structure
+
+```
+pi-skill/
+├── SKILL.md
+├── README.md         # Optional: human summary + installation
+├── scripts/          # Optional executables
+├── references/       # Optional docs loaded on demand
+└── assets/           # Optional templates/assets
+```
+
+## Workflow
+
+### 1) Clarify use cases
+
+2-4 concrete example requests usually suffice to scope triggers and functionality.
+
+### 2) Plan reusable resources
+
+For each example, decide if you need:
+- **scripts/** for deterministic tasks
+- **references/** for long docs or schemas
+- **assets/** for templates or boilerplate
+
+### 3) Create the skeleton
+
+A skill needs a directory containing a SKILL.md. Only add resource sub-directories that are actually needed.
+
+```bash
+mkdir -p ~/.pi/agent/skills/my-skill
+touch ~/.pi/agent/skills/my-skill/SKILL.md
+```
+
+### 4) Optional: Write README.md (humans + installation)
+
+If you plan to share the skill with humans, a README.md helps discovery and installation. If you have a README, installation info can live there to save space in SKILL.md.
+
+```markdown
+# My Skill
+
+Short summary for humans discovering the skill.
+
+## Installation
+`pi install git:github.com/org/my-skill`
+```
+
+### 5) Write frontmatter
+
+Use only the fields you need.
+
+```markdown
+---
+name: my-skill
+description: What it does + when to use it.
+---
+```
+
+If you need to hide auto-invocation, set:
+
+```yaml
+disable-model-invocation: true
+```
+
+### 6) Write the body
+
+- Imperative phrasing works well for procedural instructions; context framing works better for guidance (see Principles).
+- ~500 lines is a practical ceiling for SKILL.md; beyond that, split content into references.
+- The agent won't know a reference file exists unless SKILL.md says when to read it.
+
+### 7) Add resources
+
+SKILL.md is the agent's interface to the skill — usage examples and input/output descriptions let it call scripts without needing to understand internals.
+
+- **scripts/**: usage examples in SKILL.md inform the agent how to call them; scripts should be executable.
+- **references/**: a table of contents helps the agent navigate files longer than ~100 lines. References work best one level deep from SKILL.md, and each fact should live in one place (SKILL.md or a reference, not both).
+- **assets/**: templates, boilerplate, or data used in final output — typically not loaded into context.
+
+### 8) Validate and test
+
+- Run the validator script:
+
+```bash
+scripts/validate_skill.py /path/to/my-skill
+```
+
+- Load only the skill to spot warnings:
+
+```bash
+pi --no-skills --skill /path/to/my-skill
+```
+
+- Invoke it explicitly:
+
+```bash
+/skill:my-skill
+```
+
+- After edits, use `/reload`.
+
+### 9) Publish (optional)
+
+To share beyond a single machine, publish as a Pi package (package.json-based, not a .skill archive).
+
+- Add `package.json` with a `pi` manifest (or rely on the conventional `skills/` directory).
+- Add `"keywords": ["pi-package"]` for discoverability.
+- Publish to npm or host in git; install with `pi install <source>` and enable via `pi config` if needed.
+
+```json
+{
+  "name": "my-pi-skills",
+  "keywords": ["pi-package"],
+  "pi": { "skills": ["./skills"] }
+}
+```

package/pi-skill-creator/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@tmustier/pi-skill-creator",
+  "version": "0.2.0",
+  "description": "Skill-creation guidelines for Pi (Agent Skills format).",
+  "license": "MIT",
+  "author": "Thomas Mustier",
+  "keywords": [
+    "pi-package"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tmustier/pi-extensions.git",
+    "directory": "pi-skill-creator"
+  },
+  "bugs": "https://github.com/tmustier/pi-extensions/issues",
+  "homepage": "https://github.com/tmustier/pi-extensions/tree/main/pi-skill-creator",
+  "pi": {
+    "skills": [
+      "SKILL.md"
+    ]
+  }
+}

package/pi-skill-creator/scripts/validate_skill.py

@@ -0,0 +1,208 @@
+#!/usr/bin/env python3
+"""
+Validate a Pi skill directory for Agent Skills + README requirements.
+
+Usage:
+  scripts/validate_skill.py <skill_directory>
+"""
+
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+
+import yaml
+
+MAX_NAME_LENGTH = 64
+MAX_DESCRIPTION_LENGTH = 1024
+
+ALLOWED_FRONTMATTER_FIELDS = {
+    "name",
+    "description",
+    "license",
+    "compatibility",
+    "metadata",
+    "allowed-tools",
+    "disable-model-invocation",
+}
+
+NAME_PATTERN = re.compile(r"^[a-z0-9-]+$")
+FRONTMATTER_PATTERN = re.compile(r"^---\n(.*?)\n---", re.DOTALL)
+INSTALLATION_HEADING = re.compile(r"^#{1,6}\s+installation\b", re.IGNORECASE)
+
+
+def read_frontmatter(skill_md: Path) -> tuple[dict | None, str | None]:
+    content = skill_md.read_text()
+    if not content.startswith("---"):
+        return None, "No YAML frontmatter found"
+
+    match = FRONTMATTER_PATTERN.match(content)
+    if not match:
+        return None, "Invalid frontmatter format"
+
+    try:
+        frontmatter = yaml.safe_load(match.group(1))
+    except yaml.YAMLError as exc:
+        return None, f"Invalid YAML in frontmatter: {exc}"
+
+    if not isinstance(frontmatter, dict):
+        return None, "Frontmatter must be a YAML mapping"
+
+    return frontmatter, None
+
+
+def validate_readme(readme_path: Path) -> tuple[list[str], list[str]]:
+    errors: list[str] = []
+    warnings: list[str] = []
+
+    if not readme_path.exists():
+        return ["README.md not found"], warnings
+
+    content = readme_path.read_text().strip()
+    if not content:
+        return ["README.md is empty"], warnings
+
+    lines = readme_path.read_text().splitlines()
+    installation_index = None
+    for idx, line in enumerate(lines):
+        if INSTALLATION_HEADING.match(line.strip()):
+            installation_index = idx
+            break
+
+    if installation_index is None:
+        errors.append("README.md is missing an Installation section")
+    else:
+        summary_lines = [
+            line.strip()
+            for line in lines[:installation_index]
+            if line.strip() and not line.strip().startswith("#")
+        ]
+        if not summary_lines:
+            warnings.append("README.md has no summary text before Installation")
+
+    return errors, warnings
+
+
+def validate_frontmatter(frontmatter: dict, skill_dir: Path) -> tuple[list[str], list[str]]:
+    errors: list[str] = []
+    warnings: list[str] = []
+
+    keys = set(frontmatter.keys())
+    unknown = sorted(keys - ALLOWED_FRONTMATTER_FIELDS)
+    if unknown:
+        warnings.append(f"Unknown frontmatter field(s): {', '.join(unknown)}")
+
+    name = frontmatter.get("name")
+    if not isinstance(name, str) or not name.strip():
+        errors.append("Missing or invalid 'name' in frontmatter")
+    else:
+        normalized = name.strip()
+        parent_dir = skill_dir.name
+        if normalized != parent_dir:
+            errors.append(
+                f"Frontmatter name '{normalized}' does not match directory '{parent_dir}'"
+            )
+        if len(normalized) > MAX_NAME_LENGTH:
+            errors.append(
+                f"Name is too long ({len(normalized)}). Max {MAX_NAME_LENGTH}."
+            )
+        if not NAME_PATTERN.match(normalized):
+            errors.append(
+                "Name must be lowercase letters, digits, and hyphens only"
+            )
+        if normalized.startswith("-") or normalized.endswith("-"):
+            errors.append("Name must not start or end with a hyphen")
+        if "--" in normalized:
+            errors.append("Name must not contain consecutive hyphens")
+
+    description = frontmatter.get("description")
+    if not isinstance(description, str) or not description.strip():
+        errors.append("Missing or invalid 'description' in frontmatter")
+    else:
+        desc = description.strip()
+        if len(desc) > MAX_DESCRIPTION_LENGTH:
+            errors.append(
+                f"Description is too long ({len(desc)}). Max {MAX_DESCRIPTION_LENGTH}."
+            )
+
+    allowed_tools = frontmatter.get("allowed-tools")
+    if allowed_tools is not None and not isinstance(allowed_tools, str):
+        warnings.append("'allowed-tools' should be a space-delimited string")
+
+    compatibility = frontmatter.get("compatibility")
+    if compatibility is not None and not isinstance(compatibility, str):
+        warnings.append("'compatibility' should be a string")
+
+    license_value = frontmatter.get("license")
+    if license_value is not None and not isinstance(license_value, str):
+        warnings.append("'license' should be a string")
+
+    metadata = frontmatter.get("metadata")
+    if metadata is not None and not isinstance(metadata, dict):
+        warnings.append("'metadata' should be a mapping")
+
+    disable_invocation = frontmatter.get("disable-model-invocation")
+    if disable_invocation is not None and not isinstance(disable_invocation, bool):
+        warnings.append("'disable-model-invocation' should be a boolean")
+
+    return errors, warnings
+
+
+def validate_skill(skill_path: Path) -> tuple[list[str], list[str]]:
+    errors: list[str] = []
+    warnings: list[str] = []
+
+    if not skill_path.exists():
+        return [f"Skill directory not found: {skill_path}"], warnings
+
+    if not skill_path.is_dir():
+        return [f"Skill path is not a directory: {skill_path}"], warnings
+
+    skill_md = skill_path / "SKILL.md"
+    if not skill_md.exists():
+        errors.append("SKILL.md not found")
+        return errors, warnings
+
+    frontmatter, frontmatter_error = read_frontmatter(skill_md)
+    if frontmatter_error:
+        errors.append(frontmatter_error)
+        return errors, warnings
+
+    fm_errors, fm_warnings = validate_frontmatter(frontmatter, skill_path)
+    errors.extend(fm_errors)
+    warnings.extend(fm_warnings)
+
+    readme_errors, readme_warnings = validate_readme(skill_path / "README.md")
+    errors.extend(readme_errors)
+    warnings.extend(readme_warnings)
+
+    return errors, warnings
+
+
+def main() -> None:
+    if len(sys.argv) != 2:
+        print("Usage: scripts/validate_skill.py <skill_directory>")
+        sys.exit(1)
+
+    skill_path = Path(sys.argv[1]).resolve()
+    errors, warnings = validate_skill(skill_path)
+
+    if warnings:
+        print("Warnings:")
+        for warning in warnings:
+            print(f"  - {warning}")
+        print()
+
+    if errors:
+        print("Errors:")
+        for error in errors:
+            print(f"  - {error}")
+        sys.exit(1)
+
+    print("Skill is valid!")
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

package/ralph-wiggum/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.1.5 - 2026-02-03
+
+### Added
+- Add preview image metadata for the extension listing.
+
 ## 0.1.4 - 2026-02-02
 
 ### Changed

package/ralph-wiggum/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-ralph-wiggum",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Long-running agent loops for iterative development in Pi.",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -20,6 +20,7 @@
     ],
     "skills": [
       "SKILL.md"
-    ]
+    ],
+    "image": "https://github.com/user-attachments/assets/68cdab11-76c6-4aed-9ea1-558cbb267ea6"
   }
 }

package/raw-paste/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+## 0.1.2 - 2026-02-03
+- Add preview image metadata for the extension listing.
+
 ## 0.1.1 - 2026-01-16
 - Fix crash on Pi v0.47+ caused by CustomEditor signature change.
 

package/raw-paste/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-raw-paste",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "One-shot raw paste support for Pi (/paste).",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -17,6 +17,7 @@
   "pi": {
     "extensions": [
       "index.ts"
-    ]
+    ],
+    "image": "https://github.com/user-attachments/assets/292c059a-8b06-40c2-abdd-795c0699336a"
   }
 }

package/tab-status/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+## 0.1.3 - 2026-02-03
+- Add preview image metadata for the extension listing.
+
 ## 0.1.2 - 2026-01-26
 - Added note clarifying one active session per tab is tracked.
 

package/tab-status/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-tab-status",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Terminal tab status indicators for Pi sessions.",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -17,6 +17,7 @@
   "pi": {
     "extensions": [
       "tab-status.ts"
-    ]
+    ],
+    "image": "https://raw.githubusercontent.com/tmustier/pi-extensions/main/tab-status/assets/tab-status.png"
   }
 }

package/usage-extension/CHANGELOG.md

@@ -1,5 +1,8 @@
 # Changelog
 
+## 0.1.3 - 2026-02-03
+- Add preview image metadata for the extension listing.
+
 ## 0.1.2 - 2026-01-13
 - Add loading spinner while parsing session files (Esc to cancel)
 - Make data loading async to keep UI responsive

package/usage-extension/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tmustier/pi-usage-extension",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Usage statistics dashboard for Pi sessions.",
   "license": "MIT",
   "author": "Thomas Mustier",
@@ -17,6 +17,7 @@
   "pi": {
     "extensions": [
       "index.ts"
-    ]
+    ],
+    "image": "https://raw.githubusercontent.com/tmustier/pi-extensions/main/usage-extension/screenshot.png"
   }
 }