Settings

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.

Look

Appearance

Theme, layout, accessibility and interface text.

Theme

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.	Any interface theme	Revue Dark
Interface theme for light windows	Sidebar, bars, menus and modals in light windows. Match takes its colours from your code theme.	Any interface 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

Layout

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

Accessibility

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

Interface text

Setting	What it does	Options	Default
Interface font	Any font installed on this Mac.	Any installed font	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 pt	13.5 pt
Interface line height		1× to 2.5×, in steps of 0.1×	1.6×

Code

How code looks: its font and its colours.

Code font

Setting	What it does	Options	Default
Code font	Monospaced fonts installed on this Mac come first.	Any installed font	System
Code weight		100 to 900, in steps of 100	400
Code size		10 pt to 18 pt, in steps of 0.5 pt	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

Custom themes

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.

Writing

Fonts for what you write: pull request titles, descriptions and comments, and spell checking.

Pull request title

Setting	What it does	Options	Default
Font	Used in the pull request title. Size follows Interface text size in Appearance.	Any installed font	System
Weight		100 to 900, in steps of 100	600
Line height		1× to 2.5×, in steps of 0.1×	1.4×

Descriptions and comments

Setting	What it does	Options	Default
Font	Used in pull request descriptions, comments and replies. Size follows Interface text size in Appearance.	Any installed font	System
Weight		100 to 900, in steps of 100	400
Line height		1× to 2.5×, in steps of 0.1×	1.6×

Spelling

Setting	What it does	Options	Default
Check spelling	Underline misspelled words in comments, descriptions, commit messages and pull request titles.	On or off	On

Review

Diff and review

How diffs look, viewed marks, comments and backports.

Display

Setting	What it does	Options	Default
Layout	The View menu and the top bar change these too.	Unified, Split	Unified
New and deleted files	Where split view draws a file that has only new or only old lines.	Full width, On their side	Full width
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

Viewed marks

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

Comments

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

Backports

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.	A list of owner/repo names	Not set
Label	A pull request with this label is checked when you open it. Used when Check backports against their source is on.	Any text	backport

Keyboard shortcuts

Click a shortcut, then press the new keys. Esc cancels.

Every key marked Yes on Keyboard shortcuts can be changed here. 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.

Notifications

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

Notify me when

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	On or off	On

Quiet hours

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

AI review

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.	A command	codex
Codex model	Used for reviews and pull request drafts. Models come from your Codex catalogue.	Any text	Not set
Ask AI model	Answers questions about selected lines. Leave empty to use the Codex model.	Any text	Not set
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	All
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.	Any text	sonnet
Verification model	The Claude model that checks whether each candidate is a real issue.	Any text	opus
Synthesis model	The Claude model that combines duplicate findings after verification and drafts pull request descriptions.	Any text	opus
Ask AI model	Answers questions about selected lines. Reviews keep their own models.	Any text	opus

Agent command

Setting	What it does	Options	Default
Claude executable	An executable name on PATH or an absolute path. Arguments are supplied by Revue.	A command	claude
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 s	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

Agent sources

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.

System

Accounts

Your GitHub account, live updates and the Git identity of the checkout you have open.

GitHub

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.

Git identity

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.

Live updates

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.

External editor

Where files open, and how new worktrees are set up.

Opening files

Setting	What it does	Options	Default
Editor	Automatic opens the first supported editor installed on your Mac.	Automatic, Zed, Visual Studio Code, VS Code Insiders, Cursor, VSCodium, GoLand, IntelliJ IDEA, WebStorm, PyCharm, CLion, RustRover, Sublime Text, Custom editor	Automatic
Editor executable	An executable path or command on PATH, without shell arguments. Leave blank to use the detected installation.	A command	Not set
Open with	Project and file opens the checkout as a project with the file in it. File only opens the file by itself.	Project and file, File only	Project and file

Worktree setup

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

Sync and stacks

How Revue reads your repositories, keeps pull requests up to date and shows stacks and new snapshots.

Repository

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.	Any text	Detect automatically

Pull request sync

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 s	60 s
Refresh when returning to Revue	Checks local changes and GitHub when the window comes to the front.	On or off	On

Stacks and snapshots

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

Terminal

Font, spacing, colours and keys for terminal panes. Import them from another terminal.

Font and spacing

Setting	What it does	Options	Default
Font	Used for letters, digits and punctuation.	Any installed font	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.	Any installed font	System
Size		6 pt to 72 pt, in steps of 0.5 pt	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 100%, in steps of 5%	0%

Cursor

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

Keys

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

Colours

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.	A colour	#dcdcdc
Background	A p3: prefix marks a Display P3 colour. Used when Terminal colours is Custom.	A colour	p3:#04080c
Bold colour	Leave blank to draw bold text in its own colour. Used when Terminal colours is Custom.	A colour	#ffffff
Cursor	Used when Terminal colours is Custom.	A colour	#ffffff
Selection	Used when Terminal colours is Custom.	A colour	#b3d7ff
ANSI colours	The 16 colours, black to bright white, separated by commas. Used when Terminal colours is Custom.	A list of colours	#14191e,#b43c2a,#00c200,#c7c400,#2744c7,#c040be,#00c5c7,#c7c7c7,#686868,#dd7975,#58e790,#ece100,#a7abf2,#e17ee1,#60fdff,#ffffff

Colours in light windows

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.	A colour	Not set
Background	A p3: prefix marks a Display P3 colour. Used when Terminal colours is Custom.	A colour	Not set
Bold colour	Leave blank to draw bold text in its own colour. Used when Terminal colours is Custom.	A colour	Not set
Cursor	Used when Terminal colours is Custom.	A colour	Not set
Selection	Used when Terminal colours is Custom.	A colour	Not set
ANSI colours	The 16 colours, black to bright white, separated by commas. Used when Terminal colours is Custom.	A list of colours	Not set

Claude Code

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.	A command	claude
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

Updates

Your version, when Revue checks for and installs new ones, and the usage and crash reports it sends.

Release

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.

Privacy

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.

Storage

How much space Revue uses on this Mac, what it keeps, and for how long.

Keeping

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 MB, 512 MB, 1000 MB, 2000 MB, 4000 MB, 8000 MB	512 MB
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 MB, 2000 MB, 5000 MB, 10000 MB, 20000 MB	2000 MB
CI logs limit	Past this, the logs read longest ago are removed first.	64 MB, 128 MB, 256 MB, 512 MB, 1000 MB	256 MB
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

Advanced

Logs and moving your settings to another Mac.

Diagnostics

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

Your settings

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

Hints and tour

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