Variables d'environnement

τ-mux lit les variables d’environnement à deux moments distincts :

1. Au démarrage de l’application — celles-ci affectent le processus principal (port du miroir web, répertoire de logs).
2. À l’intérieur des shells lancés — celles-ci sont définies automatiquement par τ-mux pour que les scripts et le CLI ht les consomment.

Lues au démarrage de l’application

Variable	Défaut	Effet
HYPERTERM_WEB_PORT	(non défini)	Surcharge webMirrorPort et force le démarrage automatique, indépendamment des paramètres.
HT_SOCKET_PATH	<config dir>/hyperterm.sock	Surcharge le chemin du socket Unix. Doit correspondre entre τ-mux et le CLI ht. Depuis 0.3.187, le défaut est dérivé du répertoire de config (macOS : ~/Library/Application Support/hyperterm-canvas/hyperterm.sock), donc ht se connecte depuis n’importe quel shell — pas seulement les panneaux lancés par l’app.
HYPERTERM_INCLUDE_TEST_HOOKS	1 (dev), 0 (stable)	Indique si les méthodes RPC réservées aux tests sont exposées. Mettez à 0 pour les builds de production.
HT_CONFIG_DIR	~/Library/Application Support/hyperterm-canvas	Emplacement de settings.json, telegram.db, browser-history.json, cookie-store.json, et (en e2e) logs/. Les tests surchargent cette valeur.
HT_RPC_TOKEN_PATH	un fichier socket.token à côté du socket RPC	Surcharge le chemin où le CLI ht (et le ht-bridge pi/Claude) lit le jeton du socket RPC propre au boot. Pertinent uniquement quand Exiger un jeton de socket RPC (rpcSocketRequireToken) est activé. (ajouté en v0.3.163)

Définies automatiquement dans les shells lancés

Celles-ci sont peuplées automatiquement quand τ-mux lance une nouvelle surface de terminal. Les scripts à l’intérieur du shell peuvent les lire.

Variable	Valeur	Objectif
HT_SURFACE	par ex. surface:3	L’identifiant de cette surface. Le CLI le lit comme --surface par défaut ; les gestionnaires bun en déduisent l’espace de travail propriétaire pour ht plan, ht set-status, ht log, ht notify.
HYPERTERM_PROTOCOL_VERSION	1	Définie sur chaque shell lancé. Les clients sideband l’utilisent comme test « sommes-nous dans τ-mux ? ».
HYPERTERM_CHANNELS	{"meta":3,"data":4,"events":5}	Mappage JSON des canaux pour le protocole sideband.
TERM	xterm-256color	Entrée terminfo standard.
COLORTERM	truecolor	Indique le support des couleurs 24 bits aux TUIs.

Lues par le CLI / les clients

Variable	Effet
HT_SOCKET_PATH	Surcharge le chemin de socket par défaut (<config dir>/hyperterm.sock).
HT_SURFACE	--surface par défaut pour les commandes ht.
HT_RPC_TOKEN_PATH	Surcharge l’emplacement où le CLI ht lit le jeton du socket RPC propre au boot. Par défaut, un fichier socket.token dans le même répertoire que le socket RPC. Pertinent uniquement quand Exiger un jeton de socket RPC est activé. (ajouté en v0.3.163)
HYPERTERM_DEBUG	Active les logs de débogage dans les clients sideband Python / TS.

Patterns courants

Forcer le miroir web dans un plist launchd

<key>EnvironmentVariables</key>
<dict>
  <key>HYPERTERM_WEB_PORT</key>
  <string>3000</string>
</dict>

Socket personnalisé par projet

export HT_SOCKET_PATH=/tmp/foo.sock
bun start                          # τ-mux uses this
HT_SOCKET_PATH=/tmp/foo.sock ht ping

Désactiver les test hooks pour un build

HYPERTERM_INCLUDE_TEST_HOOKS=0 bun run build:stable

Pour aller plus loin

• Paramètres
• Aperçu de ht