Skip to content

README.md

Latest commit

 

History

History
30 lines (19 loc) · 1.11 KB

README.md

File metadata and controls

30 lines (19 loc) · 1.11 KB

ContextScope + OpenCode (plugin)

1. Run ContextScope

ctxscope serve

2. Install the plugin

Copy (or symlink) plugins/contextscope.ts into:

  • Project: <your-repo>/.opencode/plugins/contextscope.ts
  • Global: ~/.config/opencode/plugins/contextscope.ts

OpenCode loads .ts / .js files from those directories at startup (plugins docs).

3. Environment

Variable Purpose
CTXSCOPE_SERVER_URL Default http://127.0.0.1:8765
CTXSCOPE_HOOK_SECRET If set on ctxscope serve, send the same value (plugin sets X-ContextScope-Token)

4. What is captured

  • event hook: forwards OpenCode event objects (session.*, message.*, etc.). Session id is inferred from session.created / session.updated / session.status when present.
  • tool.execute.after: tool name, args, and result (redacted server-side).

All payloads are turned into synthetic snapshots (capture_source: opencode_plugin, framework opencode). Tune or extend contextscope.ts for extra hooks (e.g. tool.execute.before).