opencode-beads 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -12,14 +12,18 @@ curl -fsSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/insta
12
12
 
13
13
  See the [beads installation guide](https://github.com/steveyegge/beads/blob/main/docs/INSTALLING.md) for alternative methods (Homebrew, Windows, AUR, etc.).
14
14
 
15
- Add to your `opencode.json`:
15
+ Add to your OpenCode config (`~/.config/opencode/opencode.json`):
16
16
 
17
17
  ```json
18
18
  {
19
- "plugin": ["opencode-beads"]
19
+ "plugin": ["opencode-beads@0.3.1"]
20
20
  }
21
21
  ```
22
22
 
23
+ Restart OpenCode and you're ready to go.
24
+
25
+ Pin to a specific version to ensure updates work correctly - OpenCode's lockfile won't re-resolve unpinned versions. To upgrade, change the version and restart.
26
+
23
27
  ## Features
24
28
 
25
29
  - **Context injection** - Automatically runs `bd prime` on session start and after compaction, keeping your agent aware of current issues
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "opencode-beads",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "type": "module",
5
5
  "description": "A plugin for OpenCode that provides integration with the beads issue tracker.",
6
6
  "author": "Josh Thomas <josh@joshthomas.dev>",
@@ -5,6 +5,8 @@ argument-hint: [issue-id]
5
5
 
6
6
  View or add comments to a beads issue.
7
7
 
8
+ Comments are separate from issue properties (title, description, etc.) because they serve a different purpose: they're a **discussion thread** rather than **singular editable fields**. Use `bd comments` for threaded conversations and `bd edit` for core issue metadata.
9
+
8
10
  ## View Comments
9
11
 
10
12
  To view all comments on an issue:
@@ -16,6 +16,8 @@ If arguments are missing, ask the user for:
16
16
 
17
17
  Use the beads MCP `update` tool to apply the changes. Show the updated issue to confirm the change.
18
18
 
19
+ **Note:** Comments are managed separately with `bd comments add`. The `update` command is for singular, versioned properties (title, status, priority, etc.), while comments form a discussion thread that's appended to, not updated.
20
+
19
21
  Common workflows:
20
22
  - Start work: Update status to `in_progress`
21
23
  - Mark blocked: Update status to `blocked`