¿El tema de Codex CLI no se aplica? Soluciónelo en 5 pasos

/theme no devuelve nada, los colores no cambian o la paleta parece incorrecta. Los problemas con los temas de Codex CLI casi siempre se deben a una de cinco causas. A continuación te explicamos cómo diagnosticar y solucionar cada una, en orden.

1. El tema no está instalado (el caso más frecuente)

/theme solo lista los temas que existen en el directorio de temas de Codex CLI. Si nunca ejecutaste un script de instalación, la lista estará vacía o mostrará únicamente el tema predeterminado.

Solución: instala primero una paleta:

curl -fsSL https://raw.githubusercontent.com/vufly/bearded-theme-ports/master/scripts/install-codex.sh | sh

Luego vuelve a abrir el símbolo del sistema y ejecuta /theme nuevamente: la nueva paleta debería aparecer bajo su nombre exacto.

2. Caché de colores obsoleta al inicio

Algunos puertos almacenan en caché los colores al iniciar Codex CLI. Tras aplicar un tema, la paleta puede verse incorrecta hasta el siguiente lanzamiento.

Solución: reinicia Codex CLI tras aplicar el tema y luego vuelve a ejecutar /theme con el mismo nombre. Si aparece la paleta correcta, entonces la caché era el problema.

3. El nombre del tema no coincide

/theme compara los nombres de los temas de forma exacta. Tokyo Night no es lo mismo que tokyo-night ni TokyoNight.

Solución: ejecuta /theme sin argumentos y copia el nombre exacto de la lista; luego aplícalo tal cual.

4. Archivo de paleta incorrecto o incompleto

Una paleta copiada desde un script de portabilidad puede estar incompleta: faltan claves como fondo, primer plano o sintaxis. Esto se manifiesta como colores mayoritariamente predeterminados, con uno o dos cambios únicamente.

Solución: vuelve a ejecutar el script de instalación para obtener la paleta completa, o usa un gestor para validar el archivo:

# Codex Themes CLI valida la paleta antes de aplicarla:
codex-theme validate <name>
codex-theme apply <name>

5. Desincronización entre terminal y CLI

Si la terminal muestra los colores correctamente pero Codex CLI no (o viceversa), ambos están leyendo configuraciones distintas. Los temas de CLI son simplemente paletas: no modifican el perfil de tu terminal.

Solución: exporta la misma paleta a ambos entornos. Codex Themes CLI puede escribir los colores idénticos en el perfil de tu terminal, de modo que una sola aplicación sincronice ambas superficies:

codex-theme export <name> --to-terminal

¿Sigues atascado?

Restablece un estado limpio: desinstala la paleta, reinicia, vuelve a instalarla y aplícala usando su nombre exacto. Si un tema específico presenta problemas, explora la categoría Mono & Terminal para encontrar las últimas variantes de paletas, o consulta la guía de temas para Codex CLI para conocer el flujo completo de instalación.