τ-mux persiste ses réglages dans ~/Library/Application Support/hyperterm-canvas/settings.json. Le panneau de réglages (⌘,) écrit ce fichier, tout comme les bascules de la palette et les verbes RPC comme claude.auto_approve — ces chemins persistent et s’appliquent en direct. L’édition à la main fonctionne aussi, mais τ-mux ne surveille pas le fichier : une modification externe n’est prise en compte qu’au prochain lancement (et sera écrasée si l’application écrit ses réglages avant).
Schéma : AppSettings dans src/shared/settings.ts. Défauts : DEFAULT_SETTINGS. Validation : validateSettings (schémas par champ dans settings.schema.ts : une valeur hors bornes ou mal typée retombe sur le défaut au lieu de casser l’application).
Cette page liste tous les champs, avec le défaut lu depuis 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”.
Traiter OSC 9 ; <message> (dialecte iTerm2) comme une demande de notification. C’est le canal que les CLI d’agent appellent « notifications iterm2 » — le preferredNotifChannel: iterm2 de Claude Code arrive ici. Les notifications empruntent le même pipeline que ht notify : overlay, barre latérale, son, et transfert Telegram si activé.
terminalBellNotifyEnabled
boolean
true
Transformer BEL en notification — le canal terminal_bell proposé par les CLI d’agent. Limité à une notification par panneau toutes les 5 s pour qu’un programme sonnant la cloche en boucle ne puisse pas noyer le centre de notifications.
ideBridgeEnabled
boolean
true
Annoncer cette fenêtre à Claude Code en tant qu’IDE. Écrit ~/.claude/ide/<port>.lock et sert MCP sur un WebSocket restreint à la boucle locale : un diff proposé par Claude s’ouvre dans un panneau éditeur et attend votre verdict — une approbation qui atteint aussi Telegram si le transfert est activé. Le port est éphémère, lié à 127.0.0.1, et chaque connexion doit présenter un jeton propre au lancement, lu dans le fichier de verrou en 0600, supprimé à la fermeture de τ-mux. Désactivez-le pour cesser de vous annoncer et fermer l’écouteur.
terminalOsc52WriteEnabled
boolean
true
Autoriser les programmes à écrire dans le presse-papiers système via OSC 52 — c’est ainsi qu’un yank dans nvim ou tmux à travers SSH atteint votre machine locale. Les charges utiles au-delà de 100 000 caractères sont refusées plutôt que tronquées. Il n’existe volontairement aucun équivalent en lecture : OSC 52 définit aussi une lecture du presse-papiers, qui permettrait à n’importe quel processus ayant accès au terminal d’exfiltrer silencieusement son contenu ; τ-mux la refuse toujours. Aucun réglage ne l’active.
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.
Adresse de bind. Loopback par défaut depuis la v0.24.0. 0.0.0.0 expose le miroir à tout votre LAN — avec un jeton vide ou faible, τ-mux génère désormais automatiquement un jeton fort au lieu de tourner sans authentification.
webMirrorAuthToken
string
""
Jeton partagé pour l’accès au miroir. Vide signifie authentification désactivée en loopback uniquement — sur un bind 0.0.0.0, un jeton absent ou court (<16 caractères) est remplacé par un jeton généré, persisté ici et journalisé une fois au démarrage.
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 lit ce fichier au lancement et le réécrit à chaque changement de réglage ; il ne le surveille pas. Éditez-le donc application fermée, ou préférez le panneau / la palette / le RPC, qui s’appliquent immédiatement. Les champs inconnus sont supprimés au chargement (avertissement dans le log) et les valeurs invalides retombent sur leur défaut.