Files
beads/commands/comments.md
Steve Yegge 1611f16751 refactor: remove unused bd pin/unpin/hook commands (bd-x0zl)
Analysis found these commands are dead code:
- gt never calls `bd pin` - uses `bd update --status=pinned` instead
- Beads.Pin() wrapper exists but is never called
- bd hook functionality duplicated by gt mol status
- Code comment says "pinned field is cosmetic for bd hook visibility"

Removed:
- cmd/bd/pin.go
- cmd/bd/unpin.go
- cmd/bd/hook.go

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-27 16:02:15 -08:00

965 B

description, argument-hint
description argument-hint
View or manage comments on an issue
issue-id

View or add comments to a beads issue.

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.

View Comments

To view all comments on an issue:

  • $1: Issue ID (e.g., bd-123)

Use the beads CLI bd comments <issue-id> to list all comments. Show them to the user with timestamps and authors.

Add Comment

To add a comment:

  • $1: "add"
  • $2: Issue ID
  • $3: Comment text (or use -f flag for file input)

Use bd comments add <issue-id> "comment text" to add a comment. Confirm the comment was added successfully.

Comments are useful for:

  • Progress updates during work
  • Design notes or technical decisions
  • Links to related resources
  • Questions or blockers