pi-fastboot

Make Pi startup feel close to PI_OFFLINE=1 while still letting npm-based extensions update

Package details

← Back
extension

Install pi-fastboot from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-fastboot
Package
pi-fastboot
Version
1.0.0
Published
Apr 24, 2026
Downloads
124/mo · 124/wk
Author
sting8k
License
MIT
Types
extension
Size
6 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-fastboot

Quick & dirty pi extension that makes normal Pi startup feel close to PI_OFFLINE=1, while still letting npm-based extensions update. It pins npm: package versions in ~/.pi/agent/settings.json after startup, so the next launch can skip npm registry resolution without turning offline mode on.

Pinned startup was roughly the same as PI_OFFLINE=1 for the measured paths: about 0.48–0.49s for pi --version and 1.15–1.18s for pi --help.

Install

pi install npm:pi-fastboot

How it works

Add npm packages to Pi as usual:

{
    "packages": [
        "npm:@sting8k/pi-vcc"
    ]
}

After a Pi session starts, pi-fastboot checks those npm packages in the background and rewrites them with the latest version:

{
    "packages": [
        "npm:@sting8k/pi-vcc@0.3.11"
    ]
}

The update is non-blocking, so it should not slow down the current startup. The benefit is on the next launch, when Pi no longer needs to resolve unpinned npm packages.

Disable

To disable pi-fastboot, set enabled to false in the agent settings: ~/.pi/agent/settings.json

{
    "pi-fastboot": {
        "enabled": false
    }
}

Notes

  • Registry lookups time out after 5 seconds.
  • If a lookup fails, the package entry is left unchanged.

License

MIT