# Available commands

This page provides a complete reference for all commands and options available in [**AI Code Reviews in CLI**](/ai-code-reviews-in-cli/overview.md). Use it to understand what each command does, when to use it, and how to combine options for common workflows.

### Command structure

```bash
bitoreview <command> [options]
```

For convenience, you can also use the short alias `br` instead of `bitoreview`:

```shellscript
br <command> [options]
```

### Commands overview

|   Command   |                      Description                      |
| :---------: | :---------------------------------------------------: |
|   `review`  | Analyze code changes and generate AI-powered feedback |
|   `config`  |       Manage configuration settings and API keys      |
|   `--help`  |                Display help information               |
| `--version` |           Display the installed CLI version           |

### `review` command

The `review` command is the core of the CLI. It analyzes your code changes and highlights issues related to bugs, security, performance, and overall code quality.

#### Basic syntax

```bash
bitoreview review [files...] [options]
```

#### Examples

```bash
# Review all changes
bitoreview review

# Review specific files
bitoreview review src/app.js src/utils/helper.js

# Review files using glob patterns
bitoreview review "src/**/*.js"

# Review only uncommitted changes
bitoreview review --type uncommitted

# Run a fast, security-focused review
bitoreview review --focus security --mode essential
```

#### Review scope options

**`--type, -t <type>`**

Specify which changes to review.

**Supported values:**

* `all` (default) - Review both committed and uncommitted changes
* `uncommitted` - Review only working directory changes
* `committed --base <branch-name>` - Review only committed changes against the specified base branch.
  * `--base` option is mandatory with this type.

**Examples:**

```bash
bitoreview review --type uncommitted
bitoreview review --type committed --base main
```

**`--base <branch>`**

Compare changes against a specific branch.

**Example:**

```bash
bitoreview review --base main
bitoreview review --base develop
```

**`--base-commit <commit>`**

Compare changes against a specific commit hash.

**Example:**

```bash
bitoreview review --base-commit abc123
```

#### Review quality options

**`--mode <mode>`**

Control the depth and breadth of the review.

**Supported values:**

* `essential` - Shows only HIGH severity issues for rapid feedback
* `comprehensive` (default) - Shows all severity levels for thorough analysis

**Examples:**

```bash
# Quick review
bitoreview review --mode essential

# Thorough review
bitoreview review --mode comprehensive
```

**`--focus <area>`**

Concentrate the review on specific code quality aspects.

**Supported values:**

* `security` - SQL injection, XSS, authentication, data validation
* `performance` - Memory leaks, inefficient algorithms, bottlenecks
* `bugs` - Logic errors, edge cases, runtime issues
* `best-practices` - Code style, design patterns, maintainability
* `tests` - Test coverage, test quality, testability
* `documentation` - Comments, documentation quality, code clarity

**Examples:**

```bash
bitoreview review --focus security
bitoreview review --focus performance --mode essential
```

**`--severity <level>`**

Filter issues by minimum severity level.

**Supported values:**

* `high` - Critical issues that must be fixed
* `medium` - Important issues that should be addressed
* `low` - Minor suggestions and style improvements

**Examples:**

```bash
# Show only high severity issues
bitoreview review --severity high

# Show medium and high severity
bitoreview review --severity medium
```

#### Output options

**`--interactive, -i`**

Enable interactive mode to review and apply fixes one by one.

**Example:**

```bash
bitoreview review --interactive
# or
bitoreview review -i
```

**`--plain`**

Output plain text without colors or formatting, suitable for logs and CI/CD.

**Example:**

```bash
bitoreview review --plain
bitoreview review --plain > review-report.txt
```

**`--prompt-only`**

Minimal output optimized for AI agent integration.

**Example:**

```bash
bitoreview review --prompt-only
```

**`--no-color`**

Disable colored output (similar to `--plain` but retains structure).

**Example:**

```bash
bitoreview review --no-color
```

#### SCM options

**`--scm <type>`**

Override automatic SCM detection.

**Supported values:**

* `git` - Git repository
* `svn` - Subversion repository
* `hg` - Mercurial repository
* `p4` - Perforce repository
* `plain` - No version control (analyze files directly)

**Example:**

```bash
bitoreview review --scm git
bitoreview review --scm plain
```

#### Configuration options

**`--config, -c <path>`**

Use a custom configuration file path instead of `.bitoreview.yaml` in the project root.

**Example:**

```bash
bitoreview review --config .bitoreview-custom.yaml
bitoreview review -c config/bitoreview.yaml
```

**`--api-key <key>`**

Provide API key directly via command line (overrides environment and config file).

**Example:**

```bash
bitoreview review --api-key YOUR_API_KEY_HERE
```

**`--cwd <path>`**

Set the working directory for the review.

**Example:**

```bash
bitoreview review --cwd /path/to/project
```

#### Debugging options

**`--debug, -d`**

Enable debug output for troubleshooting.

**Example:**

```bash
bitoreview review --debug
bitoreview review -d
```

**`--verbose, -v`**

Enable verbose logging for detailed information.

**Example:**

```bash
bitoreview review --verbose
bitoreview review -v
```

**`--max-retries <number>`**

Set the number of retry attempts for API calls (default: 2).

**Example:**

```bash
bitoreview review --max-retries 5
```

### `config` command

Manage configuration and API keys.

#### Set API key

```bash
bitoreview config set-api-key [key]
```

**Interactive mode** (prompts for key):

```bash
bitoreview config set-api-key
```

**Direct mode** (provide key in command):

```bash
bitoreview config set-api-key YOUR_API_KEY_HERE
```

#### Show API key

Display your configured API key (masked for security).

```bash
bitoreview config show-api-key
```

### Global options

#### `--help, -h`

Display help for any command.

**Examples:**

```bash
bitoreview --help
bitoreview review --help
bitoreview config --help
```

#### `--version`

Show the installed CLI version.

**Example:**

```bash
bitoreview --version
```

### Option combinations

AI Code Reviews in CLI allows you to combine multiple options for precise control:

```bash
# Fast pre-commit security check
bitoreview review --type uncommitted --focus security --mode essential

# Comprehensive performance review against main
bitoreview review --base main --focus performance

# High-severity bugs only in specific files
bitoreview review src/critical/*.js --focus bugs --severity high

# Plain text output for CI/CD with retries
bitoreview review --plain --max-retries 3
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.bito.ai/ai-code-reviews-in-cli/available-commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.