Skip to content

Quickstart

How to install a powerup and use it.

Powerups can be installed from either npm or git repos:

Terminal window
pup install npm:@liolocs/powerup-hello-world

Add --local to install into the project store instead of the global store, and --dry-run to preview what would happen.

Apply a powerup in a project, passing its variables as flags:

Terminal window
pup use powerup-hello-world

Add --dry-run to print the rendered output instead of writing files, and --target-dir to run against a different directory.

Every pup use records what it wrote in .powerups/manifest.jsonl — the applied manifest that powers diagnosis and repair workflows.

You can remove the powerup by using just the powerup name:

Terminal window
pup uninstall powerup-hello-world

or by using the full package source:

Terminal window
pup uninstall npm:@liolocs/powerup-hello-world

Like install, it removes from the global store unless you pass --local.