revue_show
Open a file in Revue, scroll to a specific line or range to point at code, or show its diff, rendered Markdown, SVG, or Mermaid diagram for review.
Instructions
Show the user a file in revue, optionally scrolled to a line or line range. Use this to point at specific code: "look at server.js lines 120-140". With a line it defaults to the whole-file view; without one, to the diff. view "preview" shows a markdown file rendered (with its mermaid diagrams drawn), an SVG drawn as an image, or a mermaid file's diagram. In a plain folder (not a git repo) it is the file or its preview.
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>"
},
"name": "revue_show"
}
}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 | No | Line to scroll to and highlight. Not with view preview, which has no line numbers. | |
| 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. | |
| side | No | Which version: new (after the change, default) or old (before it). Line numbers refer to this side. | |
| view | No | Whole file, the diff, or the preview: the rendered markdown of a .md or .markdown file, an .svg file drawn as an image, or the diagram of a .mmd or .mermaid file (only for those files, and without line). Default: file if line is given, else diff. | |
| newTab | No | Open a new browser tab even if a revue tab is already open. | |
| endLine | No | Last line of a range starting at line. | |
| 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. |