npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

pi-health-check

v0.1.2

Published

Startup diagnostics for the pi extension ecosystem: detect missing dependencies, duplicate packages, and skills referencing unregistered tools.

Readme

pi-health-check

Startup diagnostics for the pi extension ecosystem.

Detects missing dependencies, duplicate packages, and skills that reference unregistered tools — before they cause silent failures or startup crashes.

What it detects

| # | Check | Severity | Description | |---|-------|----------|-------------| | 1 | Missing dependency | error | Extension package.json declares a dependency that is not installed in node_modules | | 2 | Duplicate package | warning/error | Same package loaded from multiple paths (same version = warning, different versions = error) | | 3 | Missing skill tool | warning | Skill frontmatter requires-tools declares a tool that is not registered | | 4 | Possible missing tool | info | Skill body mentions a known optional tool name (e.g. subagent) that is not registered |

Install

pi install npm:pi-health-check

Or from git:

pi install git:github.com:fengshuai/pi-health-check.git

Usage

The extension activates automatically on session start. Three entry points:

1. Startup notification

If issues are found, a one-line warning appears at startup:

Warning: pi-health-check: 12 errors. Run /doctor for details.

2. /doctor command (interactive TUI)

/doctor

Renders a scrollable report with severity icons, affected paths, and fix suggestions:

✗ pi-health-check diagnostics report

Found: 12 errors
12 diagnostics total

✗ Missing dependency
  Extension "pi-subagents" requires npm package "jiti" but it is not installed.
  Extension: /home/user/.pi/agent/npm/node_modules/pi-subagents/index.ts
  Expected at: .../node_modules/jiti
  -> Run: cd "..." && npm install

Press Enter/Esc to close · j/k to scroll

3. doctor tool (LLM-callable)

The LLM can call the doctor tool when it encounters a "tool not found" error, to self-diagnose the ecosystem and get a structured report.

Skill dependency declaration

Skills can declare required tools in frontmatter:

---
name: my-skill
description: ...
requires-tools: [subagent, mcp__context7]
---

Skill body...

The checker validates these against the registered tool set. Supports glob patterns (mcp__*).

What it does NOT do

  • Does not auto-fix or auto-install anything (only reports + suggests commands)
  • Does not modify pi core or settings
  • Does not send data anywhere (purely local filesystem scan)

How it works

The extension reads the filesystem directly (~/.pi/agent/extensions/, .pi/extensions/, ~/.pi/agent/skills/, .pi/skills/, npm node_modules dirs) and compares against pi.getAllTools(). No resourceLoader API dependency.

License

MIT