Skip to main content

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.

​
OpenCode

Beacon supports OpenCode through a managed local plugin that invokes beacon-hooks.

​
Prerequisites

Before enabling OpenCode telemetry, make sure:
  • OpenCode is installed and available as the opencode executable or has a local config directory.
  • beacon endpoint install has run so shared endpoint config and runtime log paths exist.
  • Beacon’s OpenCode plugin is installed with beacon endpoint hooks install --harness opencode.
  • OpenCode is restarted after plugin install or removal so new sessions load the updated plugin.

​
Collection path

Beacon installs an owned OpenCode plugin at ~/.config/opencode/plugins/beacon.ts for user-level hooks or ./.opencode/plugins/beacon.ts for project-level hooks. The plugin forwards supported OpenCode hook payloads to Beacon’s hook adapter.

​
Discovery and status

Beacon detects OpenCode through the opencode executable or ~/.config/opencode, then checks for Beacon plugin configuration. Use beacon endpoint hooks status --harness opencode to inspect OpenCode plugin status.

​
Install or configuration support

beacon endpoint install prepares shared endpoint config and runtime log paths. Install OpenCode hooks separately: 
beacon endpoint hooks install --harness opencode

​
Telemetry coverage

AreaSupport
Prompt telemetrySupported through chat.message hooks
Command, tool, and file telemetrySupported for chat messages, session events, command execution, permission activity, diffs, and errors where OpenCode exposes payloads
Local JSONL and dashboardSupported
MDM deploymentSupported for the endpoint agent; OpenCode plugins are installed separately in the logged-in user’s context

​
Deployment notes

Restart OpenCode after installing or removing hooks so new sessions pick up the updated plugin configuration. For local troubleshooting, set BEACON_OPENCODE_DEBUG=1 in the environment that launches OpenCode to emit best-effort plugin debug logs. Beacon telemetry should not interrupt OpenCode execution if the hook command fails.

Supported agent harnesses

Return to the runtime support overview.

Hooks

Install, inspect, and uninstall runtime hook integrations.