pi-extension-toolkit

A Pi Coding Agent extension to create, retrofit, and verify other extensions.

Package details

← Back
extension

Install pi-extension-toolkit from npm and Pi will load the resources declared by the package manifest.

npm report
$ pi install npm:pi-extension-toolkit
Package
pi-extension-toolkit
Version
0.1.0
Published
Apr 27, 2026
Downloads
127/mo · 127/wk
Author
kylebrodeur
License
MIT
Types
extension
Size
30.7 KB
Dependencies
0 dependencies · 0 peers
Pi manifest JSON
{
  "extensions": [
    "./dist"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-extension-toolkit

A specialized Pi Coding Agent extension designed to scaffold, retrofit, and verify other Pi extensions according to the pi-extension-template standards.

Features

  • Create: Scaffold a brand new extension using the official template (Node 22, TypeBox, Biome, Husky v9).
  • Retrofit: Automatically upgrade an existing extension to meet current standards. Fixes biome.json schemas, updates .github/workflows to Node 22, configures Husky v9, and adds the required pi manifest fields to package.json.
  • Verify: A comprehensive linter that audits your extension structure to ensure 100% compliance with Pi extension best practices.

Installation

```bash pi install npm:pi-extension-toolkit ```

Usage

Once installed, the toolkit provides both interactive UI commands and programmatic tools for the agent.

Commands (Interactive)

  • /create-extension - Prompts for a name and target directory, then scaffolds the template.
  • /retrofit-extension - Prompts for a target directory, then applies automated fixes.
  • /verify-standards - Audits the target directory and reports any missing standards.

Agent Tools

Your agent can autonomously call:

  • create_extension(name, targetDir)
  • retrofit_extension(targetDir)
  • verify_standards(targetDir)

Standards Enforced

  • Runtime: Node 22 LTS
  • Package: type module, ESM exports, pi-package keyword, pi.extensions manifest.
  • Dependencies: @mariozechner/pi-coding-agent (latest), typebox (^1.1.0) in devDependencies.
  • Quality: Biome (latest schema), Husky v9 pre-commit hooks (biome check --write & tsc --noEmit).
  • CI/CD: GitHub Actions using node-version: "22" and --provenance publishing.

License

MIT