Shell integration

Una terminal común no tiene idea de lo que pasa dentro de ella. Ve bytes. “¿Está corriendo algo?”, “¿qué comando es ese?”, “¿falló?” — nada de eso está en el stream. La shell integration resuelve eso: TYBA inyecta un puñado de hooks en el shell de la sesión, y el shell pasa a contar dónde está — el prompt empezó, el comando empezó, el comando terminó con tal código de salida, el directorio cambió. Settings → Code → Shell integration. Viene encendida.

​

Lo que ganas

Sin eso, una sesión parada y una sesión compilando desde hace tres minutos son visualmente idénticas.

​

No toca tus dotfiles

TYBA escribe los archivos de integración en un directorio temporal que es solo tuyo — creado con permisos 0700, verificado en cada uso (dueño correcto, nadie más entra) — y apunta el shell de esa sesión ahí, vía una variable de entorno. Sus archivos empiezan haciendo source de los tuyos, y solo después instalan los hooks. La consecuencia: tu configuración corre entera, en el orden de siempre, y TYBA entra al final. Si él falla, tu shell sigue — los hooks se escribieron para no tirar abajo la sesión ni siquiera bajo set -e. Es el mismo patrón que usan VS Code e iTerm2. Desinstalar TYBA no deja residuo en ningún lado: no hay residuo que dejar.

​

Dónde funciona

TYBA usa el $SHELL del sistema — no hay shell por defecto configurable. Si quieres los hooks, el camino es tener zsh o bash como tu shell.

​

Esto no es lo que da estado a las sesiones de agente

Son dos canales distintos, y vale la pena no confundirlos: El agente avisa por su cuenta: la herramienta que va a ejecutarse se vuelve Running, el fin de turno se vuelve Idle, una petición de respuesta se vuelve AwaitingInput. Es el mismo canal del inbox de aprobaciones, y existe independientemente de tu shell — ver cómo TYBA habla con el agente. Lo que la shell integration sí le da a los agentes es otra cosa: la detección de un agente corriendo dentro de un shell común. Escribiste claude en un pane de shell — TYBA lo descubre por la línea de comando que el shell reporta, y es la integración la que reporta.

​

Apagar

Settings → Code → Shell integration, toggle off. Vale para las sesiones nuevas — los hooks entran en el nacimiento del shell, así que las sesiones ya abiertas siguen como están hasta que abras otra. Un motivo legítimo para apagarla: tu shell tiene una config exótica y algo empezó a comportarse raro — prompt duplicado, PROMPT_COMMAND peleando, un plugin al que no le gusta la compañía. Apagarla es el test de dos líneas para saber si TYBA es el culpable. Lo que pierdes:

​

Ver también