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_required error.

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#

SymptomLikely cause
"Post comment" returns an error about a plan upgradeYour 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 taskThe 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.