---
description: View or manage comments on an issue
argument-hint: [issue-id]
---

View or add comments to a beads issue.

## 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
