Skip to main content

​
Command Overview

beacon ci finish loads the state file from beacon ci start, stops the collector, validates the runtime log, and optionally uploads the completed JSONL artifact.
Command syntax
beacon ci finish
Run this command in an always() or equivalent cleanup step so Beacon can stop the detached collector even when earlier CI steps fail.

​
Flags

FlagDescription
--state-path <path>CI session state path
--min-events <count>Minimum matching events required during validation. Defaults to 1
--require-telemetry <bool>Fail when telemetry validation fails. Defaults to true; set false to warn
--upload <destination>Upload the completed CI runtime JSONL after validation. Supported values are s3 and gcs; repeat for multiple destinations

​
Examples

Stop and validate a detached session:
Stop and validate a detached session
beacon ci finish --min-events 1
Upload the completed CI runtime log to GCS:
Upload the completed CI runtime log to GCS
BEACON_CI_GCS_BUCKET="my-beacon-telemetry" \
BEACON_CI_GCS_PREFIX="github-actions" \
beacon ci finish --upload gcs

​
GitHub Actions Session

- name: Start Beacon telemetry
  id: beacon
  uses: asymptote-labs/agent-beacon@v0.0.50
  with:
    mode: start
    harnesses: codex

- uses: openai/codex-action@main
  with:
    openai-api-key: ${{ secrets.OPENAI_API_KEY }}
    codex-home: ${{ steps.beacon.outputs.codex-home }}
    prompt: "Review this pull request"

- name: Finish Beacon telemetry
  if: always()
  uses: asymptote-labs/agent-beacon@v0.0.50
  with:
    mode: finish
    min-events: "1"

beacon ci

Review CI artifact paths and command group behavior.

beacon ci start

Start detached telemetry across workflow steps.

beacon ci validate

Validate an existing CI runtime log.