Files

noisedestroyers a29793032d Document current coding-workflow stack state

Snapshot of where opencode + Qwen3-Coder + MCPs + Kimi-Linear + voice
  + Phoenix tracing land today, plus in-flight (oc-tree, kimi-linear
  context ramp) and next (ComfyUI) items with pointers to per-project
  NEXT_STEPS.md guides.

2026-05-10 21:14:43 -04:00

2.4 KiB

Raw Permalink Blame History

oc-tree

Live tree-view sidecar for opencode. Subscribes to the opencode serve SSE event stream and renders a live hierarchy of sessions → messages → tool calls in a terminal pane next to the opencode TUI.

Phoenix (opencode/.opencode/plugin/phoenix-bridge.js) handles after-the-fact deep traces; oc-tree is the glanceable "what's it doing right now" pane.

Status

M0 — skeleton + schema probe (current).
M1 — flat session list (textual).
M2 — tree view with subagent nesting via parentID.
M3 — heartbeat watchdog + REST replay on reconnect.
M4 — polish (keybindings, theme, tmux layout doc).

Picking the work back up: read NEXT_STEPS.md first.

Requirements

Python 3.11+
uv
A running opencode serve (default 127.0.0.1:4096)

Quickstart

cd ~/Documents/obsidian/localgenai/oc-tree
uv sync
uv run oc-tree-probe

Drive opencode in another terminal. Probe writes JSONL frames to /tmp/oc-tree-probe.jsonl and a live counter to stdout. Ctrl-C to stop; event-type counts print on exit.

M0 verification queries

After driving a session that includes a Task subagent, a permission prompt, and a tool call:

# 1. Does session.created.info.parentID populate for subagents?
jq -r 'select(.type=="session.created") | .raw.properties.info.parentID' \
   /tmp/oc-tree-probe.jsonl

# 2. Does message.part.updated carry full parts or deltas?
jq -c 'select(.type=="message.part.updated") | .raw.properties.part' \
   /tmp/oc-tree-probe.jsonl | head

# 3. Which permission.* events actually fire?
jq -r '.type' /tmp/oc-tree-probe.jsonl | grep -i permission | sort -u

Configuration

Env var	Default
`OPENCODE_URL`	`http://127.0.0.1:4096`
`OPENCODE_SERVER_USERNAME`	`opencode` (if pw set)
`OPENCODE_SERVER_PASSWORD`	(unset → no auth)

References

opencode server docs
sst/opencode#7451 — no per-session SSE endpoint
sst/opencode#6573 — Task subagent over opencode serve
sst/opencode#11424 — replayed message.part.updated frames
sst/opencode#15149 — SSE disconnect leaves server hung

2.4 KiB Raw Permalink Blame History