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

proofpack-cli

v0.3.2

Published

Local acceptance reports for AI-assisted code changes

Readme

Proofpack

An evidence receipt for AI-assisted code changes.

After a coding agent says "done", Proofpack shows what Git can see, which checks actually ran, and what remains unchecked. It runs locally, needs no account, and never gives a "safe to merge" verdict.

npx -y [email protected] proofpack check --run "npm test"

The command prints a Markdown report to stdout. Default inspection is read-only; npm test runs only because it was explicitly supplied with --run.

Proofpack report example

## Change
- Git-visible files: 2
- Diff summary: 18 insertions · 2 deletions

## Checks
- Explicit commands requested: 1
- Observed outcomes: 1 passed · 0 failed · 0 not run
- npm test: passed · exit 0

## Not checked
- Lint, build, dependency audits, and runtime behavior were not run.

Repository: 2648782102/proofpack-cli · npm: proofpack-cli · Release: v0.3.2

What it is for

Proofpack helps an individual developer answer three questions after a coding task: what changed, what checks actually ran, and what remains unchecked. It records Git change facts, explicit command evidence, and heuristic review prompts; it does not claim that a change is correct.

The report separates observed facts, heuristic prompts, and unchecked work. A passing command is evidence of that invocation only.

Product principles

  • One command, one readable report.
  • Local by default; no account, daemon, model API, or upload.
  • Observed facts, heuristic prompts, and unchecked work are separated.
  • No project command runs unless the user explicitly supplies --run.
  • Git inspection is read-only; explicitly run commands use the user's shell and privileges without a sandbox.

Current distribution shapes

The 0.3.2 package contains both the proofpack CLI and the proofpack-mcp stdio entrypoint. MCP is a host-launched local subprocess, not a cloud service or a host plugin. See docs/MCP.md for the protocol contract and host configuration.

MCP quick start

After installing the package in a project, configure an MCP host to launch the local binary:

{
  "mcpServers": {
    "proofpack": {
      "command": "npx",
      "args": ["-y", "[email protected]", "proofpack-mcp"]
    }
  }
}

The host then sees one read-only proofpack_check tool. It generates a Markdown or JSON acceptance report without executing project commands or writing files.

Install and first use

Use npm without a global install:

npx -y [email protected] proofpack check

Or install the package in a project:

npm install --save-dev [email protected]
npx proofpack check

The CLI binary is named proofpack; the MCP binary is named proofpack-mcp.

This prints a Markdown report to stdout without changing the working tree, running project commands, or making network requests. To save it, pass an explicit path:

npx -y [email protected] proofpack check --output .proofpack/review.md

Explicit checks

npx -y [email protected] proofpack check --run "npm test" --run "npm run lint"
npx -y [email protected] proofpack check --run "npm test" --format json
npx -y [email protected] proofpack check --run "npm test" --format markdown,json --output .proofpack/review.md

Each command is previewed before execution, run sequentially from the repository root through the user's shell, and recorded with timing, exit status, bounded stdout/stderr, truncation, and best-effort redaction. --timeout <seconds> defaults to 120 and applies per command. Multiple formats require --output and write sibling .md / .json files.

Commands are not sandboxed and can modify the working tree. Review every command and its output before sharing a report. Passing checks are evidence of those invocations only, not proof of correctness or security.

Branch/base and sharing

npx -y [email protected] proofpack check --base main
npx -y [email protected] proofpack check --run "npm test" --share-safe --output .proofpack/share.md
npx -y [email protected] proofpack check --output .proofpack/review.md --open

--base compares committed, staged, and working-tree changes against a resolved Git ref and excludes untracked files from that view. --share-safe omits branch, HEAD, base commit, file paths, output destination, command text, command output, and prompt evidence from both Markdown and JSON; status, counts, timings, and limitations remain. --open is opt-in, requires a written Markdown report, and uses the system opener. It never uploads the report.

Review even share-safe reports before sharing: omission is best-effort and aggregate metadata may still be sensitive.

What it does not do

Proofpack does not discover or run package scripts automatically, infer test or build results, review code with an AI, assign a correctness score, approve changes, upload reports, collect telemetry, or sandbox explicit --run commands. Commands supplied with --run use the current user's shell and privileges.

The MCP adapter is narrower still: its single proofpack_check tool performs read-only Git inspection and does not execute project commands, write report files, open applications, make network requests, or invoke a model.

Early development: repository-local init, sandboxed execution, CI-result import, and agent-trace import are not implemented. See roadmap and MCP contract.

Development

Requirements: Node.js 24 or newer.

npm install
npm run dev -- check
npm run check
npm test
npm run build

Documents

License

MIT. See LICENSE.