Comments

Select code and press ⌘K to leave a comment. Comments support Markdown and code blocks.

​

Pending and immediate comments

Add To Review keeps a comment pending until you submit your review. Comment Immediately posts it right away. ⌘↵ saves using the selected mode. The Comments sidebar lists all threads. Thread resolution is shared with GitHub, so resolving a thread in either place resolves it in both.

​

Suggestions

Select lines and press ⌘I to suggest a replacement the author can apply directly. Assert also suggests comments during review. Press A to add one to your pending comments, then edit it before submitting.

​

Finish your review

Open Finish review in the header, or Review if you have no pending comments. Add a summary, choose Comment, Approve, or Request changes, and select Submit Review. Your pending comments and verdict are posted to GitHub together. Marking code reviewed with R only tracks your own progress; it doesn’t submit anything.

​

Outdated comments

If new commits move code that a pending comment is attached to, use the outdated-comments action in the header to move your comments onto the latest commit. If Assert can’t place a comment confidently, you can choose where it goes.

​

Sending comments to an agent

Select the threads you want addressed and send them to Cursor or Devin. When the agent pushes a fix, re-review the changes. See the keyboard reference for more comment shortcuts.