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
Full docs at github.com/kristianmandrup/packr-registry