On this page
#Keybindings
#Navigation
q: quit
h/l or Left/Right: previous/next file
j/k or Up/Down: down/up line
PgUp/PgDn: page scroll
Ctrl+u/Ctrl+d: half-page scroll
g: top
Shift+G: bottom
z: toggle content fullscreen
Shift+Z: center active line in viewport
R: refresh review and diff/root source
#Search and jump
:<line>: go to line
/<text>: search within the current file (rg, falling back to grep)
n/p: next/previous in-diff search match
Ctrl+g: open codebase search popup (rg, falling back to grep)
- Code search
type: update results live
- Code search
Enter: open selected file and line
- Code search
↑/↓, j/k, PgUp/PgDn, Home, End: move selected result
- Code search
Ctrl+a/Ctrl+e: move cursor to start/end of query
- Code search mouse: click a result to open that file and line
- Code search
Esc: close search
#Threads
m or c: create thread on selected line
v: start visual line selection for a range comment
Shift+V: clear visual line selection
- With visual line selection active, move with
j/k or arrows, then press m or c to open the comment box at the bottom of the selected range
r: reply to selected thread
N/P: next/previous thread
[/]: previous/next thread in current file
Ctrl+t: open global thread selector
- Thread selector
Enter: jump to selected thread and file
- Thread selector
type: filter by file, status, id, line, or body preview
- Thread selector
Ctrl+a/Ctrl+e: move cursor to start/end of filter query
- Thread selector
Esc or Ctrl+t: close selector
e: toggle selected thread expansion
Ctrl+e: toggle selected thread anchor context expansion (collapsed by default)
a: mark addressed
o: mark open
f: force-address selected thread
u: re-anchor selected thread to the currently selected diff line
- Type
@ in the comment or reply box to open the file reference picker.
↑/↓ or PgUp/PgDn: move through file matches
Enter or Tab: accept the selected file and enter line-picker mode
- While line-picker mode is active, Parley opens that file in the current diff pane and tells you to select a diff line in the editor itself.
↑/↓, j/k, PgUp/PgDn, g/Shift+G: move to the target diff line
Enter or Tab: insert @path:line for the currently selected line
- Mouse: click a diff line while line-picker mode is active to insert that line immediately
- After inserting the reference, Parley returns to the file and diff line where you started writing the draft.
Esc: cancel the picker; if the file is already inserted, it leaves the bare @path in place
Esc: close comment box
Ctrl+s: save comment or reply
Ctrl+p: toggle markdown preview in comment editor
- Arrow keys or
Ctrl+p/n/b/f: move cursor (up/down/left/right)
Home/End: move to start/end of line
Ctrl+a/Ctrl+e: move to start/end of line
Ctrl+k: kill to end of line
Enter: insert newline
Tab: insert 4 spaces
Backspace/Delete: delete character
Alt+b: move backward one whitespace-delimited word in the draft
Alt+d: delete forward through the next whitespace-delimited word in the draft
- Long comments wrap inside the editor, preserving whole words when possible
#Review state
s: set review state open
w: set review state under_review
x: AI refactor selected thread
X: AI reply selected thread
A: AI refactor review
i: cycle AI provider (codex, claude, opencode, pi)
I: toggle AI transport between ACP and CLI for providers that support both
K: cancel active AI run
H: toggle per-file AI logs popup
L: toggle global AI activity pane
- Starting an AI run opens/follows the current file's AI logs so provider startup errors and stream output are visible.
- AI activity
Enter: jump to the selected file/session logs
- AI activity
j/k, PgUp/PgDn, Home/End: select a session
- AI activity
Esc or L: close activity pane
- AI activity
O/o: open AI log in external pager
- AI progress popup
PgUp/PgDn: scroll AI stream
- AI progress popup
Home/End: jump to beginning/latest of AI stream
- AI progress popup
O/o: open AI log in external pager
?: open help docs
Ctrl+k: command palette
- Command palette
Ctrl+a/Ctrl+e: move cursor to start/end of query
- Command palette
Search Codebase: open live repository search
- Command palette
Show AI Activity: open the global AI session activity pane
- Command palette
Toggle AI Transport: switch between ACP and CLI for the active provider
- Command palette
Toggle Active File Group: collapse or expand the active file group
- Command palette
Collapse All File Groups: collapse every file group visible under the current filter
- Command palette
Open Commit Picker: open recent commits, filter by message or SHA, and apply the selected commit as the active diff source
- Command palette
Open Branch Picker: switch git branch from a filtered list
- Command palette
Open Review Picker: open reviews, filter by name or state, and apply the selected review as the active comment context
- Command palette
Open Thread Selector: search and jump across all review threads
- Command palette
Create Review: create a new review context and switch to it
M or command palette Show Git File Heatmap: scan full git history on demand and show file hotspots
- Heatmap
j/k or ↑/↓: scroll heatmap
- Heatmap
PgUp/PgDn: page scroll heatmap
- Heatmap
g/Shift+G or Home/End: jump to top/bottom
- Heatmap
s: cycle sort (churn, added, removed, commits, net-growth, net-shrink, volatility, path)
- Heatmap
Shift+S: reverse sort direction
- Heatmap
Esc or M: close heatmap
- Heatmap color follows the active sort metric
Ctrl+f: file filter input
Esc or Enter or Ctrl+f: exit file filter
Shift+F: cycle file filter mode
Shift+O: open file viewer
Shift+U: edit user name
t: open theme picker
T: toggle light/dark theme variant
Ctrl+v: toggle split view
- Command palette
Toggle Split View: toggle split view without using the visual-selection key
S: toggle side-by-side diff
Tab: switch active diff pane (when split view is enabled)
</>: resize files pane
Enter: collapse or expand the active file group
Shift+C: collapse all visible file groups
- Mouse: click a file group header to collapse or expand it
b: toggle thread navigator
Ctrl+b: open branch picker (switch git branch)
Ctrl+w: open worktree picker (switch git worktree)
Ctrl+o: open commit picker (apply a commit as the active diff source)
Ctrl+z: suspend Parley (run fg to resume)
Ctrl+t: open thread selector (also closes it when open)
#Root file rendering
D / Shift+d: toggle rendered document view in --root mode.
- Rendered document view is off by default; root mode opens files as raw source rows.
- With rendered document view enabled,
.json files are shown as pretty-printed JSON.
- With rendered document view enabled,
.md, .markdown, .mdown, and .mkd files are rendered as readable Markdown text rows.
R: refresh the root source if file content changed while Parley is open.
- Command palette
Toggle Root JSON/Markdown Rendering: same as D / Shift+d.
- Command palette search terms
json, markdown, pretty, or render surface the toggle.
#Help pane
Tab / Shift+Tab or h/l or Left/Right: switch help doc tab
1-9: direct tab select
j/k or ↑/Down: scroll help content
PgUp/PgDn: page scroll help content
g/Shift+G or Home/End: jump to top/bottom of help content
</>: zoom help pane
Esc or ?: close help pane
- Mouse scroll: scroll help content