> ## Documentation Index
> Fetch the complete documentation index at: https://docs.breezeblue.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Breeze CLI troubleshooting

> Fix common Breeze CLI install, login, update, and Video Lab issues.

## Command not found

Add the install directory to your current shell path.

```bash theme={null}
export PATH="$HOME/.local/bin:$PATH"
```

```powershell theme={null}
$env:Path = "$env:LOCALAPPDATA\Programs\Breeze\bin;$env:Path"
```

## Login does not open a browser

Print the authorization URL and open it manually.

```bash theme={null}
breeze login --no-browser
```

## Saved key is missing

Check the active profile and log in again if the profile has no key.

```bash theme={null}
breeze config show
breeze login
```

## Authentication failed

An `auth` error, exit code `3`, means the active profile has no key, or its key is missing, expired, or does not match the profile's API environment. Confirm the resolved base URL and key source, then log in again or set a key for the right environment.

```bash theme={null}
breeze diagnostics --agent
breeze login
```

## Not enough credits

A `quota` error, exit code `4`, means the account balance is too low for the request. Check the balance and top up before retrying.

```bash theme={null}
breeze balance
```

## Request timed out

A `timeout` error, exit code `5`, means the request did not finish within the timeout window. Raise `--timeout` for slow networks or large generations, then retry.

```bash theme={null}
breeze tts "Hello from Breeze" -o hello.wav --timeout 3m
```

## Network or upstream failure

A `network` error, exit code `6`, covers connection failures and temporary upstream errors, including upstream `5xx` responses. These are usually transient. Confirm connectivity and retry after a short wait. The same code is returned when `breeze update` cannot reach the release manifest.

```bash theme={null}
breeze diagnostics --agent
```

## Update fails

`breeze update --check` returns a `network` error, exit code `6`, when the release manifest is unreachable. Confirm network access and retry. The manifest URL can be overridden with `--manifest-url` for internal or pinned channels.

```bash theme={null}
breeze update --check
```

## Video Lab dependencies

Doctor reports missing local tools before rendering. It runs these local checks without a Breeze login or credits. Install the missing dependency, then rerun doctor.

```bash theme={null}
breeze video doctor --agent
```

See [Scripting and agents](/cli/reference/scripting) for the full exit code table and machine-readable error envelopes.