opencode-background-agents

opencode-background-agents is an OpenCode plugin that enables asynchronous background task delegation with automatic result persistence to disk. It solves the context-window problem: when Claude's context fills up and compaction occurs, research results are typically lost. This plugin fires off research tasks as background delegations, lets you continue brainstorming or coding without blocking, and automatically saves results as markdown files. When context compacts, the AI knows exactly where to retrieve past research. Tools include delegate() to launch tasks, delegation_read() to retrieve results, and delegation_list() to scan prior work—ideal for operations teams and developers who need continuity across long sessions.

[{"step":"Install the OpenCode plugin in your Claude Code environment. Run `pip install opencode` and verify installation with `opencode --version`.","tip":"Ensure you have the latest version of Claude Code (v3.5 or higher) for full TypeScript support."},{"step":"Prepare your task with clear context. Use the prompt template to structure your request, including [RESEARCH_TASK], [CONTEXT_DATA], [PRIORITY_LEVEL], and [DEADLINE].","tip":"Attach relevant files or links as context data to avoid ambiguity. For example, include competitor websites, product docs, or internal notes."},{"step":"Delegate the task to a background agent using the OpenCode CLI. Example: `opencode run --task \"Research Acme Corp's latest product launches\" --context ./acme-notes.md --priority high --deadline 2024-10-15`.","tip":"Use the `--format` flag to specify output format (e.g., markdown, JSON) if your workflow requires structured data."},{"step":"Monitor progress via the OpenCode dashboard or CLI. Use `opencode status` to check active tasks and `opencode logs [TASK_ID]` to review agent actions.","tip":"Set up notifications (e.g., Slack, email) for task completion to avoid manual checks."},{"step":"Review and act on the agent's output. Validate findings against your internal data sources and integrate insights into your workflow.","tip":"For critical decisions, cross-check agent findings with a human review to ensure accuracy."}]