Comments

Leave inline comments on any document to collaborate with your team, request changes, or track open questions.

Adding a Comment

1. Open a document in the editor.
2. Click the Comments icon in the right toolbar to open the comment panel.
3. Type your comment and press Post.

Comments appear in a sidebar alongside the editor. Each comment is timestamped and linked to the author.

Mentions

Use @username in a comment to notify a team member.

Resolving Comments

Any member with Editor access or higher can resolve a comment. Resolved comments are hidden by default — toggle "Show resolved" to see them.

Anchored Comments in the Share View

When a document is shared (public or private link), reviewers can leave comments anchored to a specific text selection — similar to Figma comments.

1. Open the share link.
2. Click the Comments icon in the topbar to enter comment mode.
3. Highlight any phrase in the document, right-click, then write your comment in the inline composer.
4. Existing threads appear as small avatar pins next to the highlighted text. Click a pin to read the thread or reply.

All comments — anonymous and authenticated — are written to the same thread as comments posted from the editor. They appear in the editor's comments panel and are listable from the CLI and MCP.

Reading Comments from CLI / AI

The specdown comments list <path> command prints all comment threads on a document — including anonymous comments left in the share view. Use --unresolved to focus on open threads or --json for tooling.

specdown comments list guides/authentication
specdown comments list guides/authentication --unresolved
specdown comments list guides/authentication --json

AI assistants connected via MCP can read the same data with the list_comments tool.

Comment Permissions