Repository navigation
Releases
opencode-bg-control v0.1.1
Relicensed under MIT starting with 0.1.1. The previous release, v0.1.0, remains GPL-3.0-only and unchanged.
No behavior changes from 0.1.0.
Install
Add the package name to your OpenCode config; OpenCode installs it automatically via npm:
{ "plugin": ["opencode-bg-control"] }The OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=1 feature flag is mandatory and must be set before OpenCode starts.
Tools
Five bounded tools for background Task subagents: bg_list, bg_status, bg_result, bg_transcript, bg_cancel.
All state is process-epoch scoped (memory-only, not durable across restarts) and read-only/observational except bg_cancel. Do not poll — these tools complement, not replace, OpenCode's built-in completion/failure notifications.
opencode-bg-control v0.1.0
First public npm release of opencode-bg-control.
Install
- npm: https://www.npmjs.com/package/opencode-bg-control/v/0.1.0
- OpenCode config:
{"plugin":["opencode-bg-control"]} - Mandatory feature flag:
OPENCODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS=1
Tools
bg_listbg_statusbg_resultbg_cancelbg_transcript
Limitations
Task state is exact when tracked directly and inferred when recovered from observable runtime state. Tracking is limited to current OpenCode process epoch; jobs from earlier process epochs are unavailable. Plugin deliberately provides no polling or wait loop: use built-in completion notifications, then inspect terminal results.
Validation
Clean package-name OpenCode auto-install and bg_list smoke passed (ok:true, feature:enabled).
License: GPL-3.0-only.
README npm-first installation improvements landed on main after release commit.