A plugin for OpenCode that provides integration with the beads issue tracker.
npm install opencode-beadsBeads issue tracker integration for OpenCode.
Install the beads CLI:
``bash`
curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
See the beads installation guide for alternative methods (Homebrew, Windows, AUR, etc.).
Add to your OpenCode config (~/.config/opencode/opencode.json):
`json`
{
"plugin": ["opencode-beads"]
}
Restart OpenCode and you're ready to go.
Optionally, pin to a specific version for stability:
`json`
{
"plugin": ["opencode-beads@0.4.0"]
}
OpenCode fetches unpinned plugins from npm on each startup; pinned versions are cached and require a manual version bump to update.
- Context injection - Automatically runs bd prime on session start and after compaction, keeping your agent aware of current issues/bd-*
- Commands - All beads operations available as commandsbeads-task-agent
- Task agent - Autonomous issue completion via subagent
This plugin brings beads into OpenCode. For learning how to use beads itself - workflows, commands, best practices - see the beads documentation.
The plugin automatically injects beads context on session start and after compaction, so your agent stays oriented.
Commands are available as /bd-* and mirror the bd CLI. See the beads documentation for the full command reference.
A subagent for autonomous issue completion. Designed to work through issues independently, updating status and handling dependencies.
opencode-beads is licensed under the MIT license. See the LICENSE` file for more information.
---
opencode-beads is not built by, or affiliated with, the OpenCode team.
OpenCode is ©2025 Anomaly.