pi-upgrade

Automate pi framework upgrades and migrate legacy package names across codebases.

8|1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/mrclrchtr/skills --skill pi-upgrade
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pi-upgrade
Source: https://github.com/mrclrchtr/skills/tree/main/skills/pi-upgrade
Command: npx skills add https://github.com/mrclrchtr/skills --skill pi-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, and includes scripts (resource) components.

What problem does it solve?

Upgrading the pi coding agent framework across a project can be brittle due to version pinning, legacy package names, and scattered documentation. This skill automates detection, migration, installation, and reporting to keep projects current.

Core Features & Use Cases

  • Detects current pi versions from package.json, lockfiles, or node_modules to identify what needs upgrading.
  • Fetches release deltas from earendil-works/pi via the GitHub CLI to surface compatible upgrades and migrations.
  • Bumps version ranges and migrates legacy names across workspace files, then installs using the detected package manager.
  • Generates upgrade reports with actionable recommendations, deprecations, and next steps for developers.

Quick Start

Run the pi-upgrade helper from the project root in dry-run mode to preview changes, then run it again to apply upgrades.

Frequently Asked Questions about pi-upgrade

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate pi framework dependency upgrades across a workspace?▼

Migrate legacy pi package names by replacing old @mariozechner/pi-* references with @earendil-works/pi-* across workspace files during the automated upgrade and installation process.

Do I need the GitHub CLI to fetch pi framework release notes?▼

Yes, you need the GitHub CLI (gh) installed to fetch release deltas from the earendil-works/pi repository and surface compatible upgrades and package migrations.

Can I preview pi framework migration changes before applying them?▼

Yes, you can run the pi-upgrade helper from the project root in dry-run mode to preview dependency changes and migrations, then run it again to apply the upgrades.

What is included in a pi framework upgrade report?▼

A pi framework upgrade report includes actionable recommendations, deprecations, and next steps for developers after bumping version ranges and migrating legacy package names.

Does pi framework migration work with any package manager?▼

Pi framework migration works with supported package managers detected in your project, installing bumped dependencies using the specific package manager found in the workspace.