runner(1)

NAME
runner - Universal project task runner

SYNOPSIS
runner [--dir] [--pm] [--runner] [--fallback] [--on-mismatch] [--explain] [--no-warnings] [--schema-version] [-h|--help] [-V|--version] [subcommands]

DESCRIPTION
Universal project task runner

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.

-h, --help
    Print help

-V, --version
    Print version

SUBCOMMANDS

runner-run(1)
    Run a task, or exec a command through the detected package manager. With `-s` or `-p`, runs multiple tasks as a chain

runner-install(1)
    Install project dependencies, then optionally chain tasks (`runner install build test` → install → build → test, sequential)

runner-clean(1)
    Remove caches and build artifacts

runner-list(1)
    List available tasks across all detected sources

runner-doctor(1)
    Diagnostic dump: every signal the resolver considers in this dir

runner-why(1)
    Explain how a specific task would dispatch (sources + PM trace)

runner-completions(1)
    Generate shell completions

runner-help(1)
    Print this message or the help of the given subcommand(s)

VERSION
v0.12.1

AUTHORS
Kaj Kowalski