Settings reference
Open Settings with ⌘, or the gear button. This page walks the settings you’ll actually touch, grouped by what they affect. Search the settings sidebar to jump straight to one.
Appearance
Section titled “Appearance”| Setting | What it does |
|---|---|
| Font size | Terminal (and editor) font size, applied live. |
| Font family | The monospace font used in terminals and Monaco editors. |
| Cursor blink | Whether the terminal cursor blinks. |
| Accent | The accent color used across the UI. |
Behavior
Section titled “Behavior”| Setting | What it does |
|---|---|
| Grid size | Spacing of the background dot grid. |
| Snap to grid | Snap nodes to the grid when you drag them. |
| Pan-hover delay (ms) | How long you dwell over a terminal before it takes focus (default 600 ms). |
| Double-click to focus | Whether double-clicking a node centers and focuses it. |
| Scroll wheel zooms | Zoom with a plain wheel instead of panning — turns scroll-to-pan off. |
Shell & terminals
Section titled “Shell & terminals”| Setting | What it does |
|---|---|
| Default shell | The shell new terminals launch. Empty uses the system default. |
| Persistent sessions (tmux) | Run terminals inside tmux so they survive restarts. Off = plain shells, no continuity. |
| Scrollback lines | How much history tmux keeps per session. |
tmux is what makes terminals survive quits and reboots — see Terminal persistence. Turning it off gives you plain shells with no cross-restart continuity.
Agents
Section titled “Agents”| Setting | What it does |
|---|---|
| Enabled agents & default | Which agents appear in the Add menus, and which one ⌘⇧C creates. |
| Claude permission mode | The mode Claude terminal sessions start in. Projects can override it; Shift+Tab still switches modes at runtime. |
The permission mode is global here and overridable per project from the tab ⌄ menu — see Permission modes. It applies to CLI agent nodes, not chat nodes.
Custom agents
Section titled “Custom agents”Bring your own agent CLI in Settings → Custom agents. Each entry has a Label, a Launch command, and an optional Prompt injection. Custom agents launch in a terminal and show process / title status only — no hooks, badges, branch, or loops. See the Agents overview.
Commit messages
Section titled “Commit messages”Settings → Commit messages configures the local agent that writes commit messages and
names terminals. Pick the Agent (Claude Code or a custom Command like
mycli --flag {prompt}), add an optional Extra prompt (e.g. a Conventional-Commits
instruction), and toggle Auto-fetch git status to refresh ahead/behind while Source
Control is open. It runs read-only on your staged diff — there’s no built-in model. See
Source control.
Accounts
Section titled “Accounts”Settings → Accounts manages isolated Claude logins. Each account gets its own config
directory, credentials, and transcripts, and a node keeps the account it was created with for
life. The System account is the machine’s default Claude login (~/.claude), used when a
node has no account. Full details in Claude accounts.
Notifications
Section titled “Notifications”Notify when a turn finishes in the background fires an OS notification when an agent finishes while nodeterm isn’t focused. A one-time consent prompt gates it. See Status & notifications.
Privacy
Section titled “Privacy”Send anonymous usage data (version/OS) is an opt-out telemetry ping. It contains only
your app version and OS, sent on launch and once a day — no personal data, no account,
no analytics SDK. It’s used only to see which versions are in use, and it’s disabled entirely
if you set DO_NOT_TRACK in your environment. See the FAQ and the
privacy policy.
License
Section titled “License”Settings → License manages your nodeterm Pro subscription. Paste a License key to activate, and Deactivate on this device to release it. Pro lifts the free relay quota and unlocks the remote-access features — see Relay quota & Pro.