Esta página es una traducción de la documentación en inglés. Los comandos, identificadores y ejemplos no cambian. Runtime 7.24.4 · SDK 2.6.7. Original en inglés

Representación en la terminal

Estado: Vigente Alcance: selección del perfil de terminal de la TUI, anulaciones y límites de capacidad visual Última revisión: 2026-10-03 Responsable: mantenedores de la TUI de AX Code

AX Code elige un perfil de terminal a partir del entorno cuando arranca. El perfil controla la preparación de la terminal, no la resolución del monitor ni la nitidez de la fuente.

Un TERM_PROGRAM explícito tiene prioridad sobre los marcadores heredados de la terminal exterior. Los tipos de terminal limitados, como dumb, linux y vt100, también permanecen en compatible. La identidad de Ubuntu o de WSL por sí sola no activa el perfil avanzado.

El perfil avanzado usa la pantalla alternativa, un hilo nativo de representación y la detección de capacidades de la terminal. El perfil compatible usa la pantalla principal sin el hilo nativo de representación. Ambos activan la interacción con el ratón (consulta Captura del ratón) y la negociación del protocolo de teclado, y apuntan a 60 FPS; las tasas de fotogramas reales dependen de la carga y de la terminal.

Windows Terminal conserva los efectos visuales de 24 bits en cualquiera de los perfiles cuando se identifica su sesión directa. El soporte de color no implica gráficos de píxeles ni soporte de Nerd Font. El modo avanzado no cambia la fuente, el tamaño de la fuente ni la escala de la pantalla.

Captura del ratón

AX Code captura la entrada de ratón de la terminal de forma predeterminada para que los controles de la TUI sigan siendo clicables: las pastillas de atajo del pie (modelo rápido, Autónomo, Sandbox), las opciones de los diálogos y del autocompletado, el clic para enfocar, la selección por arrastre y el desplazamiento con la rueda dentro de la TUI. Mientras la captura está activa, la terminal entrega el ratón al programa en ejecución, así que no se muestran el menú contextual propio de la terminal ni la selección nativa de texto. Muchas terminales siguen exponiéndolos con un modificador — normalmente Mayús más clic derecho, a veces Option o Alt — según la terminal y según si tmux, screen o Zellij están en medio.

Define mouse como false en tui.json para devolver el ratón a la terminal:

{
  "mouse": false
}

AX_CODE_DISABLE_MOUSE=1 desactiva la captura con independencia de tui.json. Existe porque los archivos tui.json del nivel de proyecto son entrada no confiable: un repositorio no debe poder mantener suprimido el comportamiento propio del ratón de la terminal contra la voluntad del usuario. La variable solo desactiva la captura; nunca puede forzarla.

Renunciar es un intercambio, no una ganancia pura:

• Se recupera: el menú contextual nativo de la terminal, la selección nativa de texto y copiar y pegar. El historial de desplazamiento propio de la terminal gestiona la rueda en el perfil compatible.
• Se pierde: las pastillas de atajo del pie, el clic para enfocar, las opciones clicables de diálogos y de autocompletado, la selección por arrastre y — en el perfil avanzado (pantalla alternativa), que no tiene historial de desplazamiento de la terminal — el desplazamiento con la rueda dentro de la TUI. Los controles de teclado siguen disponibles para esas acciones.

Mientras la captura está activa, el clic derecho abre el menú contextual propio de la TUI en lugar del de la terminal: un menú pequeño de Copiar / Pegar en la posición del clic. Copiar está activo cuando hay una selección en pantalla, y Pegar cuando un campo de texto tiene el foco, incluido el prompt y los campos dentro de los diálogos. El menú se cierra con Escape, con cualquier pulsación de tecla, con el desplazamiento o con un clic fuera de él. Cuando la captura está desactivada, la terminal gestiona el clic.

Anular el perfil

Define AX_CODE_TUI_ADVANCED_TERMINAL=1 para pedir el modo avanzado o 0 para pedir el modo compatible. Una anulación explícita tiene prioridad sobre la detección automática, incluidas las sesiones remotas y multiplexadas. Quita la variable para restaurar la selección automática. También se aceptan true/false, yes/no y on/off.

PowerShell, para el shell actual y sus procesos hijos:

$env:AX_CODE_TUI_ADVANCED_TERMINAL = "1"
ax-code

# Use compatible mode if startup or rendering has problems.
$env:AX_CODE_TUI_ADVANCED_TERMINAL = "0"
ax-code

# Restore automatic selection.
Remove-Item Env:AX_CODE_TUI_ADVANCED_TERMINAL -ErrorAction SilentlyContinue

Bash o Zsh, para un solo arranque:

AX_CODE_TUI_ADVANCED_TERMINAL=1 ax-code
AX_CODE_TUI_ADVANCED_TERMINAL=0 ax-code

Si los archivos de arranque de tu shell exportan la variable, quita esa exportación y ejecuta unset AX_CODE_TUI_ADVANCED_TERMINAL para restaurar la selección automática.

Animaciones de píxeles

Las animaciones de apertura y de cierre usan píxeles solo cuando el representador confirma gráficos Kitty, dimensiones de píxel válidas, un TTY local, la pantalla alternativa y ningún multiplexor. Si faltan capacidades o falla el gráfico, se usa la reserva de texto. El modo avanzado automático no elude estas comprobaciones.

Todos los fotogramas de animación de píxeles — Digital Code, Foliage y las escenas de referencia — están acotados a 1920x1080. Estos fotogramas de animación se actualizan en una cadencia de 20 FPS, aparte del objetivo de 60 FPS del representador. Consulta Animaciones de apertura y de cierre de la TUI para las vistas previas.

Las sesiones de Windows Terminal con soporte Sixel confirmado (y sin gráficos Kitty) muestran un fotograma estático de presentación Sixel, acotado a 640x360 y 256 KiB, en lugar de la reserva de texto. AX_CODE_SIXEL_SPLASH=0 lo desactiva; =1 permite que cualquier terminal Sixel lo muestre (ruta de prueba). El desmontaje vuelve a pintar la región de presentación con el fondo de la superposición porque Sixel no tiene borrado por id de imagen.

Fuente de Windows Terminal

AX Code no puede cambiar la fuente de la terminal. Los iconos de tipo de archivo (glifos de uso privado de Nerd Font) se representan en Windows Terminal solo con una fuente parcheada instalada. La fuente recomendada es Cascadia Code NF: instálala y luego defínela como fuente del perfil en Ajustes > Perfiles > Apariencia > Tipo de letra. Una indicación única dentro de la aplicación señala esta configuración a quienes usan Windows Terminal; nunca se muestra cuando los iconos ya se representan o cuando AX_CODE_NERD_FONT=0 renuncia.