utoo
utoo (ut) is a fast, modern package manager for JavaScript projects, providing npm-compatible package management with performance optimizations.
utoo is a drop-in replacement for npm with better performance.
Installation
macOS / Linux
No Node.js required. Install with a single command:
curl -fsSL https://utoo.land/install | bashQuick Start
1. Install dependencies
ut install2. Add a package
ut install lodash
ut install -D typescript3. Run scripts
ut build
ut dev4. Execute remote packages
utx create-react-app my-appPerformance comparison
utoo is optimized around dependency resolution, download reuse, and global package-cache reuse. The table below shows the ant-design phased install benchmark measured on 2026-08-27 in a Linux China x86_64 environment connected directly to https://registry.npmmirror.com. Lower is better.
| Scenario | utoo | Bun | pnpm 10 | pnpm 12 | aube |
|---|---|---|---|---|---|
Full cold (p0) | 12.04s ± 1.25s | 19.63s ± 1.32s | 33.88s ± 0.64s | 18.50s ± 6.22s | 26.47s ± 7.65s |
Lock-only cold (p3) | 22.28s ± 12.71s | 31.75s ± 15.11s | 40.70s ± 11.64s | 31.67s ± 10.09s | — |
Warm (p4) | 1.22s ± 0.07s | 4.58s ± 0.32s | 9.86s ± 0.48s | 2.60s ± 0.09s | — |
Utoo has the fastest mean in all three valid install states. Variance is high in p0 / p3, so those are directional results; the low-variance p4 signal is the strongest. Aube’s p3 / p4 cells were rejected because the expected lockfile was missing. See performance benchmarks for the full GitHub Actions npmjs results.
Commands
All Commands
| Command | Alias | Description |
|---|---|---|
install | i | Install project dependencies |
uninstall | un | Uninstall spec dependencies |
run | r | Run scripts defined in package.json |
execute | x | Run a command from a local or remote npm package |
view | v, info, show | View package information |
list | ls | List dependencies like npm list |
link | ln | Link a package like npm link |
deps | d | Generate package-lock.json only |
update | u | Remove node_modules and reinstall |
rebuild | rb | Rebuild scripts hooks in all packages |
clean | c | Clean package cache in global storage |
pm-pack | pk | Create a tarball from a package |
ping | pg | Ping npm registry |
login | lg | Login to npm registry |
logout | lo | Logout from npm registry |
whoami | who | Display npm username |
config | cfg | Manage configuration |
init | create | Create a package.json file |
publish | pub | Publish a package to the registry |
completions | cmp | Generate shell completion scripts |
* | — | Any unknown name falls through to ut run * |
Per-command options are listed in each command’s section; run ut <command> --help to see them in the terminal.
Global Options
| Option | Description |
|---|---|
-h, --help | Print help information |
-v, --version | Print version information |
Features
Global Cache
Installed packages are cached by package/version in ~/.cache/nm/. Subsequent installs hard-link directly from the cache, skipping download and extraction. Each version is stored only once on disk, shared across projects.
~/.cache/nm/
├── lodash/4.17.21.tgz
├── react/18.3.0.tgz
└── typescript/5.6.0.tgzRegistry Acceleration
When the configured registry is cnpm-compatible (registry.npmmirror.com and similar), utoo automatically enables two optimizations: semver query acceleration (server-side version resolution) and binary mirror (native-module downloads redirected to a CDN). Both are off on the official npm registry.
See Registry Acceleration for how each works, and ut ping to probe a registry from the CLI.
Migrate from pnpm
One command to migrate from a pnpm project, automatically converting workspaces, overrides, and catalog configuration from pnpm-workspace.yaml:
ut install --from pnpmSee Migrating from pnpm for details.
Shortcut Execution
You can run package.json scripts directly without run:
ut build # same as: ut run build
ut dev # same as: ut run dev
ut test # same as: ut run test