Markup Comments

Markup Comments

Every markup on the canvas can have a threaded comment log attached to it. Comments are stored in the local SQLite database alongside the markup record and persist across sessions.

Opening Comments

Right-click any markup on the canvas and select View Comments…, or select the markup and click the speech-bubble icon in the context toolbar that appears above the selection.

Adding a Comment

Type in the comment input at the bottom of the comment panel and press Enter or click Post. The comment is immediately saved and timestamped.

Comment Indicators

Markups with at least one comment show a small dot badge in their top-right corner on the canvas. The badge is visible regardless of which markup tool is active and does not interfere with selection or editing.

Comment History

The full comment history for a markup is shown chronologically. Each entry shows the comment text, a truncated machine identifier, and the UTC timestamp. Comments cannot be edited — delete and re-post to correct a mistake.

Mentioning Teammates

Type @ in the comment box to mention a teammate from the project's team list. Khatam classifies the markup's discipline (architectural, structural, mechanical, electrical, plumbing, or civil) and floats the matching-discipline people to the top of the list — so on a structural callout, your structural engineer is the first suggestion, marked with the Khatam mark. People whose discipline doesn't match, or when there's no confident classification, are listed alphabetically. Use the arrow keys and Enter, or click, to insert a mention. Add and tag your team in the project menu under Team members….

Duplicate Reminder

While you type a reply, Khatam quietly checks whether it's near-identical to a comment posted on the same markup in the last few minutes — including comments from other people in a live LocusSync session. If it finds one, a soft note appears below the box (e.g. "Similar to what John said 2 minutes ago"). It never blocks you — post anyway if it's genuinely different. It just helps avoid the "I didn't see someone already asked that" pile-up on busy threads.

Sorting a Busy Thread

Once a markup has several comments, a Recent / Relevant switch appears above the thread. Recent is the default chronological order. Relevant re-orders the comments by how closely each one relates to the markup's subject (a Khatam relevance score, shown per comment) — useful for finding the on-topic replies in a long back-and-forth. It is a lens only; it never changes the stored order or the chronological view.