> ## Documentation Index
> Fetch the complete documentation index at: https://docs.assert.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Comments

> Leaving comments and suggestions, and reviewing alongside your team

Select the lines you want to talk about and press <kbd>⌘</kbd><kbd>K</kbd>. Comments
take markdown, including fenced code blocks.

| Action                            | Shortcut                                                                    |
| :-------------------------------- | :-------------------------------------------------------------------------- |
| Add comment                       | <kbd>⌘</kbd><kbd>K</kbd>                                                    |
| Add suggestion                    | <kbd>⌘</kbd><kbd>I</kbd>                                                    |
| Save                              | <kbd>⌘</kbd><kbd>↵</kbd>                                                    |
| Cancel                            | <kbd>esc</kbd>                                                              |
| Delete                            | <kbd>⌫</kbd>                                                                |
| Widen / narrow the anchored range | <kbd>⌃</kbd><kbd>⌥</kbd><kbd>←</kbd> / <kbd>⌃</kbd><kbd>⌥</kbd><kbd>→</kbd> |
| Next / previous comment           | <kbd>]</kbd> → <kbd>C</kbd> / <kbd>\[</kbd> → <kbd>C</kbd>                  |

The comments panel in the left sidebar lists every thread on the pull request with
counts and resolve controls. Resolution state is shared with GitHub.

## Suggestions

Press <kbd>⌘</kbd><kbd>I</kbd> to attach a concrete edit to a comment. You get an
editor seeded with the selected lines, and the author can take your replacement
directly.

## Assert's suggested comments

Assert proposes review comments of its own. Press <kbd>A</kbd> to accept one and it
becomes a pending comment of yours, which you can edit before submitting. Accepting
adds a comment; it does not touch the code.

## Rebasing comments

Agents rewrite history constantly, so a comment you drafted against one commit can
end up pointing at code that has moved. When that happens, Assert flags it in the
header with a count of outdated comments.

Click the flag to rebase them onto the latest commit. Assert reports anything it could
not place cleanly as a conflicting comment, and you choose where those land.

## Reviewing with your team

Avatars in the header show who else is in the review. Check them before you start and
you will not duplicate a teammate's pass. You can also request reviewers from Assert,
and the request lands on GitHub.

## Sending comments to an agent

Select the threads you want acted on and send them to Claude, Cursor, or Devin. See
[Agents](/integrations/agents).
