Esta página é uma tradução da documentação em inglês. Comandos, identificadores e exemplos permanecem iguais. Runtime 7.24.4 · SDK 2.6.7. Original em inglês

Renderização do terminal

Status: Atual Escopo: seleção de perfil de terminal da TUI, substituições e limites de capacidade visual Última revisão: 2026-10-03 Responsável: mantenedores da TUI do AX Code

O AX Code escolhe um perfil de terminal a partir do ambiente quando inicia. O perfil controla a preparação do terminal, não a resolução do monitor nem a nitidez da fonte.

Um TERM_PROGRAM explícito tem precedência sobre marcadores herdados do terminal externo. Tipos de terminal limitados, como dumb, linux e vt100, também permanecem compatíveis. A identidade de Ubuntu ou de WSL, sozinha, não ativa o perfil avançado.

O perfil avançado usa a tela alternativa, uma thread nativa de renderização e a detecção de capacidade do terminal. O perfil compatível usa a tela principal sem a thread nativa de renderização. Os dois ativam a interação com o mouse (veja Captura do mouse) e a negociação do protocolo de teclado, e miram 60 FPS; a taxa real de quadros depende da carga e do terminal.

O Windows Terminal conserva efeitos visuais de 24 bits em qualquer perfil quando a sessão direta dele é identificada. Suporte a cor não implica gráficos em pixel nem suporte a Nerd Font. O modo avançado não muda a fonte, o tamanho da fonte nem a escala da tela.

Captura do mouse

O AX Code captura a entrada de mouse do terminal por padrão, para que os controles dentro da TUI continuem clicáveis: os selos de atalho do rodapé (modelo Fast, Autônomo, Sandbox), opções de diálogo e de autocompletar, clique para focar, seleção por arraste e rolagem pela roda dentro da TUI. Com a captura ligada, o terminal entrega o mouse ao programa em execução, então o menu de clique direito do próprio terminal e a seleção nativa de texto não aparecem. Muitos terminais ainda os expõem com um modificador — em geral Shift mais clique direito, às vezes Option ou Alt — conforme o terminal e conforme tmux, screen ou Zellij estejam no meio.

Defina mouse como false em tui.json para devolver o mouse ao terminal:

{
  "mouse": false
}

AX_CODE_DISABLE_MOUSE=1 desativa a captura independentemente de tui.json. Ele existe porque arquivos tui.json no nível do projeto são entrada não confiável: um repositório não pode manter o comportamento próprio do mouse do terminal suprimido contra a vontade do usuário. A variável só desativa a captura; ela nunca pode forçá-la a ligar.

Desligar é uma troca, não um ganho puro:

• O que volta: o menu nativo de clique direito do terminal, a seleção nativa de texto e copiar/colar. O histórico de rolagem do próprio terminal trata a roda no perfil compatível.
• O que se perde: selos de atalho do rodapé, clique para focar, opções clicáveis de diálogo e de autocompletar, seleção por arraste e — no perfil avançado (tela alternativa), que não tem histórico de rolagem do terminal — a rolagem pela roda dentro da TUI. Os controles de teclado continuam disponíveis para essas ações.

Com a captura ligada, o clique direito abre o menu de contexto da própria TUI, em vez do menu do terminal: um menu pequeno de Copiar / Colar na posição do clique. Copiar fica ativado quando há uma seleção na tela, e Colar quando uma entrada de texto está em foco — inclusive o prompt e as entradas dentro de diálogos. O menu fecha com Escape, com qualquer tecla, com rolagem ou com um clique fora dele. Depois que a captura é desligada, o terminal trata o clique.

Substituir o perfil

Defina AX_CODE_TUI_ADVANCED_TERMINAL=1 para pedir o modo avançado ou 0 para pedir o modo compatível. Uma substituição explícita tem prioridade sobre a detecção automática, inclusive em sessões remotas e multiplexadas. Remova a variável para restaurar a seleção automática. true/false, yes/no e on/off também são aceitos.

PowerShell, para o shell atual e os processos filhos:

$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 ou Zsh, para um único lançamento:

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

Se os arquivos de inicialização do shell exportam a variável, remova essa exportação e execute unset AX_CODE_TUI_ADVANCED_TERMINAL para restaurar a seleção automática.

Animações em pixel

As animações de abertura e de encerramento usam pixels somente quando o renderizador confirma gráficos Kitty, dimensões válidas em pixel, um TTY local, a tela alternativa e nenhum multiplexador. Capacidades ausentes ou uma falha de gráficos usam a reserva em texto. O modo avançado automático não contorna essas checagens.

Todos os quadros de animação em pixel — Digital Code, Foliage e as cenas de marco — ficam limitados a 1920x1080. Esses quadros de animação atualizam numa cadência de 20 FPS, à parte da meta de 60 FPS do renderizador. Veja Animações de abertura e de encerramento da TUI para as prévias.

Sessões do Windows Terminal com suporte Sixel confirmado (e sem gráficos Kitty) mostram um quadro estático de abertura em Sixel, limitado a 640x360 e 256 KiB, em vez da reserva em texto. AX_CODE_SIXEL_SPLASH=0 o desativa; =1 permite que qualquer terminal Sixel o mostre (caminho de teste). O encerramento repinta a região da abertura com o fundo da sobreposição, porque o Sixel não tem exclusão por id de imagem.

Fonte do Windows Terminal

O AX Code não pode mudar a fonte do terminal. Ícones de tipo de arquivo (glifos de uso privado de Nerd Font) só são renderizados no Windows Terminal com uma fonte corrigida instalada. A fonte recomendada é Cascadia Code NF: instale-a e depois defina-a como fonte do perfil em Configurações > Perfis > Aparência > Face da fonte. Uma dica única dentro do aplicativo aponta usuários do Windows Terminal para essa configuração; ela nunca aparece quando os ícones já são renderizados ou quando AX_CODE_NERD_FONT=0 recusa.