Termic’s settings are organized into five sections. Settings open as an overlay, the panel sits on top of your tasks rather than replacing them, so your terminals keep running while you change things. Press Esc (twice, deliberately) to close it.
Appearance
Everything about how Termic looks:
- Theme: one of seven UI themes, styling chrome and terminal together.
- Syntax theme: one of eight, with a live preview, for the editor and diff view.
- Fonts: the UI font and the terminal / code font.
- Terminal font weight: bump to Medium if terminal text looks faint (see Terminal).
- Scrollback: terminal scrollback depth, default 5,000 lines.
General
App-wide behavior:
- Desktop notifications: off by default. When on, an agent finishing in a task you’re not viewing fires a macOS notification that routes you back to it. See Work-done & notifications.
- Sandbox preferences: including the bypass-permissions default that controls YOLO behavior. See Sandbox.
- Minimum send interval: default 10 seconds. Throttles the message queue so queued messages cannot fire too fast.
- Branch prefix: default “feature”. The prefix used when naming new task branches. Leave it empty for no prefix.
- Copy on select: on by default. Selecting text with the mouse in any terminal copies it to the clipboard automatically.
Agents
The editable agent registry. Each agent has its command, default args, YOLO args, and resume behavior; you can edit the built-ins, add your own, and set a per-agent Work-done detection toggle for custom CLIs that trip false positives. Terminal (a plain shell) is always present as a fallback default.
Shortcuts
A reference list of the current keyboard shortcuts.
Repository
Per-project configuration, this is the section you’ll touch most:
- Scripts & run: the setup and run scripts and the preview URL template. The Spotlight enable toggle also lives here.
- Sandbox defaults: the filesystem and network extras new tasks inherit, on top of the built-in defaults.
- Files to copy: untracked files seeded into each new worktree.
- Members: for multi-repo projects, the member repos. Add repo from disk registers a folder and adds it as a member in one step.
- Default CLI: the agent a task launches by default.
Much of what’s in Repository settings can be committed to .termic.yaml so it travels with the repo, with a .termic.yaml / Personal toggle deciding what’s shared versus machine-local.
Where settings are stored
App settings live in settings.json under Termic’s data directory (~/Library/Application Support/termic/ on macOS). Per-repo committed config lives in .termic.yaml in the repo. See Architecture & data for the full picture of where things are on disk.
Related
.termic.yaml: committed, shared config.- Architecture & data: file locations on disk.
- Themes & appearance: the Appearance section in depth.