CLI

Baz CLI lets you review pull requests from the terminal with AI guidance. It helps you focus on meaningful changes and move through reviews faster.

Install Baz

Native install

Connect with Baz to get the full experience: AI assistant, spec review, better context, and comprehensive code review.

npm install -g @baz-scm/cli

💡 New to Baz? Sign up for a free 14-day trial - no credit card required!

Bring your own keys (BYOK)

Use your own GitHub Personal Access Token (PAT) and Anthropic token to review any pull request directly.

npm install -g @baz-scm/cli
GH_TOKEN=your_github_pat ANTHROPIC_TOKEN=your_anthropic_api_key baz

Setup and Running Baz

Baz CLI can be run in one of two modes. The mode is determined at runtime based on how you start the CLI.

Baz Mode

Baz mode connects the CLI to your Baz account and repository context. This mode enables walkthroughs that are aware of linked tickets and specifications.

Run the CLI without tokens.

baz

If you are not authenticated, you will be prompted to sign in to Baz and grant repository access.

Token Mode

Token mode runs the CLI using your own credentials without connecting to Baz services.

Both tokens must be provided.

GH_TOKEN=your_github_pat ANTHROPIC_TOKEN=your_anthropic_key baz

This mode supports walkthrough reviews and commenting, but does not include requirement verification from Baz.

Walkthrough Review

Baz can guide you through a pull request step by step. The walkthrough presents a structured view of the change, highlights what matters, and lets you skip low-impact parts. You can move forward and backward through the review at any time.

You can pause the walkthrough and ask questions about the intent of the change or specific code paths.

Commenting and Review Actions

During the review, you can read existing comments and add new ones directly from the CLI. Comments are posted back to GitHub immediately.

If you have sufficient permissions, you can approve the pull request or merge it from the CLI.

Verifying Requirements

In Baz mode, the CLI verifies the pull request against linked requirements. These typically come from tickets or specifications connected in Baz.

The review highlights where the implementation matches the requirements and where it does not, so gaps can be addressed during review.