Public CLI
Local audit and sandbox receipts for package decisions.
The public Nipmod CLI is the local host side of the product: inspectable source for deep scan, sandbox-audit receipts and decision-bound runtime checks before package code is trusted.
- Source
- public
- Hosted API
- read only
- Runtime
- explicit approval
- Receipts
- hash bound
Where the CLI fits
Review before local action
Use the website for search, then use the CLI when you need local proof against an artifact or source snapshot.
Host-controlled execution boundary
Agents can call the hosted API for a decision, but local audit and runtime checks stay inside the user's host.
Inspectable local code
The public repository includes the CLI source and tests so the local audit path can be inspected.
Open public CLI sourceInstall
npx nipmod --help
pnpm dlx nipmod --help
npm install -g nipmodThe package is publish-ready. Until npm publishing is performed, run from the public repository with pnpm --dir cli cli -- help.
Core local checks
nipmod deep-scan <artifact-or-source-path> --json
nipmod sandbox-audit <artifact-or-source-path> --decision decision.json --target-confirmed --json
nipmod sandbox-runtime <artifact-or-source-path> --decision decision.json --target-confirmed --dry-run -- node --versionApproval sequence
- 1
Decide
Call the hosted decision endpoint and save the exact decision JSON.
- 2
Audit
Run sandbox-audit locally against the exact artifact or source snapshot.
- 3
Bind
Compare the receipt to the decision hash, content hash and policy hash.
- 4
Approve
Ask the user or host policy for approval only after required checks are complete.
- 5
Run
Use sandbox-runtime only when behavior must be observed and approval has been explicit.
Runtime checks
nipmod sandbox-runtime <artifact-or-source-path> \
--decision decision.json \
--target-confirmed \
--confirm-runtime \
-- node --version--dry-run never executes the command. --confirm-runtime is required for behavior checks.
Command scope
Agent instruction
Use Nipmod's hosted API for search and decision.
Use Nipmod CLI only for local host-controlled checks.
Run sandbox-audit against the exact artifact or source snapshot before approval when required.
Use sandbox-runtime only after explicit user or host approval.
Do not treat a CLI receipt as automatic permission to install or execute.