Edit QH configuration

Change settings in the app

Choose the gear in the sidebar or press Cmd+, to open Settings. A separate, resizable Settings window has Appearance, Terminal, Storage, Keyboard, Commands, Updates, and About pages. Changes apply automatically after validation, and Saved appears when the local file has been written. Close Settings with its native window close button. The terminal sessions stay open. Settings window size and last page are saved separately.

Appearance has Charcoal, Graphite, and Midnight themes, six accent presets, custom color pickers, and font controls. Enter a theme name and choose Save current theme to keep your palette. Use a workspace or tab’s Color menu for a separate label color.

Edit the JSON configuration

Choose Open Configuration JSON, or run qh config. QH prefers VS Code, Cursor, or Windsurf when installed, then uses the file’s associated editor. The active path is printed by qh config path:

1~/Library/Application Support/Qentrah/QH/config.jsonc

JSONC accepts comments and trailing commas. Header comments link to this guide and GUI keyboard customization. Existing config.json and old app sidecar settings are imported once. GUI saves preserve comments on unchanged settings. Desktop windows reload valid editor changes; invalid edits keep the last active settings and show an error.

1{
2  // Folder and shell are used for new windows.
3  "defaultPath": "~/Documents",
4  "shell": "/bin/zsh",
5  "fontFamily": "Menlo, Monaco, monospace",
6  "fontSize": 14,
7  "tabsPosition": "left",
8  "scrollback": 5000,
9  "restore": true,
10  "storage": {
11    "enabled": true,
12    "saveDelayMs": 250,
13    "maxWorkspaces": 30
14  },
15  "shortcuts": {
16    "new-tab": "Cmd+T",
17    "settings": "Cmd+,"
18  }
19}

Only include the settings you want to override; missing settings get defaults. Font size accepts 10–28. Scrollback accepts 100–50000 lines. Storage save delay accepts 100–5000 milliseconds, and maximum workspaces accepts 1–100. Lowering the workspace limit preserves open workspaces and limits new ones. Saving can be disabled independently of restoring.

theme has background, surface, foreground, muted, border, primary, error, and selection colors, each as #RRGGBB. themes holds up to 20 complete named palettes. Custom themes, quick commands, and SQLite storage have examples.

Validate changes

Run qh config validate. A failed GUI edit shows Not saved and an error, and leaves the previous file intact. The Storage page shows the database path, size, startup time, main-process memory, session count, and up to 30 recent app errors from this window. Error history stays in memory and is not uploaded.