CLI Reference

Quick reference

rebaze analyze [PATH]              # Detect build system
rebaze migrate [PATH] [OPTIONS]    # Generate Bazel files
rebaze validate [PATH]             # Verify migration

Global options

Option	Description
`-v, --verbose`	Enable verbose output
`--version`	Print version
`-h, --help`	Print help

`rebaze analyze`

Detect the build system of a project.

rebaze analyze /path/to/project

Output:

Detected build systems: cmake, gradle

Argument	Default	Description
`PATH`	`.`	Project root

Detectable systems: cmake, gradle, maven, make, cargo

`rebaze migrate`

Generate Bazel build files from your existing build system.

rebaze migrate /path/to/project

Basic options

Option	Description
`--dry-run`	Preview without writing files
`-f, --from <SYSTEM>`	Force build system (auto-detected)
`-c, --config <FILE>`	Path to rebaze.toml
`--unsafe-mode`	Skip validation checks

CMake options

Option	Description
`--cmake-build-dir <DIR>`	CMake build directory with file-api data
`--cmake-config <NAME>`	Configuration (Debug/Release)
`--cmake-file-api-only`	Require file-api (fail if unavailable)

Generator options

Option	Description
`--build-generator <TYPE>`	Generator: `auto`, `native`, or `bazelle`
`--bazelle-root <DIR>`	Path to bazelle workspace
`--bazelle-bin <PATH>`	Path to bazelle binary

Examples

Basic migration:

rebaze migrate .

Preview changes:

rebaze migrate . --dry-run

With custom config:

rebaze migrate . --config custom.toml

CMake with File API (most accurate):

cmake -S . -B build
rebaze migrate . --cmake-build-dir build

Specific CMake configuration:

rebaze migrate . --cmake-build-dir build --cmake-config Release

Force native generator:

rebaze migrate . --build-generator native

`rebaze validate`

Verify generated Bazel files build successfully.

rebaze validate /path/to/project

Option	Description
`--unsafe-mode`	Skip bazel build validation

Runs bazel build //... and verifies Bazel 9.x is being used.

Exit codes

Code	Meaning
`0`	Success
`1`	Error

Environment variables

Variable	Description
`RUST_LOG`	Log level: `debug`, `info`, `warn`, `error`

Debug logging:

RUST_LOG=debug rebaze migrate .