Documentation

Everything you need to get started with Packr.

Quick Start
Get up and running in 5 minutes
  • 1. docker run -p 4873:4873 packr-registry
  • 2. packr-cli login myuser mypass
  • 3. Configure .npmrc with scope + token
  • 4. npm publish
CI Setup
Non-interactive auth for pipelines
  • GitHub Action — one-step login + publish
  • curl login — works in any CI
  • JWT tokens valid for 90 days
  • Scoped tokens (read-only / publish)
CLI Reference
packr-cli commands
  • login <user> <pass>
  • token create | list | revoke
  • user create <name>
  • license activate | status
  • agent-info | agent-search
API Reference
REST API + OpenAPI spec
  • POST /-/v1/login — JWT token
  • GET/PUT /:scope/:pkg — CRUD
  • PUT /-/v1/deprecate — deprecate
  • GET /openapi.json — full spec
  • Structured error codes
Agent API
AI-optimized endpoints
  • /agent/:pkg — quality score + info
  • /agent/search?q= — capability search
  • /agent/compare — side-by-side
  • /agent/:pkg/deps — dep graph
  • Download counts in responses
Storage
Database + blob config
  • SQLite — zero config default
  • PostgreSQL — STORAGE_DRIVER=postgres
  • Supabase — BLOB_DRIVER=supabase
  • Backblaze B2 — BLOB_DRIVER=backblaze
  • Presigned URLs for S3 downloads
Webhooks
Event notifications
  • package.published
  • package.deprecated
  • token.created / token.revoked
  • HMAC-SHA256 signed payloads
  • Manage in dashboard Settings
SDK & MCP
Programmatic access
  • @packr/agent — TypeScript SDK
  • @packr/mcp-server — Claude tool
  • Search, compare, info, deps
  • Works with Claude Code + Desktop
Dashboard
Web UI features
  • Search with scope filter + sort
  • Token analytics (requests, last used)
  • Webhook management UI
  • 3 themes + sound effects
  • Mobile responsive sidebar