Skip to content

README-opencode.md

Latest commit

 

History

History
97 lines (72 loc) · 2.83 KB

README-opencode.md

File metadata and controls

97 lines (72 loc) · 2.83 KB

opencode Patch Setup

This directory contains the NeMo Relay integration patch for third_party/opencode.

The patch adds optional NeMo Relay tracing, LLM stream wrapping, tool execution wrapping, raw ATOF JSONL export, and optional direct ATIF export support to the opencode package. The patch also wires opencode to the local NeMo Relay Node package with an optional file: dependency so the patched workspace can load nemo-relay-node when NeMo Relay tracing is enabled.

Setup

From the NeMo Relay repository root:

./scripts/bootstrap-third-party.sh
./scripts/apply-patches.sh --check
git -C third_party/opencode apply ../../patches/opencode/0001-add-nemo-relay-integration.patch

Install opencode dependencies with Bun:

cd third_party/opencode
bun install --frozen-lockfile

For runtime smoke tests that load nemo-relay-node, build the Node binding from the NeMo Relay repository root first:

cd ../../crates/node
npm install
npm run build

Enable the integration at runtime with either NEMO_RELAY_ENABLED=1 or the opencode experimental nemo_relay config flag. If the native addon is missing, the integration logs a warning and disables itself.

Usage Example

Run opencode with the NeMo Relay integration enabled by environment variable:

cd third_party/opencode
NEMO_RELAY_ENABLED=1 bun --cwd packages/opencode run dev

Alternatively, enable the patched experimental config flag:

{
  "experimental": {
    "nemo_relay": true
  }
}

When enabled, opencode creates NeMo Relay scopes for agents and batched tool execution, wraps LLM streams and tool calls, and registers a raw ATOF JSONL subscriber. Set NEMO_RELAY_ATOF_DIR to control where events.jsonl is written; otherwise it defaults to the opencode data directory's atof subdirectory.

Direct ATIF export is optional comparison output. Set NEMO_RELAY_ATIF_DIR to control where exported ATIF JSON files are written when a session becomes idle; otherwise it defaults to the opencode data directory's atif subdirectory.

The tool wrapper keeps opencode's execution on original JavaScript values while passing JSON-safe snapshots to the NeMo Relay native observer. This avoids structuredClone() failures in opencode while still preserving NeMo Relay tool events.

Validation

Run the opencode package typecheck:

cd third_party/opencode/packages/opencode
bun run typecheck

Also rerun the patch applicability check from the NeMo Relay repository root:

./scripts/apply-patches.sh --check

For an end-to-end smoke, run an opencode task with NEMO_RELAY_ENABLED=1 and verify that the configured NEMO_RELAY_ATOF_DIR contains an events.jsonl file with scope and tool/LLM events.