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

# beacon ci validate

> Validate Beacon CI runtime telemetry artifacts

## Command overview

`beacon ci validate` checks that the runtime log exists, parses as Beacon JSONL, and contains at least the required number of matching harness events.

```bash title="Command syntax" theme={null}
beacon ci validate
```

Use validation after a job step when telemetry collection and agent execution are managed separately.

## Flags

| Flag | Description |
| - | - |
| `--harness <harness>` | Required harness to validate. Defaults to `claude` |
| `--log-path <path>` | CI runtime JSONL log path. Defaults to `$RUNNER_TEMP/beacon/runtime.jsonl` or the system temp path |
| `--json` | Print validation results as JSON |
| `--min-events <count>` | Minimum matching events required. Defaults to `1` |

## Examples

Validate the default CI artifact path:

```bash title="Validate the default CI artifact path" theme={null}
beacon ci validate
```

Validate a custom runtime log:

```bash title="Validate a custom runtime log" theme={null}
beacon ci validate --log-path "$RUNNER_TEMP/beacon/runtime.jsonl"
```

Require at least three Claude events:

```bash title="Require at least three Claude events" theme={null}
beacon ci validate --min-events 3
```

Print machine-readable validation results:

```bash title="Print machine-readable validation results" theme={null}
beacon ci validate --json
```

## Related

<Columns cols={2}>
  <Card title="beacon ci" icon="terminal" href="/cli/ci">
    Review CI artifact paths and command group behavior.
  </Card>

  <Card title="beacon ci exec" icon="terminal" href="/cli/ci-exec">
    Run a single command with ephemeral CI telemetry.
  </Card>

  <Card title="beacon ci finish" icon="stop" href="/cli/ci-finish">
    Stop and validate a detached telemetry session.
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.