revue_annotate
Leave an inline note on a code line or line range in the Revue diff and file view to explain a change, flag something for review, or ask a question about specific code.
Instructions
Leave a note on a line or line range, shown inline in revue under those lines (in the diff and the file view), and show it to the user. Use it to explain a change, flag something to review, or ask a question about specific code. Notes belong to the current view (mode/ref/base/head) and are marked outdated if the lines change later.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>",
"line": "<line>",
"text": "<text>"
},
"name": "revue_annotate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| git | No | false opens the folder as a plain folder (its files only, including .git) even inside a git repo, like revue --no-git. Default true. | |
| ref | No | Commit to show in commit mode (default HEAD). | |
| base | No | Base branch in branch mode (default: main, master, origin/main, origin/master or develop, whichever exists). | |
| head | No | Branch to view in commit/branch mode without checking it out (default: the checked-out branch). | |
| line | Yes | First line the note is about. | |
| mode | No | working = uncommitted changes vs HEAD (default); commit = one commit vs its parent; branch = head vs its merge-base with base, like a PR. | |
| path | Yes | File path relative to the repo root. | |
| repo | No | Any folder inside the git repo. Defaults to the current working directory. A folder outside any repo opens as a plain folder: its files only, with no changes, history or modes. | |
| show | No | Also move the browser to the note (default true). Set false when leaving several notes, then call revue_show or revue_open once. | |
| side | No | new (after the change, default) or old (before it, e.g. for deleted lines). Line numbers refer to this side. | |
| text | Yes | The note. Plain text; newlines are kept. | |
| author | No | Shown on the note. Defaults to the MCP client's name. | |
| newTab | No | Open a new browser tab even if a revue tab is already open. | |
| endLine | No | Last line, for a range. | |
| persist | No | If a server has to be started: true keeps it running after this agent session ends, false stops it with the session. Defaults to the --lifetime setting. |