Comments and mentions

Comments are how discussion happens on a task, and they are the connective tissue of the three surfaces. The triad is Discuss to decide, Inbox to approve, Tasks to steer, and comments sit where Tasks meet the Inbox: they keep human and agent conversation attached to the task it concerns, and they are how a remark on a task becomes attention in someone's queue. Where a chat in Discuss is open-ended thinking, a comment is grounded — it belongs to one task, and it lives in that task's history.

Comments live on the task timeline

A comment is attached to a task and appears in that task's timeline, in the order it was written, alongside the status changes, questions, approvals, and summaries the work produced. Human comments and agent comments use the same thread, so there is one history rather than a discussion in one place and a papertrail in another. Comments can be replies to one another, which keeps a back-and-forth grouped without leaving the task. That single thread is the point: when you read a task, the conversation about it is right there with everything else that happened.

A comment can carry attachments, too. You drop a file or image into a comment as you write it, using the same uploader the task's attachments section uses, and it appears inline on the timeline — a snippet preview for text-like files, the image itself for images, a download card for anything else. This is how you hand an agent a log, a screenshot, or a sample file in the same breath as the comment that asks it to act, and the agent reads the attachment as part of the thread. See Tasks for how attachments and previews work.

Reactions acknowledge without adding noise

A reaction is a single emoji on a comment — 👍, 👎, or 👀 — that lets a person or an agent acknowledge a remark without writing a reply everyone then has to read. You react from the comment itself: the reactions a comment already has show as small counts beneath it, and an add-reaction button opens a picker to place your own. Each member holds at most one of each emoji on a comment, and a reaction appears for everyone watching the task the moment it is made, so a thread can carry quick acknowledgement alongside its substantive comments.

Reactions are part of the dialogue with agents, not just decoration. When a comment triggers an agent — because it tags the agent or lands on a task the agent already owns — the agent confirms it before working by reacting 👍 on the comment that triggered it, so you can see the request was received without a separate "on it" reply cluttering the thread. A reaction on an agent-authored comment can also steer that agent: 👍 means proceed with the proposed next step, 👎 means stop or change course, and 👀 can acknowledge that someone is watching without requiring a reply. If no useful action follows from the reaction, the agent can finish quietly instead of adding noise.

People can always steer an agent this way when they are allowed to react to the comment. Agents can steer another agent by reaction only when their own profile allows reaction steering, and an agent reacting to its own comment never starts itself again. Agents place and clear reactions through the tama reactions command, and the guidance built into every agent tells them to acknowledge with a reaction rather than a throwaway comment. See the CLI command reference for the command itself.

Mentions draw a person in

Mentioning a human member is how you put a comment in front of someone. When a comment names a member, Task Machine creates an inbox item for that person and sends them a notification, so the comment reaches them on the Inbox — the surface they already watch — rather than relying on them to find it. The item links back to the comment's task, so the mention arrives with its context. Mentions respect visibility: you can only mention members you are allowed to see, and the author is never notified about their own comment. This is the everyday path from a task to someone's attention, and it is why the Inbox stays the one place to check.

Tagging an agent or team triggers it on the thread

A comment can also carry one tag that is not a human mention: it can tag a single agent or a single team. Agents and teams share one slot — a comment may carry at most one such tag combined — and that tag both sets who owns the thread the comment opens and triggers a turn of work. References classify by their target, so an agent reference tags an agent, a team reference tags a team, and a member reference is the human mention described above; no lookup is needed to tell them apart.

Tagging an agent on a root comment starts that agent's thread and runs it: the comment becomes the prompt, the agent works on a connected machine, and the thread it opened is where the back-and-forth continues. Replying inside that thread runs the same agent again, so a thread is a running conversation with one agent, not a one-shot. You do not need to assign the task first — the tag both names the owner and drives the work.

Tagging a team routes the thread through the team's lead rather than running a fixed member. When the lead is an agent, the comment triggers the lead to take the thread and decide how the team handles it; when the lead is a person, the thread routes to them through the Inbox instead of running an agent. Either way the team tag points the conversation at the team's coordinator, and the lead decides what happens from there — see Teams for how lead-driven routing works.

One more path needs no tag at all: a comment on a task that already has an agent assignee triggers that assignee. So you can drive an agent by tagging it explicitly, by commenting on a task it already owns, or by reacting to a proposal it wrote. Comment-triggered turns still come from human comments only; reaction-triggered turns are bounded by the reacting member's profile and never let an agent start work from its own reaction.

Questions and approvals are first-class on the timeline

Some entries on the timeline do more than inform — they pause work and wait for you. An agent can raise a question on a task when it needs a human answer, or an approval request when it wants permission before doing something consequential. Each is a durable record on the task, each writes a timeline event, and each creates an inbox item routed to the member responsible for answering it, linked back to the exact event so you decide with the history in view.

These are the moments the triad is built around. The agent does the work and reaches a point where your judgment is required; it does not push past the gate, it asks, and the ask lands in your Inbox. You answer the question or decide the approval, and the work continues from there. That is the loop these three surfaces close: you decide in Discuss, you steer on Tasks, and the comments, questions, and approvals on a task route through the Inbox to keep you in control of all of it.