τ-mux persists settings to ~/Library/Application Support/hyperterm-canvas/settings.json. The settings panel (⌘,) writes this file, and so do the command palette toggles and RPC verbs like claude.auto_approve — those paths persist and apply live. Hand-editing the file works too, but τ-mux does not watch it: an external edit is only picked up on the next launch (and will be overwritten if the app writes settings first).
Schema: AppSettings in src/shared/settings.ts. Defaults: DEFAULT_SETTINGS. Validation: validateSettings (per-field schemas in settings.schema.ts, so an out-of-range or wrong-typed value falls back to the default rather than breaking the app).
This page lists every field, with the default read from DEFAULT_SETTINGS.
Experimental GPU renderer. Falls back to DOM automatically on unsupported hardware, init failure, or context loss — the settings panel shows a live “running on DOM — reason” hint when it has. It shipped enabled in v0.4.9 and rendered panes blank on some setups; a one-time migration in v0.4.12 reset a persisted webgl back to dom. Command palette: “Use WebGL/DOM Terminal Renderer”.
Honour OSC 9 ; <message> (the iTerm2 dialect) as a notification request. This is the channel agent CLIs mean by “iterm2 notifications” — Claude Code’s preferredNotifChannel: iterm2 lands here. Notifications go through the same pipeline as ht notify: overlay, sidebar, sound, and Telegram forwarding when enabled.
terminalBellNotifyEnabled
boolean
true
Turn BEL into a notification — the terminal_bell channel agent CLIs offer. Throttled to one per pane per 5 s so a program ringing the bell in a loop cannot flood the centre.
ideBridgeEnabled
boolean
true
Advertise this window to Claude Code as an IDE. Writes ~/.claude/ide/<port>.lock and serves MCP over a loopback-only WebSocket, so a diff Claude proposes opens in an editor pane and waits for your verdict — an approval that also reaches Telegram when forwarding is on. The port is ephemeral, bound to 127.0.0.1, and every connection must present a per-launch token from the 0600 lock file, which is removed when τ-mux exits. Turn it off to stop advertising and close the listener.
terminalOsc52WriteEnabled
boolean
true
Let programs write the system clipboard with OSC 52 — how a yank in nvim or tmux over SSH reaches your local machine. Payloads above 100 000 characters are refused rather than truncated. There is deliberately no read counterpart: OSC 52 also defines a clipboard read, which would let any process with terminal access exfiltrate your clipboard silently, and τ-mux always refuses it. No setting turns that on.
Auto-accept the permission prompt Claude Code shows in a terminal pane by sending Enter. Only fires for that terminal prompt — never the τ-mux approval modal, never the Claude Code pane — pauses itself after a burst, and logs every approval to the pane’s sidebar log. Off by default: this grants unattended consent for commands the agent asks to run.
claudeAutoApproveDelayMs
number
700
Delay before the Enter keystroke, 0–10000 ms. The prompt is re-checked when the delay expires, so a prompt you answered yourself never receives a stray Enter.
Bind address. Loopback by default since v0.24.0. 0.0.0.0 exposes the mirror to your whole LAN — with an empty or weak token τ-mux now generates a strong one automatically instead of running unauthenticated.
webMirrorAuthToken
string
""
Shared token for mirror access. Empty means authentication is off on loopback only — on a 0.0.0.0 bind a missing or short (<16 chars) token is replaced by a generated one, persisted here and logged once at startup.
rpcSocketRequireToken
boolean
true
Require the per-boot token for state-mutating ht socket calls. On by default since v0.4.12; every first-party client presents it automatically.
τ-mux reads this file at launch and rewrites it whenever settings change; it does not watch it. So edit it while the app is closed, or prefer the settings panel / palette / RPC, which apply immediately. Unknown fields are dropped on load with a logger warning, and invalid values fall back to their default.