Comments and replies
Comments keep questions, evidence, decisions, and feedback attached to a task. Start a new comment for a new topic. Reply when you are continuing the topic under an existing comment.
Where comments appear
Task details provide two tabs:
- Activity shows comments, threaded replies, and task activity in one timeline. Use it to reply, react, edit or delete when permitted, and resolve a comment thread.
- Executions shows the task's run history separately from the comment timeline.
The Agent chat on a task does not take a tab. It opens in a side panel on the task, and it is not a comment timeline. You can start it without first assigning an Agent or Crew. See Chat with an Agent.
Write team-visible conclusions in comments or the task description. Messages in the task's Agent chat do not become Activity comments.
Comment notifications and task Agent-chat notifications follow different audience rules: ordinary comments use task subscriptions and notification preferences; Agent replies and related handoff notices in a task conversation are directed to that conversation's starter, rather than broadcast to every subscriber or earlier participant.
The Agent chat on a task does not read from or write to standalone Agent Chat sessions.
Start a comment or continue a thread
Use a new comment when the information should stand on its own, for example:
- a new requirement, constraint, or acceptance condition;
- a fresh review finding or decision;
- a new set of logs, screenshots, or files;
- an instruction for the task's Agent Assignee.
Use a reply when answering or extending an existing comment. Replies are attached to the top-level comment. If a reply targets another reply, Sharkly still keeps the thread at one level under its root comment.
Comment actions
Depending on your permissions, you can:
- attach files and include mentions;
- add or remove a reaction;
- edit or delete a comment you are allowed to manage;
- copy a comment or copy a full thread as a prompt;
- resolve or reopen a top-level comment thread.
The comment More menu (labels follow the product UI) typically includes:
- Edit: at the top of the menu; entering edit focuses the comment so you can type immediately;
- Resolve thread (reopen after it is resolved);
- Copy, Copy as prompt;
- Share;
- Delete.
Only a top-level comment can be resolved. Resolving it collapses the thread in Activity. Reopen it before adding another reply.
Expand the reply composer
The reply composer can expand into a larger editing area. Expanding or collapsing it keeps the current draft, long text, and pasted images, so you can continue editing before sending.
Quick replies
Quick replies are personal saved responses available in comment and reply composers. Click the item text to send it immediately. Hover to show Insert, with the hint Edit the canned text before sending. Inserting writes the text into the composer and focuses it; it does not send. Edit the text, then send it yourself.
You can add, edit, reorder, and remove quick replies. They are stored per person, not shared with the team.
Mention an Agent in a quick reply
Quick replies can include an Agent mention. Select an Agent while creating or editing a quick reply; the mention remains when you reopen it. Sending the quick reply directly, or selecting Insert to place it in a comment, reply, or Agent Chat composer before sending, uses the normal Agent-mention rules.
An Agent must be available and usable by the current person in the current Organization and Space to remain an active mention. An archived, unavailable, cross-Space, or inaccessible Agent may be shown as plain text or prevent sending. A quick reply does not bind an Agent to every Task.
Review confirmation from a quick reply
When a Task is waiting for review, successfully sending the “Reviewed, no issues” quick reply clears the pending-review marker automatically. The cleared state remains consistent in task lists, Task details, and when you reopen the Task. This happens only after the message is sent successfully and only when the Task was actually waiting for review.
This clears the pending-review marker only. It does not change the Task's lifecycle status or mark the Task as completed.
Copy an image from a comment or chat
Open the image preview in a task comment or Agent chat and select Copy image to paste it into another application that accepts images.
If copying is unavailable or fails, use the preview's download action to save the image instead.
Download large attachments
When an attachment cannot be previewed directly, use Download rather than Open. Sharkly shows download feedback, and the desktop app opens the download directory and locates or selects the file after the download completes. This depends on operating-system permissions and desktop-app capabilities; if the file is not located automatically, find it in the system Downloads folder.
Long comments
Long comments in Activity collapse by default. Use Expand all at the bottom to read the full text so other comments that were pushed off-screen become visible. After expanding, you can Collapse the comment.
Attachments
When an attachment appears in the body, it is part of that content. Deleting it from the body with Backspace or Delete, then saving, permanently removes the file. It does not move to the standalone attachments area below.
If you only want it out of the body but still need the file, use Remove from task description or Remove from comment. After you move it out, it appears as a standalone attachment; inserting it into the content again hides the standalone card.
Deleting a standalone attachment still asks for confirmation, and confirming permanently deletes the file. Images, videos, and ordinary files use the same delete and move-out meaning; preview can differ.
When you edit a comment, attachments on that comment that the current draft does not yet reference still appear as standalone attachments. You can insert, move them out, or delete them.
If you clear the comment body and save:
- when the comment has no remaining attachments, the product asks whether to Delete comment (it does not silently restore the original text);
- when a comment-level standalone attachment remains, the comment is kept as an attachments-only comment.
In the task description, click once to select an attachment node and double-click to preview. In a read-only comment body, click once to preview. This section does not cover Chat or Agent conversation attachments.
Share selected task comments
In Activity, use the share control on a comment or reply to enter selection mode, then select one or more comment items. Only items the UI allows you to select can be shared; content brought in by a third-party integration might not be selectable.
A share link can be visible to Anyone with the link or Organization members only, and you can also create a share image. A share is a creation-time snapshot, so later comments and edits do not change the shared page. Revoke sharing invalidates the current share links for that source.
Before sharing, confirm the source and the access boundary in the originating external system. Do not share passwords, tokens, API keys, private keys, personal data, internal logs, or unredacted screenshots. Anyone who has a public link may be able to access it.
When a comment starts an Agent conversation
A plain member comment does not start the task's Agent Assignee. To have an Agent or Crew respond from a comment, @ mention that Agent or Crew.
An explicit Agent or Crew mention opens or continues that target's conversation on the task and writes the comment into the conversation. Activity can show Continued in the chat with {{name}}. One task keeps one conversation per Agent; mentioning different Agents opens separate conversations.
The mentioned Agent or Crew does not need to be the task Assignee, but it must belong to the organization, be available, be accessible to the member, and have no duplicate pending run for the task. Continue in the task's chat side panel, or @ mention the same Agent again.
Waiting for a human reply or waiting for human review appears on that task conversation. Inbox can still group those conversation signals onto the task row. See Chat with an Agent.
Keep durable requirements in the task
Use comments for discussion and follow-up context. Keep the stable goal, scope, and acceptance criteria in the task description so the current requirement remains easy to find.