.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH runner 1 "runner 0.16.1" "Runner Manual"
.SH NAME
runner \- Universal project task runner
.SH SYNOPSIS
\fBrunner\fR [\fB\-\-dir\fR] [\fB\-\-pm\fR] [\fB\-\-runner\fR] [\fB\-\-fallback\fR] [\fB\-\-on\-mismatch\fR] [\fB\-\-explain\fR] [\fB\-\-no\-warnings\fR] [\fB\-q\fR|\fB\-\-quiet\fR] [\fB\-\-schema\-version\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fIsubcommands\fR]
.SH DESCRIPTION
Universal project task runner
.SH OPTIONS
.TP
\fB\-\-dir\fR \fI<PATH>\fR
Project directory (default: cwd) [env: RUNNER_DIR]
.TP
\fB\-\-pm\fR \fI<NAME>\fR
Force PM (npm, yarn, pnpm, bun, cargo, deno, uv, poetry, pipenv, go, bundler, composer) [env: RUNNER_PM]
.TP
\fB\-\-runner\fR \fI<NAME>\fR
Force task runner (turbo, nx, make, just, task, mise, bacon) [env: RUNNER_RUNNER]
.TP
\fB\-\-fallback\fR \fI<POLICY>\fR
No detection match: probe (default), npm, error [env: RUNNER_FALLBACK]
.TP
\fB\-\-on\-mismatch\fR \fI<POLICY>\fR
Manifest vs lockfile: warn (default), error (exit 2), ignore [env: RUNNER_ON_MISMATCH]
.TP
\fB\-\-explain\fR
PM resolution trace [env: RUNNER_EXPLAIN]
.TP
\fB\-\-no\-warnings\fR
Hide non\-fatal warnings [env: RUNNER_NO_WARNINGS]
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Hide dispatch line + \-\-explain trace [env: RUNNER_QUIET]
.TP
\fB\-\-schema\-version\fR \fI<N>\fR
Pin \-\-json schema (doctor/why 1\-3, list 1\-2; default latest)
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version
.SH SUBCOMMANDS
.TP
runner\-run(1)
Run or exec a task; \-s/\-p chain multiple
.TP
runner\-list(1)
List tasks from detected sources
.TP
runner\-install(1)
Install deps; may chain tasks after; \-s/\-p pick the post\-install mode
.TP
runner\-clean(1)
Remove caches and build artifacts
.TP
runner\-why(1)
How a task would dispatch
.TP
runner\-doctor(1)
Resolver signals for this directory
.TP
runner\-config(1)
Manage the project `runner.toml`
.TP
runner\-completions(1)
Generate shell completions
.TP
runner\-schema(1)
Emit JSON Schemas
.TP
runner\-lsp(1)
Run the runner.toml language server (LSP) over stdio
.TP
runner\-help(1)
Print this message or the help of the given subcommand(s)
.SH VERSION
v0.16.1
.SH AUTHORS
Kaj Kowalski