OpenPacker
Open Package Manager (opm / opmx) plus a PREX control plane for
multi-ecosystem package identity, locks, proofs, and digests.
Status: Private reference implementation of the PREX draft. This is not a
production package registry.
AI usage: Maintainers and contributors may use AI coding tools under human
review. See
CONTRIBUTING.md.
Package manager: opm and opmx
This is the product surface for add / remove / sync / install / uninstall
and running installed package binaries.
Scope: after the project explicitly enables the npm adapter in opm.toml
(project.ecosystems = ["npm"]), opm add pkg:npm/[email protected] resolves
against the real registry, verifies the bytes, and locks the proof-checked
closure. --offline refuses the network. Explicit source = / catalog
entries win when present. See
docs/guides/opm.md for the full
order.
npm ci
npm run build
npm link -w @openpacker/cli # puts opm, opmx, opkg, opkgm on PATH
mkdir my-app && cd my-app
opm init
opm add pkg:npm/@openpacker/[email protected] \
--source /path/to/demo-tool-1.1.0.tgz \
--offline
opm list
opmx demo-tool --version
Offline demo in this repo
npm ci && npm run build
cd examples/opm-project
node ../../apps/openpacker-cli/dist/opm.js sync --offline
node ../../apps/openpacker-cli/dist/opm.js list
node ../../apps/openpacker-cli/dist/opmx.js demo-tool --version
# → 1.1.0
| Command | Purpose |
|---|
opm init | Create opm.toml + .opm/ |
opm import --native | Ingest native manifests into opm.toml |
opm add <spec> | Add package to manifest, lock, and install |
opm remove <alias> | Remove from manifest, lock, and install |
opm install | Materialize everything in opm.lock.json |
opm ci | Install exactly package-lock.json |
opm uninstall [alias] | Remove install links/bins |
opm sync | Resolve manifest → lock → install |
opm list / opm why | Inspect the project graph |
opm run [script] | Run a package.json script (unsandboxed) |
opm exec <bin> | Run a node_modules/.bin executable |
opm -r run <script> | Run it in workspace members (--filter) |
opmx <bin|pkg> | Execute an installed binary |
Project layout:
opm.toml # requirements
opm.lock.json # exact pins + digests
.opm/store/ # content-addressed packages
.opm/bin/ # executable shims
Full manual: docs/guides/opm.md · ADR:
0022
Aliases: opkg, opkgm → opm.
Advanced: PREX control plane
For protocol operations (normalize, solve, import-lock, prove digests) use the
same opm binary with PREX verbs — not the project-manager commands above.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
