asymptote-labs/Agent Beacon CI Telemetry
Capture agent CI telemetry to Agent Beacon JSONL, artifacts, or customer-managed destinations.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jul 10, 2026
- License
- MIT
Pinned Snippet
uses: asymptote-labs/agent-beacon@fecc061ef306cdd5eaf21ae08515249f81171f99 # v0.0.96tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| mode | How to run Beacon CI telemetry: 'exec' (default), 'start', or 'finish'. | no | exec |
| command | The Claude Code command to run, e.g. claude --print "Summarize this repo". Executed via bash -c so the configured telemetry environment reaches it. Required when mode is 'exec'. | no | "" |
| harnesses | Comma-separated agent harnesses to configure, e.g. claude,codex. | no | "" |
| version | Beacon CLI release tag to download (e.g. v0.0.39). Defaults to a version pinned by this action. SIEM forwarding requires a release that includes the ci exec --forward feature. | no | "" |
| binary-path | Path to an existing beacon binary. When set, the download and checksum verification are skipped. Use for air-gapped or self-hosted runners. The beacon-otelcol collector must sit beside it. | no | "" |
| min-events | Minimum Beacon events required for telemetry validation to pass. | no | 1 |
| require-telemetry | Fail the step when telemetry validation fails. Set to 'false' to downgrade a telemetry-pipeline failure to a warning so it does not gate the build. | no | true |
| forward | Optional SIEM forwarder: 'splunk' or 'falcon'. Leave empty to disable. The token must be supplied via the BEACON_CI_SPLUNK_HEC_TOKEN or BEACON_CI_FALCON_HEC_TOKEN environment variable (set it at the job or workflow level from a secret), never as an input. | no | "" |
| forward-endpoint | SIEM HEC endpoint URL for the selected --forward provider. | no | "" |
| upload | Optional post-run artifact upload destinations: 's3', 'gcs', or a comma-separated list. Configure provider credentials at the job level using the normal AWS or Google Cloud CI mechanisms. | no | "" |
| upload-artifact | Upload the runtime JSONL log as the universal workflow artifact. | no | true |
| artifact-name | Name for the uploaded telemetry artifact. | no | beacon-runtime-log |
Outputs
| name | description |
|---|---|
| log-path | Path to the Beacon runtime JSONL log. |
| state-path | Path to the Beacon CI session state file. |
| codex-home | Path to Beacon's generated Codex home directory. |