kdcokenny/opencode-background-agents

269 stars · Last commit 2026-05-12

Claude Code-style background agents for OpenCode – async delegation with context persistence

README preview

# opencode-background-agents

> Keep working while research runs in the background. Your work survives context compaction.

A plugin for [OpenCode](https://github.com/sst/opencode) that enables async background delegation. Fire off research tasks, continue brainstorming or coding, and retrieve results when you need them.

## Why This Exists

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:

- **Keep working** - Delegate research and continue your conversation. Brainstorm, code review, discuss architecture - you're not blocked waiting.
- **Survive compaction** - Results are saved to disk as markdown. When context gets tight, the AI knows exactly where to retrieve past research.
- **Fire and forget** - Use the "waiter model": you don't follow the waiter to the kitchen. A notification arrives when your order is ready.

## Installation

```bash
ocx add kdco/background-agents --from https://registry.kdco.dev

View full repository on GitHub →