Commands

Running Tasks

Execute any task defined in rnr.yaml:

./rnr <task-name>

Examples

./rnr build      # Run the 'build' task
./rnr test       # Run the 'test' task
./rnr ci         # Run the 'ci' task (which may run multiple sub-tasks)

Listing Tasks

View all available tasks and their descriptions:

./rnr --list
# or simply
./rnr

Output example:

Available tasks:
  build       Build for production
  test        Run test suite
  lint        Run linter
  ci          Run full CI pipeline
  deploy      Deploy to production

init

Initialize rnr in the current repository.

./rnr init [OPTIONS]

Interactive Mode (Default)

Running rnr init without options launches an interactive platform selector.

Non-Interactive Options

Option	Description
`--platforms <list>`	Comma-separated platform list
`--all-platforms`	Include all 5 platforms
`--current-platform-only`	Only current platform
`--force`	Skip git repository root check

Platform Management

Option	Description
`--add-platform <name>`	Add a platform to existing setup
`--remove-platform <name>`	Remove a platform from setup
`--show-platforms`	Display currently configured platforms

Examples

# Interactive setup (recommended)
./rnr init

# Non-interactive: specific platforms
./rnr init --platforms linux-amd64,macos-arm64,windows-amd64

# Non-interactive: all platforms
./rnr init --all-platforms

# Add Windows ARM support later
./rnr init --add-platform windows-arm64

# Check current configuration
./rnr init --show-platforms

upgrade

Update rnr binaries to the latest version from GitHub releases.

./rnr upgrade

This command:

Checks for the latest release on GitHub
Compares with current version
Downloads updated binaries for all configured platforms
Updates binaries in parallel for speed

help

Display help information:

./rnr --help
./rnr -h

version

Display the current version:

./rnr --version
./rnr -V

Supported Platforms

Platform	Binary Name	Size
Linux x86_64	`rnr-linux-amd64`	~760 KB
macOS Intel	`rnr-macos-amd64`	~662 KB
macOS Apple Silicon	`rnr-macos-arm64`	~608 KB
Windows x86_64	`rnr-windows-amd64.exe`	~584 KB
Windows ARM64	`rnr-windows-arm64.exe`	~528 KB

Exit Codes

rnr propagates exit codes from executed commands:

Code	Meaning
0	Success
1+	Command failed (exit code from the failing command)

When running parallel tasks, if any task fails, rnr will:

Report all failures
Exit with a non-zero code