Skip to content

joshuadavidthomas/opencode-beads

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.json:

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

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.

About

An OpenCode plugin for the beads issue tracker

Resources

License

Code of conduct

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published