opencode-beads

opencode-beads

Beads issue tracker integration for OpenCode.

[!NOTE] This plugin is intentionally small in scope. The beads project is moving quickly and is a moving target — any additional layers on top of it add churn.

To minimize maintenance, this plugin defers to beads and limits its scope to bug fixes and syncing upstream vendor plugin content. Feature requests and additional customization are generally out of scope.

If you want to customize behavior, the plugin surface area is small — forking or copying it locally is encouraged.

Installation

Install the beads CLI:

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):

{
  "plugin": ["opencode-beads"]
}

Restart OpenCode and you're ready to go.

Optionally, pin to a specific version for stability:

{
  "plugin": ["opencode-beads@0.5.3"]
}

OpenCode fetches unpinned plugins from npm on each startup; pinned versions are cached and require a manual version bump to update.

Features

• Context injection - Automatically runs bd prime on session start and after compaction, keeping your agent aware of current issues
• Commands - All beads operations available as /bd-* commands
• Task agent - Autonomous issue completion via beads-task-agent subagent

Usage

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

Commands are available as /bd-* and mirror the bd CLI. See the beads documentation for the full command reference.

Agent

beads-task-agent

A subagent for autonomous issue completion. Designed to work through issues independently, updating status and handling dependencies.

License

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.