One command. Any project. Zero configuration.
run test
That's it. Whether your project uses npm, yarn, pnpm, bun, cargo, poetry, gradle, or any of 20+ other tools — run figures it out.
Every project has its own package manager. Every time you switch projects, you ask yourself:
"Was this npm or yarn? pnpm? Does it have a Makefile?"
run eliminates this friction. Just type run <command> and it works.
# Linux/macOS
curl -fsSL install.cat/verseles/run | bash
# Windows (PowerShell)
irm install.cat/verseles/run | iex
# Or via Cargo
cargo install run-clirun test# Runs test with detected tool
run build # Runs build
run lint # Runs lint
run dev # Runs dev server# Pass arguments after --
run test -- --coverage --watch
# Works from any subdirectorycd src/components && run test# Finds package.json in parent dirs| Ecosystem | Tools (priority order) |
|---|---|
| Monorepo | nx → turbo → lerna |
| Node.js | bun → pnpm → yarn → npm |
| Deno | deno |
| Python | uv → poetry → pipenv → pip |
| Rust | cargo |
| PHP | composer |
| Go | task → go |
| Ruby | bundler → rake |
| Java | gradle → maven |
| .NET | dotnet |
| Elixir | mix |
| Swift | swift (SPM) |
| Zig | zig |
| Generic | just → make |
Detection is based on lockfiles first (more specific), then manifest files.
run test --dry-run # Show command without executing
run test --verbose # Show detection details
run test --quiet # Suppress output except errors
run test --levels=5 # Search up to 5 parent directories (default: 3)
run test --ignore=npm,yarn # Skip specific runners
run --update # Force update checkCreate ~/.config/run/config.toml for global settings:
max_levels = 5auto_update = trueignore_tools = ["npm"]
# Advanced update settings (optional)
[update]
enabled = true# Enable auto-update (default: true)check_interval_hours = 2# Hours between update checks (default: 2)Or run.toml in your project for local overrides.
Precedence: CLI args > local config > global config > defaults
When multiple lockfiles exist (e.g., package-lock.json + yarn.lock):
- Corepack — If
package.jsonhas apackageManagerfield, uses that tool - If only one tool is installed → uses it with a warning
- If multiple tools installed → error with suggested action
- If no tools installed → shows installation instructions
| Code | Meaning |
|---|---|
| 0 | Success (passes through original exit code) |
| 1 | Generic error |
| 2 | No runner found |
| 3 | Lockfile conflict |
| 127 | Tool not installed |
Updates happen silently in the background after commands complete (every 2 hours by default).
Disable with:
- Environment variable:
RUN_NO_UPDATE=1 - Legacy config:
auto_update = false - New config section:
[update] enabled = false
# Bash
run completions bash >~/.local/share/bash-completion/completions/run
# Zsh
run completions zsh >~/.zsh/completion/_run
# Fish
run completions fish >~/.config/fish/completions/run.fish
# PowerShell
run completions powershell >>$PROFILEgit clone https://github.com/verseles/run.git
cd run
make precommit # Format, lint, test, audit
cargo build --releaseAGPL-3.0. See LICENSE.
Made with mass production by Verseles