---
name: tracker/linear-cli:issue-comment
description: Add a comment to a Linear issue using the linear CLI
version: "0.4.0"
---

# Issue Comment

Post a markdown comment to an existing Linear issue to record progress, decisions, or blockers.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| id | string | Yes | Issue identifier (e.g., `ENG-123`) or internal UUID |
| body | string | Yes | Comment body (markdown supported) |

## Implementation

```bash
linear issue comment {id} --body "{body}"
```

## Output

| Field | Type | Description |
|-------|------|-------------|
| comment_id | string | Internal UUID of the created comment |
| url | string | Direct URL to the issue (comments are anchored within the issue view) |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| AUTH_FAILED | API key is missing or invalid | Run `linear auth` to authenticate |
| NOT_FOUND | No issue matches the provided identifier | Verify the ID with `linear issue list` |
| VALIDATION_ERROR | Comment body is empty | Provide a non-empty `--body` value |

## Used By

- dev-sprint (post progress updates and blocker notes during sprint execution)
