markyardExplore the docs

Comments

Route review comments to an AI agent

Use the built-in @AI persona when a comment thread contains a concrete request that a user-invoked local agent should receive. The mention is a routing signal only: it does not start an agent, change the document, or resolve the thread.

Customer guideIdentity administrator

Mention AI in a comment

  1. Start a comment or reply.
  2. Type @AI.
  3. Select AI persona from the mention list.
  4. Add the requested change and submit the message.

The selected mention is stored as structured review metadata. Plain @AI text that was not selected from the mention list does not route the thread.

An AI mention in either the original comment or any reply addresses the complete thread. This gives the local agent the original feedback and every reply needed to understand the request.

Retrieve addressed threads

An authorized user can list open AI-addressed threads with:

markyard comments list <document-id>

Add --all to list every visible open thread, including ordinary human discussion:

markyard comments list <document-id> --all

Use the CLI's global --json option when another tool or local agent needs the complete machine-readable thread data. Resolved threads are excluded from both modes.

The local agent acts with the invoking user's Markyard permissions. Reading comments does not grant permission to edit the document, reply, or resolve a thread.