Settings

Open Settings with ⌘ , (Ctrl Alt S on Windows and Linux), or the gear in the title bar. Settings replaces the workspace while it's open; Esc or ⌘ W closes it.

Use Search settings at the top of the sidebar to find an option by name. Every page has a Reset to defaults link. Changes apply immediately; there is no Save button.

#Appearance & Behavior

#Appearance

Links on this page: Open settings.json, Open themes folder and Customize current theme.

#Color Scheme

• Scheme: the colours of SQL syntax, with a live preview. Theme's own follows the theme.
• Dark theme colours and Light theme colours: override the colour of each kind of SQL token (keywords, strings, numbers, comments…).
• Environments: the badge colours for Local, Development, Staging and Production. See Safety & environments.

#Startup & Layout

The Tool stripe section shows, hides and reorders the buttons on the far left.

#Keymap

• Preset: TableGrip, DataGrip / IntelliJ, or VS Code.
• A searchable table of every action ("Search actions or keys") where you can change a shortcut, see clashes, and reset one action at a time.

See Keyboard shortcuts.

#Updates

The page also has Check for Updates, the current version and What's new. See Updates.

#Editor

#SQL Editor

#Database

#Query Execution

#Drivers

• Downloading drivers: Ask every time (default), or Automatic for permissive licenses.
• Maven repository: leave empty for Maven Central, or enter your mirror.
• Lists of Installed and Available drivers.

See Drivers.

#Tools

The pg_dump, pg_restore, psql, mysqldump and mysql copies TableGrip found, and which one each connection uses. You can choose one by hand, and download or remove the PostgreSQL client tools. See Backup & restore.

#Backups

Turn scheduled backups on and manage the schedules. See Backup & restore → Scheduled backups.

#Data Editor

#Tools

#Agent

See AI agent and What the agent can see.

#settings.json

Everything above is stored in ~/.tablegrip/settings.json. Open settings.json on the Appearance page opens it in your editor.

• Only values that differ from the defaults are written, so the file stays short.
• Comments and trailing commas are allowed.
• The file is watched: save it in your editor and the app updates while it runs.
• If the file has a syntax error, TableGrip uses the defaults, shows the error at the top of Settings, and won't overwrite the file until you fix it.

{
  // Follow the OS, but use Dracula at night
  "theme": { "mode": "System", "dark": "Dracula" },
  "zoom": 110,
  "editorFontSize": 14,
  "pageSize": 500,
  "maxResultRows": 5000,
  "formatKeywordCase": "Upper",
  "keymap": "DataGrip",
}

Some keys you might edit by hand: