v2.1.0 is now available

Universal Script Runner for Modern Devs

Write your scripts in JavaScript/TypeScript. Run them anywhere. Automated environment setup, dependency management, and cross-platform compatibility out of the box.

Download Script Read Documentation

Everything you need

Stop writing fragile bash scripts. Start building robust automation with the full power of TypeScript.

Cross-Platform

Write once, run everywhere. Seamless execution on macOS, Linux, and Windows with unified behavior.

Zero Config

Automatic runtime installation. Bun is fetched and configured automatically if missing.

Robust & Safe

Atomic updates with rollback, auto-install integrity checks, and hardened path resolution for supply-chain defense.

Modern Tooling

Built-in formatting, linting, and JSON validation powered by oxlint, oxfmt, and Shfmt.

Quick Start

Get running in seconds. Use the commands below, then explore the full documentation for advanced workflows.

Open Documentation
Install & Run
curl -fsSL https://lguzzon.github.io/runcmd/runcmd.sh -o runcmd.sh
chmod +x runcmd.sh
./runcmd.sh +r my-script.mjs

Unix / macOS

  • Auto-installs Bun to ~/.bun
  • Safe self-formatting and tooling
  • Cross-platform path resolution
  • +check mode for full lint/format audit
  • Integrated debug timing

Windows

  • Supports .js, .mjs, .ts, and .py
  • Auto-installs tools via PowerShell
  • Enhanced debug modes (+d, +dd, +ddd, +d0)
  • +check mode and +r path selection
  • Delayed variable expansion support