uni-run

A universal CLI tool to run scripts in any language — JavaScript, TypeScript, Python, Java, C, C++, Rust, Go, Ruby, PHP, Dart, Lua, and more. One command, any script, with watch mode, benchmarking, and automatic runtime detection.

Features

• 19+ languages supported out of the box, including compiled languages (C, C++, Rust, C#)
• Watch mode — automatically re-runs on file changes with .gitignore-aware filtering
• Reload keys — press Ctrl+R or F5 to re-run without saving
• Benchmarking — measure execution time with --bench
• Configurable runtimes — swap between node/bun/deno, python/uv, and more via ~/.uni-run.json
• Environment variables — inject env vars with --env KEY=VALUE
• Exec mode — run any arbitrary binary with run exec
• Cross-platform — works on Windows, macOS, and Linux

Installation

npm install -g uni-run

CLI Usage

run <script> [options] -- [args for script]
uni-run <script> [options] -- [args for script]

rux / uni-rux are aliases that run once and exit (no watch mode, keeps console output):

rux <script> [options] -- [args for script]
uni-rux <script> [options] -- [args for script]

Examples

run ./main.ts
run ./main.py
run ./Main.java
run ./hello.c
run ./main.js -- --port 3000

Subcommands

run exec <binary> [args]     # Execute an arbitrary binary
run list                     # List all supported script types
run clean                    # Clean the temp/cache directory

Options

Watch Mode

| Flag | Alias | Description | | ------------------------ | ----- | ------------------------------------------- | | --do-not-watch | -dw | Disable watch mode | | --ext <exts...> | -e | Watch only specific extensions | | --focus <paths...> | -f | Watch only specific paths (chokidar syntax) | | --ignore <patterns...> | -ig | Exclude paths (.gitignore syntax) | | --delay <ms> | -d | Debounce delay in ms (default: 100) |

Reload / Console

| Flag | Alias | Description | | ---------------------- | ------ | ----------------------------- | | --disable-reload-key | -dk | Disable Ctrl+R / F5 reload | | --disable-raw-stdin | -drs | Disable raw stdin mode | | --keep | -k | Don't clear console on reload | | --silent | -s | Suppress script output |

Execution

| Flag | Description | | ---------------------- | ------------------------------------- | | --exit | Run once and exit (default for rux) | | --shell | Run in shell mode | | --cwd <path> | Set working directory | | --env <KEY=VALUE...> | Set environment variables | | --node-dev | Set NODE_ENV=development |

Benchmarking / Info

| Flag | Alias | Description | | ----------------------- | ----- | ---------------------------------- | | --bench | -b | Show execution time | | --bench-prefix <text> | -bp | Custom prefix for benchmark output | | --info | | Show execution information | | --time | | Show start time |

Configuration

Create ~/.uni-run.json to override default runtimes:

{
  "$schema": "https://github.com/NazmusSayad/uni-run/raw/refs/heads/main/public/uni-run.schema.json",
  "runtime": {
    "python": "uv",
    "javascript": "bun",
    "typescript": "deno"
  }
}

Configurable Runtimes

| Language | Options | Default | | ---------- | ------------------------------- | ------------ | | JavaScript | node, deno, bun | node | | TypeScript | tsx, ts-node, deno, bun | tsx | | Python | python, python3, uv | python | | Dart | dart, dartvm | dart | | PowerShell | powershell, pwsh | powershell | | Shell | bash, zsh, sh | bash | | Lua | lua, luac, luajit | lua |

Supported Languages

| Language | Extensions | | ------------------ | ------------------------------------------ | | JavaScript | .js .jsx .mjs .cjs .cjsx .mjsx | | TypeScript | .ts .tsx .mts .cts .mtsx .ctsx | | Python | .py | | Java | .java | | Dart | .dart | | PowerShell | .ps1 | | Command Prompt | .cmd .bat | | Shell Script | .sh | | Fish Shell | .fish | | Lua | .lua | | Ruby | .rb | | Go | .go | | C (GCC) | .c | | C++ (G++) | .cpp | | C# (Mono) | .cs | | Rust (rustc) | .rs | | SASS/SCSS | .sass .scss | | PHP | .php | | HTML (live-server) | .html .htm |

Compiled languages (C, C++, C#, Rust) are compiled to a temp directory and executed automatically. Use run clean to remove compiled artifacts.