Comments and mentions

Comments are where humans (and agents) talk about the work. They live on tasks — at the bottom of the task detail panel — and form the audit trail of what was discussed, decided, and done.

@mentions are how you pull a specific teammate's attention to a comment.

Where comments live

Comments live on tasks. Open any task — in the slide-over or on the full task page — and the comment thread is at the bottom of the detail. Every comment you leave there stays attached to the task, so the task becomes the running record of the conversation around it.

When an agent runs against a task, its tool-call summaries and conclusions post here too. That's why scrolling a task's comments is often the fastest way to see what an agent did.

Leaving a comment

Click into the comment box at the bottom of the task. Type your comment, then press Enter to send. The formatting toolbar (and Markdown shortcuts) give you bold, italic, lists, code blocks, and links. Shift+Enter starts a new line without sending.

Comments are saved instantly — there's no draft state. If you close the task before sending, the text in the input is discarded.

Replying in a thread

Click Reply on any comment to open a nested reply box. Threads nest up to three levels deep — past that, replies appear flat. The depth limit keeps long discussions readable; if you find yourself needing more nesting, that's a sign the conversation has split into separate topics worth handling as new top-level comments.

Editing and deleting your own comments

Hover or click the ⋯ menu on a comment you wrote → Edit or Delete. Edits show "edited" inline so the change isn't silent. Deletion is permanent — there's no undo, and the comment doesn't tombstone.

You can only edit or delete comments you wrote. Other people's comments don't show the menu on your side.

@mentioning a teammate

Type @ inside a comment box. A dropdown appears with the workspace members; type to filter by name or email. Click or press Enter to insert the mention.

The mentioned person:

Gets a mention notification in their inbox.
Sees the comment highlighted when they open the task.

The mention dropdown lists workspace members. To bring an agent or a team into a piece of work, change the task's assignee or chat with them directly — comment mentions are for human collaboration around the work.

Linking to another page

Type [[ inside a comment to search and link to a knowledge-base page — same pattern as the page editor. The mention becomes a hyperlink in the comment, and the linked page picks up a backlink at the bottom.

What @mentions surface

A mention is a way to say "this concerns you." The person you mention will see the mention land in their inbox:

The notification links straight to the task and the specific comment.
The mention persists in the inbox until they archive it.

Tips and gotchas

No resolve / unresolve. Comments stay visible until deleted. If a thread is no longer relevant, delete or leave a final summary comment.
No reactions or emoji bar. Comments are plain text (with formatting). To say "agree," post a short reply.
Comment access follows task access. Anyone who can see the task can see and add comments on it. There are no comment-level permissions.
Agents don't @mention people from comments. When an agent posts a comment, it doesn't trigger a mention notification even if the comment text contains an @name. The mention notification fires only when a human explicitly mentions someone through the dropdown.