Settings
Configure Cordy Desktop behavior, appearance, shortcuts, shells, terminal presets, external apps, browser data, and diagnostics.
Open the gear button or choose Open settings from the command palette. Settings has pages for General, Appearance, Shortcuts, Shell, Terminal presets, External apps, Passwords, Site data, Site permissions, Downloads, and Diagnostics.
General: close confirmations
Both switches are on by default:
- Confirm closing a busy terminal asks before a single tab closes while a command or agent is running. An idle shell closes directly.
- Confirm closing an unsaved file asks before a single file tab discards an editor buffer. Files are not auto-saved.
These switches do not suppress the full-quit confirmation. Bulk close operations follow their own rules: for example, bulk file-tab close skips dirty buffers. The launch-time window close mode is separate; see Runtime.
Appearance
Appearance changes apply immediately. The controls are:
| Control | Options and default |
|---|---|
| Mode | System (default), Light, or Dark. System follows the operating-system preference. |
| Light theme | Cordy Light by default; light built-ins also include Catppuccin Latte, Gruvbox Light, and Solarized Light. |
| Dark theme | Cordy Dark by default; dark built-ins also include Catppuccin Mocha, Dracula, Gruvbox Dark, Nord, One Dark, Rose Pine, Solarized Dark, and Tokyo Night. |
| File icons | Lucide (default), Material, or Minimal. This changes icons in Files, tabs, Search, Changes, and Graph. |
| UI font and size | Inter/System stack, 16 px by default. |
| Editor font and size | JetBrains Mono stack, 14 px by default. |
| Terminal font and size | Maple Mono NF CN with monospace and CJK fallbacks, 14 px by default. |
Each font picker offers bundled fonts, detected system fonts, and a typed family name. The terminal picker filters for monospace fonts unless you choose to show all. Font sizes accept whole numbers from 8 through 40. Reset restores every appearance value above, including both theme slots and the file-icon theme.
Create or install a theme
Choose Create theme…, select a base theme, and enter a name. You can change application color tokens, copy a terminal palette from another theme, edit terminal colors, choose the code-block theme, and inspect the live preview. Create theme writes a JSON file into Cordy's themes folder and selects it for its light or dark slot.
To install an existing theme JSON, choose Open themes folder and place the file there. Valid files appear under Custom themes and reload when edited on disk. Use Edit to reopen the theme creator. Deleting takes two clicks and resets a selected light or dark slot to Cordy's default. Invalid or conflicting theme files are listed below the custom-theme section.
Shortcuts
Select a shortcut row, then press the new combination. Escape cancels recording; Backspace or Delete clears the binding. Cordy reports duplicate bindings before saving. Reset restores that action's default.
In terminal decides whether an application shortcut overrides the same keys while a terminal is focused. Leave it off when the shell or TUI needs that binding. Bare-key workspace bindings always stay with the terminal and cannot be enabled there. See the current defaults in Shortcuts.
Shell
This page selects the program used by a new empty terminal tab; agent presets may name a different program.
- Automatic prefers PowerShell 7, then Windows PowerShell, then Command Prompt.
- Installed PowerShell, Command Prompt, Git Bash, and WSL choices appear when discovered. Use Rescan after installing or removing one.
- Custom accepts an executable plus arguments, such as
C:\Tools\shell.exe --login.
Discovery uses known installation locations and registry data rather than PATH. If a selected shell disappears, Cordy shows the fallback command and retains the selection so reinstalling it restores the choice. The selection is stored in terminal-shell.json under the user-data directory.
Terminal presets
The preset list controls the launch bar for every project. Drag rows to reorder them; use the eye action to show or hide one. Select a row to edit its display name and full command line. A built-in can be reset, hidden, deleted from the bar, and later restored. Removing a user preset deletes that preset.
Choose Add preset for the full custom-agent form. The following example launches an installed CLI named my-agent:
| Field | Example | Meaning |
|---|---|---|
| Display name | My Agent | Label shown in the preset bar. |
| Command | my-agent | Executable Cordy starts with your user permissions. |
| Default args | --profile, then review on the next line | One argument per line, in launch order. |
| Env overrides | MY_AGENT_MODE=review | Values added to or replaced in the child process environment. They are stored in agent-presets.json; do not enter a secret unless you intend to store it there. |
| Running patterns | My Agent | Rendered-screen text that marks successful startup. |
| Waiting for input patterns | > | Prompt-line text that marks a request for input. |
| Busy patterns | esc to interrupt | Text present only while work is active. When provided, this detector takes priority over waiting patterns. |
| Failure patterns | Error: | Rendered-screen text that marks failure. |
| Idle window | 30000 ms (default) | Time without output before a running process is shown as idle; the form minimum is 1000 ms. |
The working-directory policy is fixed to the active workspace's code target. Review the command, working directory, and environment on the confirmation step before registering it. Cordy does not install or sandbox the executable.
External apps
Choose System default or a detected supported editor for the toolbar's main editor action. The page shows the detected executable path for each editor. External terminal choices remain available from the toolbar handoff menu and are not configured on this page.
Browser controls
Passwords, Site data, Site permissions, and Downloads all apply to the shared built-in-browser partition. See Built-in browser for the controls, exact-origin password filling, and permission limits.
Diagnostics
The Logs section opens the local log folder and manages a shareable log bundle. Choose a range of Last hour, Last 24 hours (default), Last 7 days, or Everything. Then include any combination of Main log, Runtime log, Diagnostic events, and System info; all four are selected by default. Export… writes a path-redacted ZIP locally. Cordy does not send it. Show in folder reveals the last export.
Clear logs deletes main.log, runtime.log, their rotated copies, and the diagnostic event log after confirmation. The Storage section reports application logs, diagnostic exports, crash dumps, browser/GPU cache, regenerable snapshot backups, settings/themes, and core project data. Clear all caches only clears safe cache categories. Snapshot backups require their own confirmation; settings, themes, projects, workspaces, notebooks, browser governance files, and live recovery data are protected from this cleanup action.
The compact CPU/memory chip offers 2-minute, 10-minute, and 1-hour charts; View details opens the full monitor. Its Workload view is available on Windows only. The monitor's diagnostics package is a separate local export described in Troubleshooting.