Expand description
§Runner (runner-run crate)
§Overview
Universal project task runner.
runner auto-detects your project’s toolchain (package managers, task
runners, version constraints) and provides a unified interface to run
tasks, install dependencies, clean artifacts, and execute ad-hoc commands.
§Supported Ecosystems
Package managers/ecosystems: npm, yarn, pnpm, bun, cargo, deno, uv, poetry, pipenv, go, bundler, composer
Task runners: turbo, nx, make, just, go-task, mise, bacon
§Library API
run_from_envparses process args and dispatches in current dir.run_from_argsparses explicit args and dispatches in current dir.run_in_dirparses explicit args and dispatches against a given dir.
§CLI Usage
runner # show detected project info
runner <task> # run a task (falls back to package-manager exec)
run <task> # alias binary: always task/exec, never a built-in
runner run <target> # explicit unified run: task → PM exec fallback
runner install # install dependencies via detected PM
runner clean # remove caches and build artifacts
runner list # list available tasks from all sourcesFunctions§
- bin_
name_ from_ arg0 - Extracts the filename portion from an argv[0]-style
OsString, returning it when non-empty. - configure_
cli_ command - Attaches the generated help byline to a clap command.
- exit_
code_ for_ error - Exit code semantics:
- help_
byline - Render the CLI help byline using the build-time author metadata.
- requests_
version - Detects whether the provided argv-style slice specifically requests the program version.
- run_
alias_ from_ args - Parse explicit args as the
runalias binary, detect current dir, dispatch, and return the exit code. Seerun_alias_from_env. - run_
alias_ from_ env - Parse process args as the
runalias binary, detect the current dir, dispatch, and return the exit code. - run_
alias_ in_ dir - Parse explicit args as the
runalias binary againstdir.
Seerun_alias_from_env. - run_
from_ args - Parse explicit args, detect current dir, dispatch, return exit code.
- run_
from_ env - Parse process args, detect current dir, dispatch, return exit code.
- run_
in_ dir - Parse explicit args and run against
dir.