node • yarn • pnpm • bun
- Universal - Picks the right package manager and runtime based on the lockfile.
npm,bun,pnpm,yarn- we got you covered! - Versatile - Handles the basics like installing all your dependencies, adding new packages, and kicking off scripts.
- Speedy - Crafted in Rust to give you a quick ride. When running scripts, it's actually faster than using PMs directly!
- TypeScript-Ready - Adding a new dependency? Don't worry! It'll fetch any missing
@typespackages for you if needed.
ny # installs all dependencies eq. to: yarn installny add zod # installs zod package eq. to: yarn add zodny test # executes package.json's test script eq. to: yarn testny vitest # executes node_modules/.bin binary eq. to: yarn vitestcurl -fsSL https://raw.githubusercontent.com/krzkaczor/ny/main/install.sh | bashGet the newest release from releases page.
For full documentation run ny --help.
ny install- trigger installing all dependencies. Aliased to:ny.ny add package- add new dependency, supports flags like--devand--workspace-root. Will automatically install missing TypeScript@typespackages.ny run task- runs a task with a given name or resolves a JS file innode_modules/bin. Will use node.js to execute it by default unless bun lockfile is present. Aliased to:ny task.
In the world of JavaScript, there's a fun mix of package managers - npm, yarn, pnpm. Pick your poison. With a rise of alternative runtimes like Bun or Deno the problem only gets worse. Programmers often switch between projects that use different PMs multiple times a day. Did you just typed npm when the project uses bun? Well too bad -- you've wasted couple of seconds again. With 🗽NY, there's no guesswork. Just type ny and it picks the right package manager and runtime for you. Handy, right?
And here's the kicker: 🗽NY is faster! Especially when running package scripts (like when you type yarn test). It's written in Rust and it zips through tasks about ~200ms faster by avoiding spawning node processes just to parse package.json. Sweet, huh?
Main sources of inspiration were antfu/ni (but it's written in JS) and egoist/dum (but it's only a task runner).
If ny detects that it's running in TypeScript enabled package, it will attempt to install missing typings when adding new packages. Right now this behaviour can't be turned off.
All contributions are welcomed! Read contributing guide for more.
Logo should depict a statue of liberty (a symbol of New York ;) ) holding tools. Midjourney prompt goes something like: simple mascot, statue of liberty holding tools, pixelart style. Later vectorizer.ai was used to get SVG out of bitmap.
I know it's not perfect and if you figure out a better prompt let me know!
Kris Kaczor | MIT