run(1)

NAME
run - Run a project task or exec a command through the detected package manager

SYNOPSIS
run [--dir] [--pm] [--runner] [--fallback] [--on-mismatch] [--explain] [--no-warnings] [--schema-version] [-s|--sequential] [-p|--parallel] [-k|--keep-going] [--kill-on-fail] [-h|--help] [-V|--version] [TASK] [ARGS]

DESCRIPTION
Run a project task or exec a command through the detected package manager

OPTIONS

--dir <PATH>
    Use this directory instead of the current one

--pm <NAME>
    Override the detected package manager (also reads RUNNER_PM when omitted). Valid: npm, yarn, pnpm, bun, cargo, deno, uv, poetry, pipenv, go, bundler (alias: bundle), composer

--runner <NAME>
    Override the detected task runner (also reads RUNNER_RUNNER when omitted). Valid: turbo, nx, make, just, task (alias: go-task), mise, bacon

--fallback <POLICY>
    What to do when no detection signal matches: probe (default, PATH probe), npm (legacy silent fallback), error (refuse). Also reads RUNNER_FALLBACK when omitted.

--on-mismatch <POLICY>
    What to do when the manifest declaration disagrees with the lockfile: warn (default), error (exit 2), ignore (silent). Also reads RUNNER_ON_MISMATCH when omitted.

--explain
    Print a one-line trace describing how the package manager was resolved. Also enabled when RUNNER_EXPLAIN is set to a truthy value.

--no-warnings
    Suppress all non-fatal warnings on stderr. Also enabled when RUNNER_NO_WARNINGS is set to a truthy value.

--schema-version <N>
    Pin JSON output schema version (1 or 2). Defaults to latest. Affects --json output of doctor/list/why only.

-s, --sequential
    Run the given tasks sequentially. Conflicts with `--parallel`

-p, --parallel
    Run the given tasks in parallel. Conflicts with `--sequential`

-k, --keep-going
    Run every task in the chain regardless of failures. Conflicts with `--kill-on-fail`

--kill-on-fail
    Parallel only: SIGKILL siblings on first failure. Accepted but unused in sequential mode

-h, --help
    Print help

-V, --version
    Print version

[TASK]
    Task name or command. When omitted, prints project info

[ARGS]
    Arguments forwarded to the task, or extra task names in chain mode

VERSION
v0.12.1

AUTHORS
Kaj Kowalski