Tema do Codex CLI não está sendo aplicado? Corrija em 5 passos

O comando /theme não retorna nada, as cores não mudam ou a paleta parece incorreta? Problemas com temas do Codex CLI quase sempre se devem a uma das cinco causas listadas abaixo. Veja como diagnosticar e corrigir cada uma delas, na ordem apresentada.

1. O tema não está instalado (o caso mais comum)

O comando /theme lista apenas temas que existem no diretório de temas do Codex CLI. Se você nunca executou um script de instalação, a lista estará vazia ou mostrará apenas o tema padrão.

Solução: instale primeiro uma paleta:

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

Em seguida, reabra o prompt e execute /theme novamente — a nova paleta deverá aparecer com seu nome exato.

2. Cache de cores desatualizado na inicialização

Alguns ports armazenam em cache as cores no momento da inicialização do Codex CLI. Após aplicar um tema, a paleta pode parecer incorreta até a próxima execução do programa.

Solução: reinicie o Codex CLI após aplicar o tema e execute novamente /theme com o mesmo nome. Se a paleta correta for exibida, o cache era o problema.

3. O nome do tema não corresponde exatamente

O comando /theme faz correspondência exata com os nomes dos temas. Tokyo Night não é o mesmo que tokyo-night ou TokyoNight.

Solução: execute /theme sem argumentos, copie o nome exato da lista exibida e aplique-o textualmente.

4. Arquivo de paleta incorreto ou incompleto

Uma paleta copiada de um script de porting pode estar incompleta — faltando chaves como background, foreground ou syntax. Isso resulta em cores majoritariamente padrão, com apenas uma ou duas alterações visíveis.

Solução: execute novamente o script de instalação para obter a paleta completa, ou use um gerenciador para validar o arquivo:

# O Codex Themes CLI valida a paleta antes de aplicá-la:
codex-theme validate <name>
codex-theme apply <name>

5. Terminal e CLI fora de sincronia

Se o terminal estiver correto, mas o Codex CLI não (ou vice-versa), os dois estão lendo configurações diferentes. Temas do CLI são apenas paletas — eles não alteram seu perfil de terminal.

Solução: exporte a mesma paleta para ambos. O Codex Themes CLI pode gravar exatamente as mesmas cores no seu perfil de terminal, de modo que uma única aplicação sincronize ambas as superfícies:

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

Ainda com dificuldades?

Redefina o estado para algo limpo: desinstale a paleta, reinicie o aplicativo, reinstale-a e aplique-a usando exatamente o nome correto. Se um tema específico estiver com problemas, explore a categoria Mono & Terminal para obter as versões mais recentes das paletas, ou consulte o guia de temas para Codex CLI para conhecer todo o fluxo de instalação.