document: no way to view a document's comments (no `document comment` subcommand; --json omits comments)

[jayanth-kumar-morem]

Summary

There's no way to view the comments on a document from the CLI. Documents can have their own comment threads in Linear (distinct from issue comments), but the document command exposes no way to read them, and the JSON payload omits them entirely.

Details

• linear document --help lists only list, view, create, update, delete — there is no document comment subcommand (compare linear issue comment list <id>, which works for issues).
• linear document view <id> --json returns only:

  id, title, slugId, content, url, createdAt, updatedAt, creator, project, issue
  

  i.e. no comments field, so even programmatic access can't reach them.

Steps to reproduce

1. Open a Linear document that has at least one comment in the web app.
2. linear document view <doc-id> --json → no comments in the output.
3. linear document comment list <doc-id> → no such subcommand.

Expected

A way to list a document's comments, e.g. either:

• a linear document comment list <doc-id> subcommand (mirroring linear issue comment list), and/or
• a comments field included in linear document view <doc-id> --json.

Actual

Document comments are unreachable from the CLI by any command or flag.

Environment

• linear --version: 2.0.0
• Installed via Homebrew (macOS, arm64)

Notes

linear issue comment list <id> already works for issues, so this is the analogous gap for documents. Useful for agents/automation that need to read review discussion living on a spec document rather than on an issue.