Skip to main content

Install the CLI

Install @packageninja/cli when you want the current Package Ninja command set and package naming. A healthy install gives you the package-ninja command, a working --help output, and local runtime status without requiring a workspace login yet.

Package Ninja uses package-ninja as the canonical command name.

The canonical npm package is @packageninja/cli.

The compatibility package @packageninja/enterprise-cli remains supported, and some older installs may still expose the compatibility executable name package-ninja-ee. If your machine does that, replace package-ninja with package-ninja-ee in the examples below.

How do you install Package Ninja globally?​

npm i -g @packageninja/cli
package-ninja --help

How do you run Package Ninja without a global install?​

npx -y @packageninja/cli --help

What runtime prerequisites does Package Ninja need?​

  • Node.js 22 or newer
  • Windows, macOS, or Linux
  • npm, pnpm, yarn, or bun in target workspaces

How do you verify that the install worked?​

  • version returns package + runtime versions.
  • status returns local runtime health.
  • auth status indicates login required until authorization is complete.
package-ninja version
package-ninja status
package-ninja auth status

How do you upgrade the CLI?​

npm i -g @packageninja/cli@latest

How do you recover from a stale or broken local install?​

package-ninja factory-reset --yes
package-ninja login