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

pistead

v0.4.1

Published

Connect your Linux or WSL2 Pi host to a Pistead workspace.

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Maintainers

quabugquabug

Keywords

pisteadpiagentconnector

Readme

pistead

Connect your Linux or WSL2 Pi host to a Pistead workspace. The connector uses outbound WebSocket only; no inbound port or tunnel is needed.

Requirements

  • Linux or WSL2 (native Windows is unsupported)
  • Node.js 24 or newer
  • Pi configured locally with the providers and models you want to offer
  • bubblewrap, Python 3, Git and flock (util-linux)

Usage

In Pistead, open Connections, choose a workspace and create a pairing code. Then run, on the Pi host:

npx pistead@latest connect --server https://pistead.com --pairing-id PAIRING_ID

Enter the single-use code when prompted; it is never accepted as an argument. Later runs reuse the private saved connector token:

npx pistead@latest connect

Run npx pistead connect --help for all options.

Workspace repositories can come from GitHub, GitHub Enterprise Server, GitLab (gitlab.com or self-managed), Bitbucket Cloud, Azure DevOps and Gitea/Forgejo. Connect the non-GitHub accounts in the web app under Settings → Profile → Git accounts with personal access tokens. The Pistead server downloads pinned snapshots; the connector never receives those tokens. Non-GitHub repositories need connector 0.4.0 or newer.

Model credentials stay in Pi on your host. Pairing keeps the host private to you; sharing it with a workspace is a separate, explicit action in the web app.

The connector offers the models matched by enabledModels in Pi's settings.json (the same patterns Pi uses for model cycling, e.g. "anthropic/*", "*/claude-opus-5-5*"), or every authenticated Pi model when that list is unset. --model PROVIDER/MODEL (repeatable) overrides both.

macOS and hosts without bubblewrap

The isolated sandbox needs Linux. On macOS, or Linux without bubblewrap, you can opt out of isolation:

npx pistead@latest connect --unsafe-no-sandbox

This needs only Git on your PATH (on macOS: xcode-select --install or brew install git). The connector prints the risks and asks you to type unsandboxed before starting:

  • Approved shell commands and commits run directly as your user, with access to your files, credentials (~/.ssh, cloud and Git config, Pi's auth) and network, and no CPU, memory or disk limits.
  • File tools are confined to each session folder by path checks only.
  • Anyone you share the Pi with, and anyone granted approve permission on a session that runs on it, can cause approved commands to run on your machine.

Every command needs an exact human approval unless the session's owner turns on Auto-approve in the chat box; then that owner's commands and commits run immediately (GitHub comments still need approval). Pistead labels the host Unsandboxed to everyone who can see it.

Chat options

In a session's chat box you can pick any model this host's Pi offers, its reasoning level, and the access mode for each message: Read only, Ask before acting (the default) or Auto-approve (session owner only). Hosts running a connector older than 0.3.0 keep each session's pinned model; restart the connector with npx pistead@latest connect to enable the options.

License

MIT