Open Settings with Revue › Settings (⌘,). Its sidebar groups the pages as Look, Review and
System, in the order below, and the search field at its top finds any setting by name. Changes aren’t kept until
you choose Save (⌘S), and Revert puts back what you had.
Each page below has a table of its settings, what they do, their options and the default. Pages Revue draws itself,
such as Updates and Live updates, are described in words. To move your settings to another Mac or reset them, see
Export and import settings.
Theme, layout, accessibility and interface text.
| Setting |
What it does |
Options |
Default |
| Mode |
System follows your Mac and switches between your dark and light themes. |
Light, Dark, System |
System |
| Interface theme |
Sidebar, bars, menus and modals in dark windows. Match takes its colours from your code theme. |
|
Revue Dark |
| Interface theme for light windows |
Sidebar, bars, menus and modals in light windows. Match takes its colours from your code theme. |
|
Revue Light |
| Use theme accent |
Use the accent colour a theme brings instead of the Accent setting. |
On or off |
On |
| Accent |
Highlights your selection and unread changes. |
Blue, Coral, Amber, Green, Violet |
Blue |
| Setting |
What it does |
Options |
Default |
| Density |
Row spacing in the file tree and stack. |
Compact, Comfortable, Spacious |
Comfortable |
| Interface zoom |
|
80% to 140%, in steps of 5 |
100% |
| Sidebar position |
|
Left, Right |
Left |
| Focused pane |
How a split window marks the pane that has focus. |
Dim other panes, Outline, none |
Dim other panes |
| Setting |
What it does |
Options |
Default |
| Reduce motion |
Turns off animations in bars, menus and controls. Your Mac’s setting is also respected. |
On or off |
Off |
| Increase contrast |
Use the high-contrast interface theme. Your Mac’s setting is also respected. |
On or off |
Off |
| Setting |
What it does |
Options |
Default |
| Interface font |
Any font installed on this Mac. |
|
System |
| Interface text weight |
Base weight for interface text. Headings and emphasised controls keep their hierarchy. |
100 to 900, in steps of 100 |
400 |
| Interface text size |
Size of body text. Every other interface text size moves with it. Code keeps its own size. |
13 pt to 16 pt, in steps of 0.5 |
13.5 pt |
| Interface line height |
|
1× to 2.5×, in steps of 0.1 |
1.6× |
How code looks: its font and its colours.
| Setting |
What it does |
Options |
Default |
| Code font |
Monospaced fonts installed on this Mac come first. |
|
System |
| Code weight |
|
100 to 900, in steps of 100 |
400 |
| Code size |
|
10 pt to 18 pt, in steps of 0.5 |
13 pt |
| Line height |
|
1.2× to 2×, in steps of 0.05 |
1.7× |
| Font ligatures |
|
On or off |
On |
| Thin strokes |
Draw code without font smoothing. The terminal follows this too. |
Never, Retina only, Always |
Retina only |
| Syntax italics |
Allow your code theme to italicise comments and other tokens. |
On or off |
On |
Import themes from VS Code, JetBrains IDEs, Zed, Sublime Text and TextMate, or start from a built-in one and change any colour.
Custom themes lists the themes you’ve imported or made. Import brings in a theme from another app, and Customise
current theme or New from starts one from a theme you have. Each colour can then be changed: background, text, line
numbers, links, added and removed lines, hunk headers, search matches and selection.
Fonts for what you write: pull request titles, descriptions and comments, and spell checking.
| Setting |
What it does |
Options |
Default |
| Font |
Used in the pull request title. Size follows Interface text size in Appearance. |
|
System |
| Weight |
|
100 to 900, in steps of 100 |
600 |
| Line height |
|
1× to 2.5×, in steps of 0.1 |
1.4× |
| Setting |
What it does |
Options |
Default |
| Font |
Used in pull request descriptions, comments and replies. Size follows Interface text size in Appearance. |
|
System |
| Weight |
|
100 to 900, in steps of 100 |
400 |
| Line height |
|
1× to 2.5×, in steps of 0.1 |
1.6× |
| Setting |
What it does |
Options |
Default |
| Check spelling |
Underline misspelled words in comments, descriptions, commit messages and pull request titles. |
On or off |
On |
How diffs look, viewed marks, comments and backports.
| Setting |
What it does |
Options |
Default |
| Layout |
The View menu and the top bar change these too. |
Unified, Split |
Unified |
| Wrap lines |
|
On or off |
On |
| Whitespace |
|
Show all, Ignore trailing, Ignore all whitespace, Ignore blank lines |
Show all |
| Context lines |
Unchanged lines shown around each hunk. |
0 to 10, in steps of 1 |
3 |
| Word highlights |
Emphasise the changed tokens inside a changed line. |
On or off |
On |
| Collapse unchanged |
When off, the whole file shows around the changes. |
On or off |
On |
| Line numbers |
|
On or off |
On |
| Tab width |
Spaces per tab. |
2 to 8, in steps of 2 |
4 |
| Setting |
What it does |
Options |
Default |
| Mark viewed on scroll |
Mark a file after you reach its end. Working-copy files are never marked. |
On or off |
Off |
| Carry viewed marks across snapshots |
Keep the check when the file is unchanged in the new snapshot. |
On or off |
On |
| Setting |
What it does |
Options |
Default |
| Load images in comments |
Draw screenshots and badges in pull request comments and your own comments. Agent findings and Ask AI answers never load images. |
On or off |
On |
| Resolved comments |
Collapse folds a resolved thread to one row at its line. Hide leaves it out of the diff, and the comment list still lists it. |
Show, Collapse, Hide |
Collapse |
| Setting |
What it does |
Options |
Default |
| Check backports against their source |
Compare a labelled pull request with the pull requests it was backported from. |
On or off |
On |
| Repositories |
Pull requests in these repositories are checked. Used when Check backports against their source is on. |
|
gravitational/core |
| Label |
A pull request with this label is checked when you open it. Used when Check backports against their source is on. |
|
backport |
Click a shortcut, then press the new keys. Esc cancels.
Every key marked Yes on Keyboard shortcuts can be changed here. Click a shortcut,
then press the new keys. Each changed shortcut has its own Reset, and Restore default shortcuts resets them all.
| Setting |
What it does |
| Show or hide Revue |
A global shortcut that works from any app. Press it again to hide Revue. New installs have none set. |
What reaches you, and how loudly.
| Setting |
What it does |
Options |
Default |
| Desktop notifications |
Shown while Revue is in the background. Badges in Revue keep updating when this is off. |
On or off |
Off |
| Notification sound |
Plays with each desktop notification. |
On or off |
Off |
| Setting |
What it does |
Options |
Default |
| AI review finished |
An AI review you started or are following finishes. |
On or off |
On |
| Checks finished |
Checks on a pull request you have open go from running to done. |
On or off |
On |
| New reviews |
Someone approves, requests changes on or reviews a pull request you opened. |
On or off |
On |
| New comments |
New threads and replies on a pull request you have open, at most once a minute. |
On or off |
On |
| Agent results |
An agent source finishes reviewing a pull request you opened or were asked to review. |
On or off |
On |
| Comments addressed |
Claude or Codex addresses comments you sent from this checkout. |
On or off |
On |
| New snapshot |
A new snapshot arrives on the layer you are reading. Needs new snapshots set to Notify in Sync and stacks. {Open Sync and stacks}(sync/snapshotArrival) |
On or off |
On |
| Setting |
What it does |
Options |
Default |
| Use quiet hours |
Mutes desktop notifications and sounds between these times, in your Mac’s time zone. Badges keep updating. |
On or off |
Off |
| Starts |
|
A time of day |
22:00 |
| Ends |
|
A time of day |
08:00 |
Choose an installed agent for code questions, reviews and pull request drafts.
| Setting |
What it does |
Options |
Default |
| AI provider |
Uses the Claude Code or Codex CLI installed on your Mac, signed in with its own account. |
Claude Code, Codex |
Claude Code |
| Codex executable |
An executable name on PATH or an absolute path. Arguments are supplied by Revue. |
|
Codex |
| Codex model |
Used for reviews and pull request drafts. Models come from your Codex catalogue. |
|
None |
| Ask AI model |
Answers questions about selected lines. Leave empty to use the Codex model. |
|
None |
| Enable AI |
Allow reviews, local code questions and pull request drafts. Turning this off leaves existing results and running requests intact. |
On or off |
On |
| Sensitivity |
Quiet asks for consequential, high-confidence bugs. Thorough also investigates edge cases and uncertain defects. |
Quiet, Balanced, Thorough |
Balanced |
| Focus areas |
Choose which specialist reviewers run. Keep at least one selected. |
Correctness, Error handling, Security, Performance, Tests, Reuse |
Correctness, Error handling, Security, Performance, Tests, Reuse |
| Show findings inline |
When off, group findings under each file’s header. |
On or off |
On |
| Review new snapshots automatically |
Start a local review with the selected AI provider when a new recorded snapshot arrives on the layer you have open. |
On or off |
Off |
| Finding model |
The Claude model the specialist reviewers use. |
|
sonnet |
| Verification model |
The Claude model that checks whether each candidate is a real issue. |
|
opus |
| Synthesis model |
The Claude model that combines duplicate findings after verification and drafts pull request descriptions. |
|
opus |
| Ask AI model |
Answers questions about selected lines. Reviews keep their own models. |
|
opus |
| Setting |
What it does |
Options |
Default |
| Claude executable |
An executable name on PATH or an absolute path. Arguments are supplied by Revue. |
|
Claude Code |
| Per-turn timeout |
How long one agent call may run before Revue stops it and counts it as failed. |
15 s to 1800 s, in steps of 15 |
180 s |
| Concurrent review turns |
How many reviewer calls run at the same time during one review. |
1 to 16, in steps of 1 |
8 |
Review agents on servers that speak Revue’s agent review protocol. Their findings, comment triage and fixes for GitHub pull requests show beside Revue’s own.
| Setting |
What it does |
| Sources |
The agent sources Revue reads. Add source adds one, and each source can be edited or removed. |
| Report local work |
Optional, per source. Reports your unmerged branches in the repositories you allow. See Privacy. |
Your GitHub account, live updates and the Git identity of the checkout you have open.
| Setting |
What it does |
| Your account |
The GitHub account Revue uses, with Open profile and Check again. Shows how to sign in when you aren’t. |
| Live updates |
Opens Live updates. |
For the checkout you have open and its worktrees. Only the fields you edit are written to that repository’s Git
config, and blank author fields use your global Git identity.
| Setting |
What it does |
| Author name |
The name on commits you make in Revue. |
| Author email |
The email on commits you make in Revue. |
| Signing key |
The key commits are signed with. |
| Commit signing |
Whether commits are signed, and how. |
How Revue keeps notifications, pull requests and checks up to date. Pull request sync runs as Sync and stacks sets it. Live updates are optional and make changes appear instantly.
| Setting |
What it does |
| Pull request sync |
Checks GitHub for changes to the pull requests Revue tracks, as often as Sync and stacks sets. |
| Live updates |
Off by default. Reads your GitHub sign-in from a browser so changes appear as they happen. See Turn on live updates. |
| Browser |
The browser whose GitHub sign-in live updates read. Automatic reads your default browser. |
| Live job logs |
Included with live updates: a CI log tab shows a running job’s lines as the job writes them. |
Where files open, and how new worktrees are set up.
| Setting |
What it does |
Options |
Default |
| Editor |
Automatic opens the first supported editor installed on your Mac. |
Auto, zed, code, code-insiders, cursor, codium, goland, idea, webstorm, pycharm, clion, rustrover, sublime, Custom |
Auto |
| Editor executable |
An executable path or command on PATH, without shell arguments. Leave blank to use the detected installation. |
|
None |
| Open with |
Project and file opens the checkout as a project with the file in it. File only opens the file by itself. |
project, file |
project |
These rows apply to the repository of the local checkout Revue has open. With no checkout open, the section says
“No local checkout open”.
| Setting |
What it does |
Default |
| Prepare new worktrees |
When Revue creates a worktree to open a stack layer, set it up in the background for this repository. |
On |
| Install command |
auto runs pnpm install --frozen-lockfile --prefer-offline when pnpm-lock.yaml is present. Leave blank to skip. Arguments are split on spaces and never run through a shell. |
auto |
| Paths to clone from this checkout |
Ignored paths such as build outputs, separated by commas. Copied as APFS clones, so they use almost no disk. Existing files are never replaced. |
None |
How Revue reads your repositories, keeps pull requests up to date and shows stacks and new snapshots.
| Setting |
What it does |
Options |
Default |
| Backend |
Auto uses jj when it is installed and falls back to Git. Takes effect when Revue restarts. |
Auto, Git, jj |
Auto |
| Default trunk branch |
A local branch name such as main. Leave blank to detect it. Stacks with their own parent branch keep it. |
|
None |
| Setting |
What it does |
Options |
Default |
| Sync tracked pull requests |
Fetches GitHub updates for pull requests Revue tracks. Watching local checkouts carries on either way. |
On or off |
On |
| Sync interval |
How often tracked pull requests are fetched from GitHub. |
30 s to 900 s, in steps of 30 |
60 s |
| Refresh when returning to Revue |
Checks local changes and GitHub when the window comes to the front. |
On or off |
On |
| Setting |
What it does |
Options |
Default |
| Show stack sidebar |
Display the surrounding stack above the file tree. |
On or off |
On |
| Quiet rebase-only snapshots |
Snapshots that only rebase show as a hatched segment in the timeline, not a numbered chapter. |
On or off |
On |
| When a new snapshot arrives |
You stay on the snapshot you are reading. Notify also posts a notice, Badge only marks the new snapshot in the bar, Silent marks nothing. |
Notify, Badge only, Silent |
Badge only |
Font, spacing, colours and keys for terminal panes. Import them from another terminal.
| Setting |
What it does |
Options |
Default |
| Font |
Used for letters, digits and punctuation. |
|
System |
| Weight |
|
100 to 900, in steps of 100 |
500 |
| Non-ASCII font |
Used for everything from U+0080, such as box drawing, Nerd Font icons and CJK. |
|
System |
| Size |
|
6 pt to 72 pt, in steps of 0.5 |
14 pt |
| Column spacing |
Cell width as a multiple of the font’s character width, measured as iTerm2 does. |
0.5× to 2×, in steps of 0.01 |
0.88× |
| Line spacing |
|
0.5× to 2.5×, in steps of 0.01 |
1.1× |
| Thin strokes |
Draw text without font smoothing. Code in diffs follows this too. Retina only matches iTerm2’s default. |
Never, Retina only, Always |
Retina only |
| Minimum contrast |
Moves text colours away from their background until they differ by at least this much. 0% leaves them as they are. |
0% to 1%, in steps of 0.05 |
0% |
| Setting |
What it does |
Options |
Default |
| Shape |
Programs can still choose their own, as editors do in insert mode. |
Block, Bar, Underline |
Block |
| Blink |
While the terminal has focus. Reduce motion keeps it still. |
On or off |
Off |
| Setting |
What it does |
Options |
Default |
| Option key as Meta |
A chosen Option key sends Esc+ for shell shortcuts. An Option key not chosen types characters such as accents. |
Left, Right, Both, Neither |
Left |
| Setting |
What it does |
Options |
Default |
| Terminal colours |
Match uses your code theme’s colours, so the terminal turns light and dark with the diff. Choose Custom to set your own below. |
Match code theme, Custom |
Match code theme |
| Foreground |
Used when Terminal colours is Custom. |
|
#dcdcdc |
| Background |
A p3: prefix marks a Display P3 colour. Used when Terminal colours is Custom. |
|
p3:#04080c |
| Bold colour |
Leave blank to draw bold text in its own colour. Used when Terminal colours is Custom. |
|
#ffffff |
| Cursor |
Used when Terminal colours is Custom. |
|
#ffffff |
| Selection |
Used when Terminal colours is Custom. |
|
#b3d7ff |
| ANSI colours |
The 16 colours, black to bright white, separated by commas. Used when Terminal colours is Custom. |
|
#14191e,#b43c2a,#00c200,#c7c400,#2744c7,#c040be,#00c5c7,#c7c7c7,#686868,#dd7975,#58e790,#ece100,#a7abf2,#e17ee1,#60fdff,#ffffff |
| Setting |
What it does |
Options |
Default |
| Foreground |
Light windows use these and dark windows the colours above. Importing a single theme replaces both. Used when Terminal colours is Custom. |
|
None |
| Background |
A p3: prefix marks a Display P3 colour. Used when Terminal colours is Custom. |
|
None |
| Bold colour |
Leave blank to draw bold text in its own colour. Used when Terminal colours is Custom. |
|
None |
| Cursor |
Used when Terminal colours is Custom. |
|
None |
| Selection |
Used when Terminal colours is Custom. |
|
None |
| ANSI colours |
The 16 colours, black to bright white, separated by commas. Used when Terminal colours is Custom. |
|
None |
| Setting |
What it does |
Options |
Default |
| Claude Code command |
What Start Claude Code runs in a new terminal. Claude Code started any other way in a Revue terminal also connects. |
|
Claude Code |
| Share selections with Claude Code |
Lines you select in a diff go with your next prompt to Claude Code in a terminal on that checkout. |
On or off |
On |
| Review Claude’s edits |
Claude Code asks before each edit, even in auto mode, and the edit opens here to accept or reject. Only for sessions Revue starts. |
On or off |
Off |
Your version, when Revue checks for and installs new ones, and the usage and crash reports it sends.
| Setting |
What it does |
| Check for updates |
A button that asks updates.ryc.sh for a newer version now. |
| Check for updates automatically |
Checks in the background, at the interval below. |
| How often to check |
Every hour, Every 6 hours, Every day or Every week. |
| Download and install updates automatically |
New versions download in the background and install the next time Revue quits. Needs automatic checks. |
| Setting |
What it does |
| Share usage statistics |
Sends counts of the features you use to usage.ryc.sh. See Privacy. |
| Send error and crash reports |
Sends errors and crashes, by error code, to usage.ryc.sh. |
| What Revue sends |
Shows everything Revue sends, field by field. |
| Install ID |
The random ID reports carry. Reset ID makes a new one. |
How much space Revue uses on this Mac, what it keeps, and for how long.
| Setting |
What it does |
Options |
Default |
| Diff cache limit |
Past this, the diffs read longest ago are removed first. Checked shortly after Revue opens and every six hours. Reviews and viewed marks are kept. |
256, 512, 1000, 2000, 4000, 8000 |
512 |
| Keep checkouts for |
A checkout whose pull request you haven’t opened for this long is removed. So is one whose pull request merged or closed. |
7 days, 14 days, 30 days, 90 days |
14 days |
| Checkouts limit |
Past this, the checkouts viewed longest ago are removed first. One in use is never removed. |
1000, 2000, 5000, 10000, 20000 |
2000 |
| CI logs limit |
Past this, the logs read longest ago are removed first. |
64, 128, 256, 512, 1000 |
256 |
| Remove unused mirrors |
Removes a repository’s mirror once no pull request of it has been opened for this long, unless a tab has one open. Earlier snapshots of its pull requests may not open again. |
Never, After 90 days, After 180 days, After a year |
Never |
Logs and moving your settings to another Mac.
| Setting |
What it does |
Options |
Default |
| Log level |
How much Revue writes to its log. Takes effect the next time Revue opens. |
Errors only, Warnings, Info, Debug, Trace |
Info |
| Setting |
What it does |
Options |
Default |
| Export settings |
Saves a settings.json file you can import on another Mac. GitHub credentials and Git identity are left out. |
A button |
|
| Import settings |
Reads a settings.json export and stages its values. Nothing changes until you save. |
A button |
|
| Reset all settings |
Restores every default. Accounts, reviews and viewed marks are kept. |
A button |
|
| Setting |
What it does |
Options |
Default |
| Show hints |
A short hint the first time something matters. At most two a session. |
On or off |
On |
| Tour progress |
Where you are in each part of the tour. |
A button |
|