opencode-beads

Beads issue tracker integration for OpenCode.

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": ["[email protected]"]
}

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.