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

# Analysis commands

> Manage analyses.

<Note>The Bevor CLI is coming soon. This page previews its planned command interface.</Note>

Manage analyses.

## `bevor analysis create`

Create a root analysis for the configured code version.

```bash theme={null}
bevor analysis create [OPTIONS]
```

| Parameter     | Type    | Required | Default | Description                                 |
| ------------- | ------- | -------- | ------- | ------------------------------------------- |
| `--name`      | string  | No       | None    | Optional analysis name.                     |
| `--yes, -y`   | boolean | No       | false   | Skip confirmations.                         |
| `--json, -j`  | boolean | No       | false   | Print API response as JSON.                 |
| `--force, -f` | boolean | No       | false   | Skip the local sync check. Not recommended. |

## `bevor analysis use`

Point `.bevor` at an analysis container (and optional env).

```bash theme={null}
bevor analysis use [OPTIONS] ANALYSIS_ID
```

| Parameter     | Type   | Required | Default | Description                                     |
| ------------- | ------ | -------- | ------- | ----------------------------------------------- |
| `ANALYSIS_ID` | string | Yes      | —       | Analysis container id.                          |
| `--env`       | string | No       | None    | Environment / branch name (default: main head). |

## `bevor analysis set`

Move the analysis HEAD to `version_id`. Config keeps the same analysis container id.

```bash theme={null}
bevor analysis set VERSION_ID
```

| Parameter    | Type   | Required | Default | Description                         |
| ------------ | ------ | -------- | ------- | ----------------------------------- |
| `VERSION_ID` | string | Yes      | —       | Analysis version id to set as HEAD. |

## `bevor analysis get`

Print details for the configured analysis head (or `--version`).

```bash theme={null}
bevor analysis get [OPTIONS]
```

| Parameter    | Type    | Required | Default | Description                                                              |
| ------------ | ------- | -------- | ------- | ------------------------------------------------------------------------ |
| `--version`  | string  | No       | None    | Act on this analysis version id instead of the configured analysis head. |
| `--json, -j` | boolean | No       | false   | Print as JSON.                                                           |

## `bevor analysis run`

Start a run for the configured analysis head (or `--version`).

```bash theme={null}
bevor analysis run [OPTIONS]
```

| Parameter   | Type    | Required | Default | Description                                                                          |
| ----------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------ |
| `--version` | string  | No       | None    | Version id to run (default: configured analysis head).                               |
| `--no-wait` | boolean | No       | false   | Return immediately after starting the run instead of streaming SSE until completion. |
| `--silent`  | boolean | No       | false   | No per-scope or status lines; if the event stream ends early, only one status fetch. |

## `bevor analysis retry`

Retry failed entrypoints for the configured analysis head (or `--version`).

```bash theme={null}
bevor analysis retry [OPTIONS]
```

| Parameter   | Type    | Required | Default | Description                                                                          |
| ----------- | ------- | -------- | ------- | ------------------------------------------------------------------------------------ |
| `--version` | string  | No       | None    | Version id to retry (default: configured analysis head).                             |
| `--silent`  | boolean | No       | false   | No per-scope or status lines; if the event stream ends early, only one status fetch. |
| `--no-wait` | boolean | No       | false   | Return immediately after retrying instead of streaming SSE until completion.         |

## `bevor analysis diff`

Show finding diffs for the configured analysis head (or `--version`).

```bash theme={null}
bevor analysis diff [OPTIONS]
```

| Parameter    | Type    | Required | Default | Description                                             |
| ------------ | ------- | -------- | ------- | ------------------------------------------------------- |
| `--version`  | string  | No       | None    | Version id to diff (default: configured analysis head). |
| `--staged`   | boolean | No       | false   | Show staged drafts instead of version-vs-parent diffs.  |
| `--json, -j` | boolean | No       | false   | Output raw JSON.                                        |

## `bevor analysis commit`

Commit staged findings for the configured analysis head (or `--version`).

```bash theme={null}
bevor analysis commit [OPTIONS]
```

| Parameter   | Type   | Required | Default | Description                                               |
| ----------- | ------ | -------- | ------- | --------------------------------------------------------- |
| `--version` | string | No       | None    | Version id to commit (default: configured analysis head). |

## `bevor analysis child`

Create a child analysis version using the configured code as the new code mapping.

```bash theme={null}
bevor analysis child [OPTIONS]
```

| Parameter   | Type   | Required | Default | Description                                            |
| ----------- | ------ | -------- | ------- | ------------------------------------------------------ |
| `--version` | string | No       | None    | Parent version id (default: configured analysis head). |

## `bevor analysis fork`

Fork an analysis version and set the new analysis as configured.

```bash theme={null}
bevor analysis fork [OPTIONS]
```

| Parameter   | Type   | Required | Default | Description                                             |
| ----------- | ------ | -------- | ------- | ------------------------------------------------------- |
| `--version` | string | No       | None    | Version id to fork (default: configured analysis head). |
| `--project` | string | No       | None    | Unused reserved flag (fork stays in the same project).  |

## `bevor analysis merge`

Merge one analysis into another (uses each analysis's current head).

```bash theme={null}
bevor analysis merge [OPTIONS]
```

| Parameter | Type   | Required | Default | Description                        |
| --------- | ------ | -------- | ------- | ---------------------------------- |
| `--from`  | string | Yes      | —       | Source analysis container id.      |
| `--to`    | string | Yes      | —       | Destination analysis container id. |

## `bevor analysis entrypoints`

List entrypoints for the configured analysis head (or `--version`).

```bash theme={null}
bevor analysis entrypoints [OPTIONS]
```

| Parameter    | Type    | Required | Default | Description                                     |
| ------------ | ------- | -------- | ------- | ----------------------------------------------- |
| `--version`  | string  | No       | None    | Version id (default: configured analysis head). |
| `--json, -j` | boolean | No       | false   | Output raw JSON.                                |

## `bevor analysis remediations`

List remediated findings for the configured analysis head (or `--version`).

```bash theme={null}
bevor analysis remediations [OPTIONS]
```

| Parameter    | Type    | Required | Default | Description                                     |
| ------------ | ------- | -------- | ------- | ----------------------------------------------- |
| `--version`  | string  | No       | None    | Version id (default: configured analysis head). |
| `--json, -j` | boolean | No       | false   | Output raw JSON.                                |

## `bevor analysis delete full`

Delete the entire analysis container configured in `.bevor`.

```bash theme={null}
bevor analysis delete full
```

## `bevor analysis delete branch`

Delete an analysis ref / environment.

```bash theme={null}
bevor analysis delete branch [ENV]
```

| Parameter | Type   | Required | Default | Description                                                         |
| --------- | ------ | -------- | ------- | ------------------------------------------------------------------- |
| `ENV`     | string | No       | None    | Environment / branch to delete (default: configured analysis\_env). |

## `bevor analysis delete version`

Delete a single analysis version (leaf).

```bash theme={null}
bevor analysis delete version [VERSION]
```

| Parameter | Type   | Required | Default | Description                                               |
| --------- | ------ | -------- | ------- | --------------------------------------------------------- |
| `VERSION` | string | No       | None    | Version id to delete (default: configured analysis head). |

## `bevor analysis branch list`

List environments / branches for the configured analysis.

```bash theme={null}
bevor analysis branch list [OPTIONS]
```

| Parameter    | Type    | Required | Default | Description      |
| ------------ | ------- | -------- | ------- | ---------------- |
| `--json, -j` | boolean | No       | false   | Output raw JSON. |
