Saltar al contenido principal
TYBA levanta dos agentes:
Ninguno de los dos viene incluido. TYBA no empaqueta, no descarga ni instala agentes. Busca el binario en tu PATH y usa el que encuentre.
Instalar y mantener la suscripción de cada uno corre por tu cuenta. Sin ninguno de los dos, TYBA sigue siendo una terminal completa — lo que no puedes hacer es crear una sesión de agente.
El PATH que consulta es el de tu shell de login, no el del proceso. TYBA ejecuta $SHELL -lic una vez para descubrir dónde están las cosas, y guarda el resultado.Por eso un agente instalado vía nvm, asdf o Homebrew se encuentra incluso cuando la app se abre desde un lanzador gráfico (el Dock, en macOS), que hereda un PATH mínimo.

​
Crear una sesión de agente

Los dos abren el mismo diálogo. Primero pregunta dónde trabaja la sesión: carpeta por defecto, última carpeta, elegir carpeta, tu home, o un host SSH. La elección del agente viene después — y solo aparece cuando la sesión está aislada en un worktree. Ahí está la diferencia entre los dos atajos:
  • ⌘⇧T ya entra con “Isolate in a git worktree” activado.
  • ⌘N respeta la preferencia “Isolate new sessions by default” (Settings → Preferences, desactivada por defecto).
Con la preferencia activada, los dos atajos hacen lo mismo.
Una sesión de agente es siempre una sesión en worktree. No es un acoplamiento accidental: worktree, jaula, env por allowlist e inbox nacen juntos, en el mismo paso. El camino entero está en Primera sesión.Ejecutar claude escribiendo su nombre en un shell es otra cosa — y lo que pierdes está descrito en Agente por SSH.
La preferencia “Default folder for new sessions” (Settings → General) pone una carpeta como primera opción de la lista, marcada con la etiqueta default folder. Vacía = sin valor por defecto.

​
Cuando el binario no está ahí

Solo Codex se comprueba de antemano. El diálogo prueba si codex existe y, si no existe, deshabilita su botón con el motivo: “codex binary not found in PATH — install the Codex CLI”.El botón de Claude Code nunca se deshabilita. Sin claude instalado, lo eliges, envías, y solo entonces recibes el error del core: `claude` binary not found in PATH. Aparece en el propio diálogo — la sesión no arranca, no se rompe nada, pero te enteras tarde.

​
Agente por defecto del repositorio

Un repositorio puede preseleccionar el agente con agent.default en .tyba/config.toml — y eso solo vale después de que apruebes ese archivo. Las reglas (y por qué el consentimiento es por hash) están en Configuración del repositorio.

​
Qué informa la sesión

Dos cosas que vale la pena saber:
Exited no dibuja nada. Una sesión que terminó normalmente no genera punto ni etiqueta — el silencio es el estado correcto de lo que ya acabó.Idle solo aparece cuando pide atención. Si ya viste el resultado, el verde desaparece.
El status aparece en la entrada de la sidebar y en el hover card — no en la pestaña. Cuando un workspace tiene varias sesiones, la sidebar muestra la más urgente: falló > bloqueado/esperando > terminado > en curso.

​
El agente de review

En Settings → Code, el campo “Review agent” decide quién recibe los comentarios que escribes en un diff cuando no hay una sesión viva en ese worktree. Si hay sesión, el prompt va hacia ella. Sin sesión, TYBA abre una, levanta el agente elegido y pega el prompt.
“Custom command” no ejecuta un comando. El campo acepta una línea (claude --model opus), pero TYBA lee solo el nombre del binario y tira los argumentos: codex levanta Codex, cualquier otra cosa levanta Claude Code.Así que claude --model opus levanta un Claude Code común, sin --model opus. Y aider también levanta Claude Code, en silencio.El placeholder del campo sugiere lo contrario — está equivocado, y el comportamiento de arriba es el real.
La limitación es deliberada. Una sesión de agente tiene que pasar por el runner del core: es él quien carga los hooks, la jaula y la allowlist de entorno. Una línea de comando arbitraria levantaría un proceso sin gate de aprobación — exactamente lo que TYBA existe para impedir.

​
Ver también

Cómo TYBA habla con el agente

De dónde viene el gate de aprobación.

El composer

La caja de prompt largo.

Configuración del repositorio

agent.default y la allowlist de entorno.

Agente por SSH

Lo que pierdes al otro lado del tubo.