cli

run-run

One way to run the scripts in a repo.

rr gives a repo one set of commands, such as rr check, rr test and rr pack. Every tool behind them is a plugin you add, so the commands stay the same in every repo.

Install

pnpm add -D @rrlab/cli

It adds the rr command to your project. It needs Node 22.18 or later.

Usage

Print the commands and options:

pnpm rr --help

If you have node_modules/.bin on your PATH (e.g. via mise or direnv — see Shell completion), you can drop the pnpm prefix and invoke rr directly.

The CLI reference lists every command and flag. It is generated on each release.

Plugins

rr is a microkernel: every tool lives in its own @rrlab/<tool>-plugin package. The official plugins are:

Plugin	Wraps	Install
astro	astro check	rr plugins add astro
biome	Biome	rr plugins add biome
oxc	oxlint + oxfmt	rr plugins add oxc
ts	tsc	rr plugins add ts
tsdown	tsdown	rr plugins add tsdown
vitest	vitest	rr plugins add vitest

Install one with:

rr plugins add biome

This installs @rrlab/biome-plugin plus its peer tool and shared config, scaffolds biome.json if missing, and wires the plugin into run-run.config.{ts,mts}.

To install from a specific dist-tag (e.g. a PR preview release published as pr-<number>, or a custom tag), append @<spec>:

rr plugins add biome@pr-<number>   # preview tag
rr plugins add biome@<dist-tag>    # any dist-tag
rr plugins add biome@^1.0.0        # explicit version range (sibling configs still use latest)

When the spec is a dist-tag, rr resolves any @rrlab/*-config sibling at the same tag, falling back to latest if the registry doesn't have the sibling at that tag.

Shell completion

rr ships a completion subcommand that prints a shell-specific script. Pick the option that matches your setup.

Option A — with mise or direnv (recommended)

If your tooling puts node_modules/.bin on PATH per-project, rr resolves at shell startup and completion picks up new commands automatically on each new shell. Examples:

# mise.toml
[env]
_.path = ["{{config_root}}/node_modules/.bin"]

# .envrc (direnv)
PATH_add node_modules/.bin

Then add a guarded eval to your shell rc:

# zsh — ~/.zshrc
command -v rr >/dev/null 2>&1 && eval "$(rr completion zsh 2>/dev/null)"

# bash — ~/.bashrc
command -v rr >/dev/null 2>&1 && eval "$(rr completion bash 2>/dev/null)"

# fish — ~/.config/fish/config.fish
command -v rr >/dev/null 2>&1; and rr completion fish 2>/dev/null | source

The command -v guard skips the line when no rr is on PATH. A mise shim still passes it: recent versions of mise keep ~/.local/share/mise/shims on PATH after mise activate, even outside any project (the activate_shims setting, on by default). Once mise has installed a tool that provides rr, such as npm:@rrlab/cli in some project's mise.toml, an rr shim exists in every directory, and where no version is active it fails with mise ERROR No version is set for shim: rr on stderr. The 2>/dev/null discards that error, so the line stays silent outside a project.

The line hides every error, so if completion doesn't load, run rr completion zsh by hand to see why.

Option B — without a per-project PATH manager

Cache the completion script once, then source the cached file from your shell rc. Run the generation step from inside a project that has @rrlab/cli installed:

mkdir -p ~/.cache
pnpm exec rr completion zsh  > ~/.cache/rr-completion.zsh
pnpm exec rr completion bash > ~/.cache/rr-completion.bash
pnpm exec rr completion fish > ~/.cache/rr-completion.fish

# zsh — ~/.zshrc
[ -f ~/.cache/rr-completion.zsh ] && source ~/.cache/rr-completion.zsh

# bash — ~/.bashrc
[ -f ~/.cache/rr-completion.bash ] && source ~/.cache/rr-completion.bash

# fish — ~/.config/fish/config.fish
test -f ~/.cache/rr-completion.fish; and source ~/.cache/rr-completion.fish

Regenerate the cache after upgrading @rrlab/cli to pick up new commands.

The usage CLI

Completion runs on the usage CLI, so it has to be on your PATH. Install it with one of:

mise use -g usage
brew install usage

Troubleshooting

To enable debug mode, set the DEBUG environment variable to run-run:* before running any command.

DEBUG=run-run:* pnpm rr <command>

License

The code is MIT. The Sign in brand/ is not: its use is set by BRAND-USE.md.

 Variable Land