@gaodes/pi-dev-kit

Developer toolkit for Pi — modular skills for authoring extensions, skills, prompt templates, themes, packages, and context files. Includes introspection tools for version, docs, changelog, benchmarking, and loaded tools.

Package details

← Back

extensionskillprompt

Install @gaodes/pi-dev-kit from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@gaodes/pi-dev-kit

Package: @gaodes/pi-dev-kit
Version: 2.0.2
Published: May 3, 2026
Downloads: not available
Author: gaodes
License: MIT
Types: extension, skill, prompt
Size: 80.1 KB
Dependencies: 2 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ],
  "skills": [
    "./src/skills"
  ],
  "prompts": [
    "./src/prompts"
  ]
}

Security note

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

README

@gaodes/pi-dev-kit

Fork of @aliou/pi-dev-kit by Aliou DIA — MIT License

Additional tools ported from:

pi-updater by tonze — pi_updater tool, /update command

@alexanderfortin/pi-loaded-tools by shaftoe — loaded_tools tool, /tools command, message renderer

This fork is maintained by El Che under the @gaodes npm scope. The original project and all upstream authors retain full credit for their work.

Developer toolkit for the Pi coding agent.

Source · npm · Upstream

Tools

Tool	Description
`pi_version`	Returns the currently running Pi version.
`pi_docs`	Lists Pi markdown documentation files from the installation directory.
`pi_changelog`	Returns changelog entries for a specific Pi version (or latest). Fetches from GitHub for versions newer than installed.
`pi_changelog_versions`	Lists all available Pi changelog versions.
`pi_ext_benchmark`	Profile Pi extension loading times — discovers all extensions (global, project-local, packages) and measures import + factory execution time per extension. Actions: `profile` (default), `list`. Scopes: `all`, `global`, `project`, `packages`.
`loaded_tools`	List all loaded tools with source provenance and active status. Returns tools grouped by source (built-in, SDK, extensions) with active/inactive indicators and per-extension grouping.
`detect_package_manager`	Detect the package manager used in the current project by checking lockfiles and `package.json`. Returns the package manager name, version, lockfile, and install/run commands.

Commands

Command	Description
`/tools`	List all loaded tools with source provenance and active status.

Configuration

Startup display

By default, the tools list is not shown at session start. To enable it, add to ~/.pi/agent/prime-settings.json:

{
  "pi-dev-kit": {
    "showOnStartup": true
  }
}

Or per-project in .pi/prime-settings.json.

Skills

Skill	Description
`pi-extension`	Comprehensive Pi extension development reference — tools, hooks, commands, components, modes, state, providers, testing, publishing, and 12 API reference docs
`demo-setup`	Demo project setup guide for new Pi extensions

Changelog

v0.3.0

Upgrade version-tool and docs-tool to defineTool API with ToolCallHeader rendering
Add promptSnippet and promptGuidelines to upgraded tools
Add pi-extension skill with 12 reference docs from upstream
Add demo-setup skill and setup-demo prompt from upstream
Add @aliou/pi-utils-ui dependency for ToolCallHeader/ToolBody rendering

v0.2.0

Add pi_ext_benchmark tool — profile extension loading times
Add loaded_tools tool — list all tools with source provenance
Add /tools command and message renderer
Add startup display (opt-in via showOnStartup)

v0.1.0

Initial release: pi_version, pi_docs, pi_changelog, pi_changelog_versions

Related extensions

pi-package-manager — pi_package_manager tool for scanning, installing, and uninstalling Pi packages.
pi-updater — pi_updater tool and /update command.