runner(1)

NAME
runner - Universal project task runner

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

DESCRIPTION
Universal project task runner

OPTIONS

--dir <PATH>
    Project directory (default: cwd)

--pm <NAME>
    Force PM (npm, yarn, pnpm, bun, cargo, deno, uv, poetry, pipenv, go, bundler, composer) [env: RUNNER_PM]

--runner <NAME>
    Force task runner (turbo, nx, make, just, task, mise, bacon) [env: RUNNER_RUNNER]

--fallback <POLICY>
    No detection match: probe (default), npm, error [env: RUNNER_FALLBACK]

--on-mismatch <POLICY>
    Manifest vs lockfile: warn (default), error (exit 2), ignore [env: RUNNER_ON_MISMATCH]

--explain
    PM resolution trace [env: RUNNER_EXPLAIN]

--no-warnings
    Hide non-fatal warnings [env: RUNNER_NO_WARNINGS]

-q, --quiet
    Hide dispatch line + --explain trace [env: RUNNER_QUIET]

--schema-version <N>
    Pin --json schema (doctor/why 1-3, list 1-2; default latest)

-h, --help
    Print help

-V, --version
    Print version

SUBCOMMANDS

runner-run(1)
    Run or exec a task; -s/-p chain multiple

runner-list(1)
    List tasks from detected sources

runner-install(1)
    Install deps; may chain tasks after (always sequential)

runner-clean(1)
    Remove caches and build artifacts

runner-why(1)
    How a task would dispatch

runner-doctor(1)
    Resolver signals for this directory

runner-config(1)
    Manage the project `runner.toml`

runner-completions(1)
    Generate shell completions

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

VERSION
v0.14.2

AUTHORS
Kaj Kowalski