OpenCode Conversation Recorder

Record OpenCode session bus events to append-only JSONL files per session, with an explicit split when compaction happens:

• events_0.jsonl: pre-compaction history
• events_1.jsonl: post-compaction history (starts after session.compacted)

Install (local file URL)

1. Build:

npm install
npm run build

2. Add to your OpenCode config (global ~/.config/opencode/opencode.json or project opencode.json):

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["file:///ABSOLUTE/PATH/TO/opencode-conversation-recorder/dist/index.js"]
}

3. Enable recording:

OPENCODE_CONVERSATION_RECORD=1 \
OPENCODE_CONVERSATION_RECORD_DIR=/tmp/opencode-recordings \
opencode run 'say hello world in python'

Output

• Base directory:
  • OPENCODE_CONVERSATION_RECORD_DIR if set
  • else ${worktree}/.opencode/conversations
• Per session:
  • ${baseDir}/${sessionId}/events_0.jsonl
  • ${baseDir}/${sessionId}/events_1.jsonl (after compaction)

System prompt snapshots

This plugin also records system prompt snapshots emitted during LLM calls via the experimental.chat.system.transform hook. These are written as JSONL lines with type: "system.prompt" and payload:

{
  "system": ["...system prompt segment 1...", "...segment 2..."]
}