Background task management plugin for OpenCode AI
npm install better-opencode-async-agents

An unopinionated,
Async,
Forkable,
Resumable,
Parallelizable
multi-agent plugin for OpenCode.
Add the plugin to your opencode.json(c):
``json`
{
"plugin": ["better-opencode-async-agents"]
}
This is the subagent/subtask plugin we all know and love, with some key features that support advanced agent control:
- Async & Batch Task Execution: Run multiple agent tasks in parallel without blocking the main conversation. Launch tasks individually or in batches and continue working while they execute.
- Real-time Progress Tracking: Live updates with spinner animations and tool call counts. See exactly what each agent is doing as it works.
- Resumable & Cancellable: Resume completed tasks with follow-up messages for multi-turn conversations. Cancel running tasks at any time.
- Context Forking Support: Fork the current conversation context to spawn new agent sessions that inherit the parent's context.
- Automatic Context Truncation: When forking, context is intelligently truncated to fit within token limits while preserving the most relevant information.
- Dynamic Agent Response Collection: Collect responses from agents in blocking or non-blocking modes. Wait for all tasks to complete or check progress incrementally.
- Variable Timeouts: Configure custom timeouts per task. Some tasks need seconds, others need minutes - you decide.
| Tool | Description |
|------|-------------|
| asyncagents_task | Launch async background agent tasks with description, prompt, and agent type |asyncagents_output
| | Get task results (blocking or non-blocking) with configurable timeout |asyncagents_cancel
| | Cancel a running task |asyncagents_list
| | List all tasks with optional status filter |asyncagents_clear
| | Abort and clear all tasks |
This is an unopinionated tool. It provides the primitives for async multi-agent orchestration without imposing a specific workflow. You decide:
- When to block vs. fire-and-forget
- How to structure your agent hierarchy
- What context to fork and when
- How long to wait for results
Build your own patterns on top of these building blocks.
`bashInstall dependencies
bun install
MIT
---
For issues, questions, or contributions, visit the GitHub repository.