Access Settings with Cmd+Shift+P or from the application menu.
| Setting | Options | Default |
|---|
| Theme | Default, Dracula, Nord, Catppuccin, Solarized, Monokai, GitHub | Default |
| Color Mode | Dark, Light, Auto | Dark |
| Font Size | 10-24px | 14px |
| Font Family | Any monospace font | System default |
| Setting | Options | Default |
|---|
| Default Shell | zsh, bash, fish, custom path | Login shell |
| Cursor Style | Block, Underline, Bar | Block |
| Cursor Blink | On/Off | On |
| Scrollback Lines | 100-100000 | 10000 |
| Bell | Sound, Visual, None | None |
| Setting | Options | Default |
|---|
| Tab Size | 2, 4, 8 | 2 |
| Word Wrap | On/Off | Off |
| Line Numbers | On/Off | On |
| Minimap | On/Off | Off |
| Setting | Options | Default |
|---|
| Show Dotfiles | On/Off | Off |
| Show node_modules | On/Off | Off |
| Follow Terminal CWD | On/Off | On |
| Sort By | Name, Date, Size, Type | Name |
| Setting | Options | Default |
|---|
| Restore Layout | On/Off | On |
| Restore Sessions | On/Off | On |
| Show Terminal Status | On/Off | On |
| Auto-Update | On/Off | On |
| Setting | Options | Default |
|---|
| Enable AI Workspace | On/Off | On |
| Setting | Options | Default |
|---|
| Send Analytics | On/Off | On |
| Crash Reporting | On/Off | On |
Analytics are anonymous usage metrics (sessions, panel types used, crash reports). No code or file content is ever sent. See System Requirements for details on what’s collected.
The Settings panel includes a guided Gee setup flow (macOS) and built-in diagnostics export.
| Action | Details |
|---|
| Check Status | Re-check required tools: Homebrew, Python 3.12, Node.js, and gee-code. |
| One-Click Install | Installs missing required tools in sequence (macOS only). |
| Optional CLI Installs | Installs optional tools: Claude Code CLI and OpenAI Codex CLI. |
| Export Diagnostics Report | Writes a JSON freeze report to the app diagnostics reports directory (<userData>/diagnostics/reports). |
After installing Gee tooling, run gee-code auth login in a terminal panel.
Settings are stored in ~/.the-terminal/settings.json. You can edit this file directly, but changes require restarting The Terminal.