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

spi-agent-gui

v0.3.4

Published

sPi - Simple Pi Agent GUI installer and Pi launcher

Readme

sPi - Simple Pi Agent GUI

Lightweight Pi package and desktop installer. Desktop binaries are downloaded from the matching GitHub Release, not included in this npm package. No AppImage, FUSE, native compilation or second copy of Pi is required.

The npm package name is spi-agent-gui. Install with pi install npm:spi-agent-gui, then run spi. The 0.3.2 standalone GitHub installer supports Linux x64/arm64 and Mac Apple Silicon/Intel through one complete manifest. Historical npm versions retain their version-bound older platform lists. Mac bundles are ad-hoc signed, not Developer ID signed or notarized. Windows distribution remains deferred. The package registers /spi and /spi-install; it never launches a GUI just because an extension was loaded. Project/temporary/CI installs and SPI_SKIP_INSTALL=1 skip automatic system-wide side effects. If lifecycle scripts are disabled, use /spi-install or explicitly run npx --package spi-agent-gui spi install.

Desktop 0.3.4 fixes recovery feedback: a visible in-window confirmation replaces native confirm in both recovery entry points, and ordered owner snapshots reconcile missed success events without overwriting newer work/failures. Cancel/Escape are passive, failures stay visible and retryable, and drafts/images/paused outbox protections remain. No polling or model requests are added. Update checks tolerate GitHub anonymous API 403/429 via the same repository's official latest manifest endpoint, with unchanged version/descriptor/checksum validation and no credentials or mirrors. Existing desktops update through GitHub in-app or spi update; npm remains a first-install path. Release notes and scoped build security exception.

Desktop 0.3.3 adds a minimizable pending-message panel: use the − button to dock its counter at the lower-left of the chat, then click to restore editing without losing unsaved text or attachment changes. Expanded/minimized layouts leave user-question arrows and Return to latest clickable, including narrow/short chat viewports with a terminal open. The matching GitHub/npm release follows the separate verification gates; release notes and the temporary build-only security exception.

Desktop 0.3.2 adds stable-version checking, a clickable ! beside Settings, matching-architecture GitHub download/install and confirmed Restart to apply. This path never invokes npm. Because the 0.3.1 launcher's unversioned spi update has an HTTP 415 bug, use the one-time 0.3.2 GitHub bootstrap, then use the GUI updater or corrected command. GitHub is the primary update channel; npm remains a supported first-install entry for pi install users. Future stable releases should provide a matching lightweight npm installer after GitHub verification, without making GUI updates depend on npm publication or approval. Historical npm versions remain pinned: reinstalling an older package does not obtain 0.3.2. Manual app copies are preserved; use the exact managed launch command shown in Settings after migration.

Runtime downloads show percentage, received/total MiB and average speed every 10 seconds, including when interactive npm buffers its postinstall output. A healthy slow transfer has a one-hour overall budget, with a separate 60-second inactivity limit and up to three validated Range/If-Range attempts. The complete archive size/SHA-256 is always verified; prior runtime selection is preserved on failure. SPI_DOWNLOAD_TIMEOUT_SECONDS accepts 60–21600 seconds. Resume applies within one install, not across processes; no permanent cache is implied. Headless log capture can use npm_config_foreground_scripts=true for that command.

If sessions cannot start because desktop PATH differs from your terminal, sPi detects compatible Node from PATH, Pi-managed runtime or login shell. Settings → Node.js runtime also accepts an optional absolute Node executable path, checked before private saving; clear it for automatic lookup. It applies to new/reopened sessions without restarting existing ones or changing Pi/shell configuration.

Desktop 0.2.0 adds optional end-to-end encrypted remote access: a window on one computer can drive sPi on another, relayed through Microsoft Dev Tunnels. It requires the GitHub CLI (gh) signed in to the same GitHub account on both computers; local use never needs gh. In 0.3.0, only one remote connection has control (including terminals), while others are read-only. The oldest connected viewer takes over when the controller disconnects or is revoked. Remote protocol v2 requires both computers to update together; saved pairings are retained. Remote access.

Desktop 0.3.1 adds a context ring/percentage beside Thinking: hover for current used/max tokens, click for native /compact, or right-click for optional instructions. Usage comes from Pi's current context estimate, not cumulative session tokens. Compaction may make a model request; it preserves drafts/outbox, refreshes the summary and remains blocked for read-only viewers or busy sessions. Unknown usage stays unknown instead of showing zero.

Desktop 0.3.0 also adds a visible pending/paired device list: close Settings and return later to view the same pending pairing code; devices save automatically after pairing. One pending invitation at a time, in memory only; restarting invalidates it. Pairing codes default to 1 hour, configurable up to 60 days. Floating Previous/Next question arrows beside the chat scrollbar jump through your own inputs without scrolling through long outputs; navigating history pauses auto-follow until Return to latest.

Desktop 0.1.5 added passive send-triggered RPC checks and explicit recovery, terminal visibility and clipboard context menus, manual/current-model AI session names, confirmed history trash and restored window placement/maximization. AI names are suggestions to review before saving; they incur a normal model request but run no tools and do not add chat entries. Recovery keeps the outbox paused and never blindly replays work. Save important drafts and fully quit the old GUI before reopening; installation does not hot-update a running window. Feature details.

spi --help, spi doctor, spi update, spi rollback, spi uninstall. Use --bin-dir if Pi's PATH directory is not writable or another spi command exists. No shell profile is edited. User preferences and Pi sessions survive uninstall. pi remove removes this package, not the independently installed desktop runtime.

The installer requires Node.js 22.19+; the installed command can use its private Electron runtime's Node mode. Supported platforms are only those present in the verified Release manifest. Unsigned Windows/macOS binaries may trigger OS warnings; do not disable OS protections. Linux needs a glibc desktop environment.