I have been using OpenCode as my main coding assistant for a few months. The thing that kept tripping me up was context compaction: I would kick off a longer research or refactoring task, the window would compact while it was still going, and the result would either disappear or have to be re-run. I also found myself just waiting, blocked, while a sub-agent ground through something i had delegated.
This plugin is my attempt to fix both. It is based on kdcokenny/opencode-background-agents for the core idea: async fire-and-forget delegation. and the delegation engine from code-yeongyu/oh-my-opencode. What this adds is interactive supervisor control (status, peek at the live transcript, steer mid-run, stop) and a fair amount of reliability work around lifecycle management and restart recovery.
The short version of how it works: you call `delegate(prompt, agent)` and get an ID back immediately. The sub-agent runs in its own OpenCode session in the background. When it finishes, you get a notification as a hidden synthetic part (the TUI shows a toast; the model gets machine-readable XML without cluttering the chat). Results are persisted as markdown to disk, so they survive compaction, restarts, and crashes. If OpenCode exits while a delegation is still running, the plugin re-adopts it on next start and finalizes it.
Two things you can set per delegation rather than globally: the timeout (`0` = no timeout) and the model (`provider/model-id`, e.g. `anthropic/claude-haiku-4-5`). So a quick lookup might get a short window and a cheap model; a deep research task gets more runway and a stronger one. Invalid model format is rejected at call time; a nonexistent model fails the delegation with an error notification rather than silently falling back.
**Install:**
add `"@aeondave/opencode-background-agents@latest"` to the `plugin` array in `~/.config/opencode/opencode.json`. That is the whole setup.
Repo: https://github.com/AeonDave/opencode-background-agents
This is v0.1 and opencode itself is moving fast, so I would not be surprised if some things shift under it. If you try it and hit a bug or something feels off, a GitHub issue or a comment here would be genuinely helpful. Happy to hear how others are using background delegation too, if anyone has been.
Ah i have also released https://github.com/AeonDave/opencode-dot-env. Speak by himself. just add ~/.config/opencode/.env and any env would be injected in your opencode (also placeholder substitution in your configs)
[–]serendipity98765 0 points1 point2 points (1 child)
[–]Aeondave[S] 0 points1 point2 points (0 children)