Comments
Comments let team members discuss tasks without interfering with the agent conversation.
Plan requirement: Comments require the Team or Business plan. Posting a comment on a Free or Pro plan returns a
payment_requirederror.
Opening the Comments Panel#
With a task open in the workspace, click the Comments button in the task toolbar (MessageSquare icon). This opens a Comments tab in the editor panel alongside your files and other tabs.
If no task is selected, the tab shows "Select an execution to view its comments."
Adding Comments#
From the Comments tab:
- Create a comment by typing in the input area and clicking Post comment. Comments are capped at 5,000 characters.
- Edit your own comments by clicking Edit below the comment (owners can edit any comment in the workspace).
- Delete your own comments by clicking Delete below the comment (owners can delete any comment in the workspace).
Comments are displayed newest-first. When there are more than 20, a Load older button appears at the bottom — the label shows the exact count being loaded (e.g. "Load 20 older of 45" when more than 20 remain, or "Load 5 older" when 20 or fewer remain).
@Mentions#
Type @ in the comment input to mention a teammate. The autocomplete dropdown suggests teammates you have recently collaborated with (shares or handoffs within the past 30 days, capped at 25), matching on either email local-part or display name. You can also type a correct email local-part manually — the server resolves mentions against all members of your workspace, so a user does not need to appear in the dropdown for the auto-share to take effect. Mentioning a user:
- Automatically grants them comment access on the task if they don't already have it.
- Flips a Private task to "Shared with users" on the first mention.
Mentions inside fenced code blocks (``` or ~~~), blockquotes (>), and inline code (`) are intentionally ignored to avoid accidental auto-shares.
Difference from Agent Messages#
Comments are separate from the agent conversation. They don't affect the agent's context or behavior — they're purely for human-to-human communication about the task.
Use Cases#
- Code review notes — Leave feedback on agent-generated code
- Questions — Ask teammates about a task's output
- Status updates — Note follow-up actions needed
Troubleshooting#
| Symptom | Likely cause |
|---|---|
| "Post comment" returns an error about a plan upgrade | Your workspace is on Free or Pro; comments require Team or Business |
| Comments panel shows "Select an execution to view its comments" | No task is selected in the current workspace view |
@mention did not auto-share the task | The typed local-part did not match any member of your workspace. Note: the autocomplete only shows recent collaborators — if a user does not appear in the dropdown, type their email local-part manually and the server will still resolve and auto-share. |