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-appCommands
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