Skip to content

Keyboard Shortcuts

Every keyboard shortcut in Chronicle, grouped by where it applies.

Chronicle is keyboard-first: you can open a session, move through the timeline, and distill a transcript without touching the mouse. Shortcuts are registered per context, so the same key can mean different things in Playback versus Refine. Below, is the macOS Command key — on Windows and Linux (source builds) it maps to Ctrl everywhere, since every handler listens for metaKey || ctrlKey.

Global

Available from anywhere in the app.

ShortcutAction
⌘KOpen the command palette (global search across sessions)

Session view

Active whenever a session is open. These switch modes and drive the search filter.

ShortcutAction
⌘FFocus the in-session search box
⌘1Overview mode
⌘2Playback mode
⌘3Refine mode
⌘4Replay mode
⇧⌘USync (re-import) this session
EscClear the search filter and unfocus the search box

Playback

Available while the code panel is showing a snapshot in Playback mode.

ShortcutAction
DToggle diff view for the selected file (ignored while typing in a field)

The D toggle is suppressed when focus is in an input or textarea, so typing a filename filter never flips the view.

Timeline

Active when the timeline slider is focused (click it first). The timeline seeks the whole session to a point in time.

ShortcutAction
/ Nudge the playhead by 1%
HomeJump to the start of the session
EndJump to the end of the session
Click / dragSeek to the pointer position

Refine

Active in Refine mode, where you distill a transcript down to a shareable core by keeping, deleting, editing, and inserting messages.

ShortcutAction
KKeep the selected message and advance to the next
DDelete (strike) the selected message and advance to the next
EEdit the selected message inline
IInsert a note after the selected message
/ jMove the selection down
Move the selection up (⇧K also moves up)
⌘ZUndo
⇧⌘ZRedo
⌘SExport the refined transcript
EscCancel the current inline edit

Note: K on its own keeps a message, so it is not the vim "up" key here — use (or ⇧K) to move up and j / to move down.

Command palette

Active while the ⌘K palette is open.

ShortcutAction
/ Move through results
EnterOpen the highlighted result
EscClose the palette
  • Time Travel — Playback mode, snapshots, diff, and the timeline these shortcuts drive.
  • Refine Mode — the Keep / Delete / Edit / Insert workflow the Refine shortcuts belong to.

Released under the MIT License.