singularity-forge/docs/dev/what-is-pi/15-pi-packages-the-ecosystem.md
Jeremy 872b0adb48 docs: reorganize into user-docs/ and dev/ subdirectories
Split flat docs/ into user-docs/ (guides, config, troubleshooting) and
dev/ (ADRs, architecture, extension guides, proposals). Updated
docs/README.md index to reflect new paths.
2026-04-10 09:25:31 -05:00

1.2 KiB

Pi Packages — The Ecosystem

Pi packages bundle extensions, skills, prompts, and themes for distribution via npm or git.

Installing

pi install npm:@foo/bar@1.0.0       # From npm (pinned)
pi install npm:@foo/bar              # From npm (latest)
pi install git:github.com/user/repo  # From git
pi install ./local/path              # From local path
pi list                              # Show installed
pi update                            # Update non-pinned
pi remove npm:@foo/bar               # Uninstall
pi config                            # Enable/disable resources

Creating

Add a pi key to package.json:

{
  "name": "my-pi-package",
  "keywords": ["pi-package"],
  "pi": {
    "extensions": ["./extensions"],
    "skills": ["./skills"],
    "prompts": ["./prompts"],
    "themes": ["./themes"]
  }
}

Or just use conventional directory names (extensions/, skills/, prompts/, themes/) and pi discovers them automatically.

Finding Packages