numan

Anthony Thompson·tonythethompson.numan

Cross-platform package manager for Nushell

Numan installs plugins, modules, scripts, and completions from signed registries, pins immutable artifacts in a lockfile, and activates them with Nu only when you run numan activate.

winget install --id tonythethompson.numan --exact --source winget

Latest 0.1.5·July 29, 2026

Release Notes

[0.1.5] - 2026-07-29 Added

  • numan setup nu installs an official managed Nushell release, optionally pinned with --version; --use-existing repairs an off-PATH installation without downloading another copy
  • numan setup loader installs the bundled nushell-loader integration
  • Compatibility-aware discovery: search hides incompatible packages by default (--all reveals them), info explains version compatibility, and install errors report the actual Nu/platform mismatch
  • numan try installs and activates a curated starter compatible with the current Nu and platform, with managed-Nu pin offers when no starter matches
  • Doctor findings distinguish PATH and managed Nu versions and report the built-in official trust-root identity
  • Install support for .tar.xz / .txz package archives (alongside .zip, .tar.gz/.tgz, and .tar)
  • numan completions nushell (alias nu) via clap_complete_nushell, with a vendor-autoload install hint
  • Active-plugin mutation gate (Issue #22 PR1): refuse remove/update while a plugin activation record exists; doctor info activation.plugin_mutation_gated (docs/active-plugin-gate.md)
  • Journaled plugin deactivate (Issue #22 PR2): numan deactivate unregisters via injectable plugin rm seam, clears PluginActivation without deleting payload; pending journal state/pending-plugin-deactivate.json
  • Active-plugin update orchestration (Issue #22 PR3): default off; only exact NUMAN_ENABLE_ACTIVE_PLUGIN_MUTATION=1 enables deactivate→upgrade→reactivate via the activate/deactivate-owned cmd::plugin_lifecycle boundary
  • Cross-platform real-Nu acceptance coverage for active-plugin update, plus a Windows official-registry Stage 1 lifecycle harness Fixed
  • Autoload journal recovery is command-independent and reconciles pending state before later mutations
  • Managed Nu bootstrap verifies release-asset size and SHA256 metadata, validates the installed binary, cleans up failed downloads, and discovers supported off-PATH installations more reliably
  • numan try gives actionable managed-Nu pin or package-search guidance when no curated starter matches, without silently switching Nu
  • PowerShell completions no longer emit top-of-script using namespace directives, so numan completions powershell can be appended to an existing $PROFILE without a ParserError
  • README PowerShell install used Out-File (overwrites $PROFILE); docs now use Add-Content or a dedicated completions file Changed
  • numan remove --force no longer bypasses active plugin activation (still bypasses active module activation only)
  • Active-plugin gate hint directs users to numan deactivate then numan remove
  • Active-plugin update is fail-closed and opt-in (default off; only exact NUMAN_ENABLE_ACTIVE_PLUGIN_MUTATION=1 enables it; unset or alternative values refuse); remove remains gated until deactivate
  • Official registry Stage 1 acceptance: after list, run deactivate → remove → gc
  • numan completions prints a copy-ready install command on stderr after the script (stdout stays pipe-safe)
  • WinGet uses the all-lowercase tonythethompson.numan identifier and publishes update PRs automatically after each GitHub release; unsupported Homebrew packaging was removed

Installer type: zip

x642D855B3B8A9BB3C568051024B8AAE9771A63C427CB3EDFD3AC3AA3AA6D78468D

Details

Homepage
https://github.com/tonythethompson/numan
License
MIT
Publisher
Anthony Thompson
Support
https://github.com/tonythethompson/numan/issues
Moniker
numan

Tags

clinushellpackage-manager

Older versions (1)

0.1.4
x64F843A717BD7FD13F2D86BF727D2292DCF9831F2544A3DF88987104299229EF9D