[Bug]: Provider agent sessions inherit ELECTRON_RUN_AS_NODE=1 on macOS, so Electron apps launched from agent shells run as Node and exit

Abierto Apto para principiantes
  • ¿Algo no está bien?
#26,966 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
76/100
Tipo de issue
Error
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
electron, macos, typescript
Área
backend

Línea de trabajo

Empieza por mergeProviderInstanceEnvironment y los adaptadores de sesión de provider en apps/server; según el issue, crean entornos de sesión mediante este helper. Compara esa ruta con TERMINAL_ENV_BLOCKLIST en apps/server/src/terminal/Manager.ts y con el manejo del entorno existente que describe el issue. Se considerará terminado cuando las shells de provider ya no hereden ELECTRON_RUN_AS_NODE, mientras que los helpers que necesiten el modo Node aún puedan establecerlo por sí mismos.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Before submitting
  • I searched existing issues and did not find a duplicate.
  • I included enough detail to reproduce or investigate the problem.
Area

apps/server

Steps to reproduce
  1. On macOS, start a Claude (or Codex) thread in the desktop app.
  2. Ask the agent to run echo $ELECTRON_RUN_AS_NODE with its shell tool. It prints 1.
  3. Ask it to launch any Electron app from that shell, for example /Applications/Slack.app/Contents/MacOS/Slack --remote-debugging-port=9222.
Expected behavior

Agent shells don't have ELECTRON_RUN_AS_NODE, so an Electron app launched from one opens normally.

Actual behavior

The Electron app starts as plain Node and exits without opening a window. Agents that drive desktop apps over CDP (Slack, VS Code, Discord, etc.) can't start them.

The desktop app starts the server with ELECTRON_RUN_AS_NODE=1 on purpose (apps/desktop/src/backend/DesktopBackendConfiguration.ts), and mergeProviderInstanceEnvironment passes it through unchanged to provider sessions, so every tool shell inherits it. The integrated terminal (TERMINAL_ENV_BLOCKLIST in apps/server/src/terminal/Manager.ts) and the external launcher (#20206) already drop it; provider sessions are the remaining path.

This is the provider-session part of #16456, which was closed with a request for a new issue covering only that part. It isn't Linux-specific: the same leak happens on macOS without any AppImage variables.

#16679 (maintainer takeover) fixes this: its mergeProviderInstanceEnvironment deletes ELECTRON_RUN_AS_NODE on every platform before applying provider overrides, and Claude, Codex, Grok, Antigravity and the ACP registry adapters all build their session environment through it. T3's own helpers that need Node mode (agent-device wrappers since #18301, the Claude history worker, document text extraction) set the variable themselves, so they're unaffected.

Impact

Major degradation or frequent failure

Version or commit

T3 Code (Nightly) 0.1.5-nightly.20261029.3877; code references are upstream/main at 20497e4890.

Environment

macOS 27 (Apple Silicon), desktop app, Claude provider. Same code path for Codex.

Logs or stack traces
$ echo "ELECTRON_RUN_AS_NODE=${ELECTRON_RUN_AS_NODE-<unset>}"   # inside a Claude agent's Bash tool
ELECTRON_RUN_AS_NODE=1
Workaround

Prefix the launch with env -u ELECTRON_RUN_AS_NODE, or unset ELECTRON_RUN_AS_NODE in the agent's shell first.

Lenguaje dominante
TypeScript
Estrellas
24.8k
Forks
6.4k
Merge medio
14 h 40 min
PR fusionados (30 d)
193

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de pingdotgg/t3code

Todos los issues de pingdotgg/t3code

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.