ni - use the right package manager

You can run npm/yarn/pnpm/bun with same command!

• Original: https://github.com/antfu/ni

zinit load azu/ni.zsh

antigen bundle azu/ni.zsh@main

[plugins.ni]
github = "azu/ni.zsh"

curl https://raw.githubusercontent.com/azu/ni.zsh/main/ni.zsh > ni.zsh
source ni.zsh

ni.zsh requires compdef command. If you got command not found: compdef error, you need to enable compinit in your .zshrc.

# .zshrc
# load compdef
autoload -Uz compinit && compinit
# load ni.zsh
source /path/to/ni.zsh

• npm
• yarn (yarn v1)
• yarn-berry (yarn v2+)
• pnpm
• bun
• deno (deno v2.6+)

• zsh
  • require to enable autoload -Uz compinit && compinit
• jq
• npm-check if you want to use npm + ni upgrade-interactive

ni                      -- install current package.json
ni add <pkg>            -- add package
ni remove <pkg>         -- remove package
ni run <script>         -- run scripts
ni test                 -- run test script
ni upgrade [<pkg>]      -- upgrade packages
ni upgrade-interactive  -- upgrade package interactively
ni exec <command>       -- execute command
ni dlx <pkg>            -- download package and execute command

• ^1: require npm-check globally.

Notes

• Installing devDependencies: ni add --dev <pkg>
• Additional arguments for ni run: ni run dev --port 8080
• Update specific package: ni upgrade <pkg>

ni <TAB>

You can integrate Socket Firewall to detect supply chain attacks.

Socket Firewall provides proactive protection against malicious packages by scanning all package installations and executions in real-time.

Setup:

1. Install Socket Firewall globally:

   npm i -g sfw

2. Enable Socket Firewall in ni.zsh:

   export NI_USE_SOCKET_FIREWALL=1

3. (Optional) Specify custom sfw binary path:

   export NI_SOCKET_FIREWALL_BIN=/path/to/sfw

   If not set, uses sfw command from PATH.

Protected commands:

When Socket Firewall is enabled, the following commands are automatically protected:

• ni add / ni - Package installation
• ni exec / ni dlx - Package execution (npx, bunx)

MIT © azu