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

Reload / Console

Execution

Benchmarking / Info

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

Supported Languages

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