Settings and keyboard
Settings open with Ctrl+, (Cmd+, on macOS), from the cog menu or from the F1 palette. The page is two panes: a pinned search box and scope switch on top, a category list down the left that highlights the section you are reading, and the settings themselves, each with its description, its options and its default.
Two scopes
- Global applies everywhere.
- Workspace applies to the directory you have open and wins over Global.
A connection's group and the connection itself can override many of them further (the guards, the Session parameters, the snapshot and statistics choices), resolved connection over group over workspace over global.
settings.json
Every scope is a JSONC file, and the global one is written on first run as a documented template: every setting sits commented out at its default under a comment header with its description and options, so the file documents everything without overriding anything until you uncomment a line. Edit in settings.json opens the scope's file in PlumeSQL's own editor; saving applies the edits at once. A file that will not parse, or one carrying a value that is not allowed, is reported in the Log with a button back to the file.
Workspace settings live beside the session in the global directory by default; a committed <workspace>/.plumesql/settings.json always wins. See The workspace.
Search and deep links
The search box filters every setting by key, label and description. Menus that link into settings ("Explorer Settings", "Editor Settings", a result's dots menu) open the page focused: only the asked-for section shows, a strip says so with Show all one click away, and typing in the search leaves the mode. A plain open always shows everything.
VS Code is the keymap
PlumeSQL's users come from VS Code, so wherever VS Code has a default shortcut for something PlumeSQL also does, PlumeSQL uses VS Code's combo, per platform (Cmd on macOS, Ctrl elsewhere). Shortcuts match the physical key on non-Latin layouts.
| Do | Combo (macOS) |
|---|---|
| Command palette | F1 |
| Go to Tab or File | Ctrl+P (Cmd+P) |
| Go to Object | Ctrl+Shift+O (Cmd+Shift+O) |
| Search in Files, Replace | Ctrl+Shift+F, Ctrl+Shift+H (Cmd+...) |
| Connections, Objects, Explorer, Outline | Ctrl+Shift+C, Ctrl+Shift+D, Ctrl+Shift+E, Ctrl+Shift+X (Cmd+...) |
| Cycle side panels | Ctrl+Q |
| Toggle bottom panel, Problems, Log | Ctrl+J, Ctrl+Shift+M, Ctrl+Shift+U (Cmd+...) |
| Terminal | Ctrl+` |
| Format file, format selection | Shift+Alt+F, Ctrl+K Ctrl+F |
| Lightbulb | Ctrl+. (Cmd+.) |
| Go to Definition, references, rename | F12, Shift+F12, F2 |
| Next message | F8 |
| Word wrap, inlay hints | Alt+Z, Alt+I |
| Go Back, Go Forward | Alt+Left or Ctrl+Alt+-, and the Forward pairs (Ctrl+-, Ctrl+Shift+-) |
| Settings | Ctrl+, (Cmd+,) |
| Keyboard Shortcuts cheatsheet | Ctrl+K Ctrl+S (Cmd+K Cmd+S) |
The exceptions
Each deviation from VS Code has a reason, recorded beside its setting:
Ctrl+EnterandF5run the query. A SQL client convention older and stronger than VS Code's bindings.Ctrl+Enter(Cmd+Enter) first selects the statement under the cursor, then runs it;F5is the rebindable one (run.keybinding).F6cycles the panes. One Tab stop per widget, arrows move inside it,F6andShift+F6step from pane to pane, and the focused pane shows a visible edge.Enteropens a tree row on every platform. VS Code renames with Enter on macOS; PlumeSQL's trees preview and open, so rename isF2everywhere.- Browser-reserved combos keep the VS Code binding in the desktop app and carry a documented fallback in the browser; an extension's Back and Forward are
Alt+-andAlt+Shift+-(Alt+Cmd+-,Alt+Shift+Cmd+-on macOS) for that reason.
The cheatsheet and rebinding
Ctrl+K Ctrl+S opens the Keyboard Shortcuts cheatsheet with every combo, and every shortcut also appears in its control's tooltip and in the palette. Every binding is a setting under Settings > Keyboard (keyboard.*), rebindable to one combo or several separated by a comma, with the description saying which VS Code command it mirrors.
Zoom and theme
In the desktop app Ctrl+= zooms the whole app in, Ctrl+- out and Ctrl+Numpad0 resets, VS Code's keys (Cmd on macOS), with the level kept in window.zoom. In a browser the browser's own zoom applies. theme switches between dark and light, and both themes cover every surface.