Comments
Comments are for people to talk to each other on a card. The thread is separate from the chat with Andon (⌘J) and from a run’s conversation on the Run tab. Use it to ask a teammate, record a decision, or hand a remark to the card’s run.
Where to find them
- On a card: the Comments tab in the rail, right after Notes, with the number of comments on the tab. On the full card page, tabs that don’t fit go into the rail’s More menu.
- On a phone: a Comments section right after the notes, closed until you open it. A mention’s link opens it.
Write a comment
- Open the card’s Comments tab.
- Type in the box. It is the notes editor: Markdown, the
/block menu,@to mention someone, and pasted or dropped files, which become the card’s attachments. - Press ⌘↩ (Ctrl+Enter) to post.
Then:
- Reply on a comment, or on any of its replies, to add to that comment’s thread. Replies are one level deep.
- Edit your own comment from its
…menu. It is marked edited. - Delete your own comment from the same menu. Owners and admins can delete anyone’s, and the audit log records it. A deleted comment that has replies leaves This comment was deleted. in its place.
- Click an emoji under a comment to react, and click it again to take yours back. Each person adds each emoji once.
A # link to a card, such as #ENG-42, works for the key of the card’s linked Linear or Jira issue. A card’s own
Andon key, such as #WEB-12, doesn’t become a link.
Mention someone
Type @ and pick a member, or write their handle: their name in lower case, with dots between the words
(@ada.lovelace). @owner and @assignee mention the card’s owner.
The person you mention:
- gets one notification for the comment, also when an edit adds them
- sees it in Activity under Mentions; opening it goes to the comment on its card and marks it read
- gets a push on each device that has Someone @mentioned you on a card ticked, titled Sam mentioned you on WEB-12. Pick that in Settings → You → Devices. Quiet hours apply
Only people who can see the card are notified, and never the author. A mention doesn’t pulse or appear in Needs you. Mentions aren’t sent by email.
Comments and the run
- Ask the agent on a comment sends it, quoted with its author, to the card’s run as a reply. It shows only while the run can take a reply.
- A run reads the card’s latest 20 comments only when its recipe’s template asks for them with
{{comments}}. See Writing a recipe. - A run can leave a comment on its own card. It shows as from the machine, with an agent tag, and mentions nobody; when an agent needs your answer it asks, and that shows in Needs you. The run’s history says Commented on the card. Nobody can edit an agent’s comment; an owner or admin can delete it.
Comments from Linear
A card made from a Linear issue brings the issue’s comments, marked from Linear. They are read-only on the board. Their author, or an owner or admin, can still delete one. See Integrations.
