ocx init
ocx registry add --name kdco https://registry.kdco.dev
ocx add kdco/background-agents
Keep working while research runs in the background. Your work survives context compaction.
A plugin for OpenCode that enables async background delegation. Fire off research tasks, continue brainstorming or coding, and retrieve results when you need them.
Context windows fill up. When that happens, compaction kicks in and your AI loses track of research it just did. You end up re-explaining, re-researching, starting over.
Background agents solve this:
ocx add kdco/background-agents --from https://registry.kdco.dev
If you don't have OCX installed, install it from the OCX repository.
Optional: Install kdco-workspace for the full experience—it bundles background agents with specialist agents, planning tools, and research protocols:
ocx add kdco/workspace --from https://registry.kdco.dev
1. Delegate → "Research OAuth2 PKCE best practices"
2. Continue → Keep coding, brainstorming, reviewing
3. Notified → <system-reminder> tells you it's done
4. Retrieve → AI calls delegation_read() to get the result
Results are persisted to ~/.local/share/opencode/delegations/ as markdown files. Each delegation is automatically tagged with a title and summary, so the AI can scan past research and find what's relevant.
The plugin adds three tools:
| Tool | Purpose |
|---|---|
delegate(prompt, agent) |
Launch a background task |
delegation_read(id) |
Retrieve a specific result |
delegation_list() |
List all delegations with titles and summaries |
Only read-only agents (researcher, explore) can use delegate. Write-capable agents (coder, scribe) must use the native task tool.
Why? Background delegations run in isolated sessions outside OpenCode's session tree. The undo/branching system cannot track changes made in background sessions—reverting would not affect these changes, risking unexpected data loss.
A workaround is being explored.
Delegations timeout after 15 minutes.
View active and completed sub-agents using OpenCode's navigation shortcuts:
| Shortcut | Action |
|---|---|
Ctrl+X Up |
Jump to parent session |
Ctrl+X Left |
Previous sub-agent |
Ctrl+X Right |
Next sub-agent |
Each delegation is automatically tagged with a title and summary when it completes. When the AI calls delegation_list(), it sees all past research with descriptions - not just opaque IDs. This lets it scan for relevant prior work and retrieve exactly what it needs.
Results are saved to disk and survive context compaction, session restarts, and process crashes. Within a session, the AI can retrieve any past delegation. New sessions start fresh but the files remain on disk.
The opposite - it saves context. Heavy research runs in a separate sub-agent session. Only the distilled result comes back to your main conversation when you call delegation_read().
Claude's native task tool runs sub-agents but results can be lost when context compacts. This plugin adds a persistence layer - results are written to markdown files, so the AI always knows where to find them.
One command, auto-configured, registry-backed updates. You could copy the files manually, but you'd need to handle dependencies (unique-names-generator) and updates yourself.
If you prefer not to use OCX, copy the source files from src/ to .opencode/plugin/background-agents.ts.
Caveats:
unique-names-generator)This plugin is part of the KDCO Registry. For the full experience, check out kdco-workspace which bundles background agents with specialist agents, planning tools, and notification support.
This facade is maintained from the main OCX monorepo.
If you want to update opencode-background-agents itself, start here:
https://github.com/kdcokenny/ocx/blob/main/workers/kdco-registry/files/plugins/background-agents.ts
Open issues here: https://github.com/kdcokenny/ocx/issues/new
Open pull requests here: https://github.com/kdcokenny/ocx/compare
Please do not open issues or PRs in this facade repository.
This project is not built by the OpenCode team and is not affiliated with OpenCode in any way.
MIT
ck
Persistent per-project memory for OpenAI Codex. Auto-loads project context on session start, tracks sessions with git activity, and writes to native memory. Commands run deterministic Node.js scripts — behavior is consistent across model versions.
by AgentHub Crawler
OpenCode Supermemory
OpenCode plugin for persistent memory using Supermemory. Your agent remembers what you tell it - across sessions, across projects.
by AgentHub Crawler
AGENTS.md
Guide for AI agents working in this repository. **See also:** [DEVELOPMENT.md](DEVELOPMENT.md) - Development best practices and coding standards for AI-assisted development.
by AgentHub Crawler
Sign in to leave a comment.
Agent Directives: Mechanical Overrides
You are operating within a constrained context window and strict system prompts. To produce production-grade code, you MUST adhere to these overrides:
by AgentHub Crawler