Entorno de terminal en Windows

La consola tradicional de Windows (cmd.exe / conhost) no incluye por defecto glifos de emoji ni de iconos Nerd Font ni admite color real, así que zqagent se muestra aquí en modo degradado: ✅ pasa a [OK], los bordes de tabla caen a ASCII y los colores se ven apagados. La funcionalidad no cambia, pero la experiencia dista de Linux / macOS.

Esta página ofrece la configuración recomendada y la guía automática integrada en zqagent.

Configuración recomendada

Nivel	Recomendación	Notas
Terminal	Windows Terminal	Color real, aceleración GPU, pestañas y paneles; admite cmd / PowerShell / WSL a la vez
Fuente	Nerd Font (monoespaciada)	Completa los glifos de iconos, p. ej. JetBrainsMono Nerd Font
Shell	PowerShell 7 o Git Bash	Experiencia de scripting más cercana a Linux
Prompt	oh-my-posh / starship	Prompt con iconos y estado de git

1. Instalar Windows Terminal

Opción A (recomendada; Win10 1809+ incluye winget):

winget install --id Microsoft.WindowsTerminal -e --accept-source-agreements --accept-package-agreements

Opción B: abre «Microsoft Store», busca Windows Terminal e instálalo.

2. Instalar Nerd Font

winget install --id DEVCOM.JetBrainsMonoNerdFont -e --accept-source-agreements --accept-package-agreements

Puedes usar cualquier fuente equivalente (consulta los nombres con winget search nerd): CaskaydiaCove Nerd Font, FiraCode Nerd Font, Hack Nerd Font. También puedes descargarla de la web oficial de Nerd Fonts y, tras descomprimir, hacer clic derecho en el archivo de fuente → «Instalar para todos los usuarios».

Nota: Nerd Font no es lo mismo que JetBrains Mono normal. Tras instalarla, elige en la terminal la que lleva el sufijo Nerd Font; si no, los iconos seguirán viéndose como cuadrados.

3. Establecerla como terminal predeterminada

Windows Terminal → Ajustes → Inicio → «Aplicación de terminal predeterminada» → Windows Terminal. Desde entonces, al iniciar desde cmd.exe / PowerShell también se abrirá Windows Terminal.

4. Elegir la fuente en Windows Terminal

Ajustes → Perfiles → Valores predeterminados → Apariencia → Fuente → JetBrainsMono Nerd Font.

También puedes editar settings.json directamente:

{
  "profiles": {
    "defaults": {
      "font": { "face": "JetBrainsMono Nerd Font", "size": 11 }
    }
  }
}

5. Mejorar el shell (opcional)

winget install --id Microsoft.PowerShell -e      # PowerShell 7
winget install --id JanDeDobbeleer.OhMyPosh -e   # prompt oh-my-posh

Comportamiento de zqagent

• Al arrancar detecta las capacidades de la terminal: si no admite emoji / Unicode, degrada su salida a marcas ASCII (✅→[OK], ❌→[x], ⚠️→[!]) y las tablas Markdown pasan a bordes ASCII.
• Al detectar una consola tradicional ofrece una guía activa: primero pregunta si quieres que el agent instale automáticamente con winget Windows Terminal y Nerd Font (cada comando pasa por aprobación); si no se puede instalar o aún no hay conexión LLM, muestra el tutorial de instalación manual.
• Variables de entorno relacionadas:

Variable	Efecto
ZQAGENT_TERM_SETUP=0	Desactiva la guía de entorno de terminal al arrancar
ZQAGENT_TERM_SETUP=1	Fuerza la guía (útil para previsualizar el tutorial)
ZQAGENT_EMOJI=1/0	Fuerza activar / desactivar emoji y tablas Unicode
ZQAGENT_ASCII=1	Fuerza la degradación a marcas ASCII

Solución de problemas

Síntoma	Solución
No existe winget	Instala «Instalador de aplicaciones» (App Installer) desde «Microsoft Store», o usa la opción B
Los iconos siguen como cuadrados	La fuente elegida en la terminal no es la de Nerd Font
Los emoji se ven como ?	Comprueba que se ejecuta en Windows Terminal y que ZQAGENT_EMOJI no es 0
Colores apagados	conhost no admite color real; cambia a Windows Terminal

Siguiente paso

• Uso de la CLI
• Herramientas integradas