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.