Home

Numan Wiki

Numan is a cross-platform package manager for Nushell. It installs plugins, modules, scripts, and completions from signed registries, pins immutable artifacts in a lockfile, and activates them with Nu only when you ask. Installs stay inert until you run numan activate.

Built in Rust for Linux, macOS, and Windows. Current release: v0.1.4.

Repository	tonythethompson/numan
Official registry	numan-registry
License	MIT

Start here

1. Installation — binaries, Homebrew, crates.io, winget, from source
2. Quick Start — init → registry sync → install → activate → doctor
3. CLI Reference — command and flag overview

Concepts

• Introduction — what Numan is and why it exists
• Inert Installation — install never touches Nu
• Activation and Deactivation — plugins and module autoloads
• Architecture — module layout and data flow

Day-to-day use

• Doctor — diagnose and repair a Numan root
• Snapshots and Rollback — undo a bad activate/update/remove
• Update, Remove, and GC — lifecycle commands
• Shell Completions — bash, zsh, fish, PowerShell
• Registry Management — sync, trust, custom registries

nupm migration

• nupm Interoperability — coexistence model
• nupm Inspect and Import — one-way import
• nupm Drift Detection — compare imported payloads to nupm sources

Internals

• Lockfile Schema
• Crash Recovery Journals
• Immutable Payloads
• Nu Paths Cache
• Nushell Interop
• Filesystem Safety
• Cryptographic Trust
• Version Resolution

Packaging and contributing

• Release Process
• Homebrew
• Winget
• Contributing
• Testing

Related docs in the repo

Canonical specs that live in the main repository (not duplicated here in full):

• docs/numan-doctor.md
• docs/snapshots-and-rollback.md
• docs/nupm-compatibility.md
• docs/PACKAGING.md
• docs/RELEASING.md
• CONTRIBUTING.md