Codex Counter

Barra local e discreta para acompanhar o uso do Codex Desktop/CLI.

O projecto lê apenas eventos locais token_count gravados pelo Codex em %USERPROFILE%\.codex\sessions. Não injeta código no Codex Desktop, não altera ficheiros do Codex e não mostra prompts nem respostas.

Funcionalidades

• Barra compacta sempre visível, inspirada no contador do Claude web.
• Percentagem de Session / rate limit.
• Percentagem aproximada de contexto usado no turno actual.
• Tokens do último turno.
• Cor de aviso quando os limites sobem.
• Comando de terminal com resumo completo.
• Dashboard HTML local opcional.

Requisitos

• Windows.
• PowerShell 5.1 ou superior.
• Codex Desktop/CLI com sessões locais em %USERPROFILE%\.codex\sessions.

Instalação

Clone o repo e entre na pasta:

git clone https://github.com/garcialabss/codex-counter.git
cd codex-counter

Se o Windows bloquear scripts PowerShell:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Ou execute apenas esta ferramenta com bypass:

powershell -ExecutionPolicy Bypass -File .\codex-counter-compact.ps1

Uso Recomendado

Abra a barra compacta:

.\codex-counter-compact.ps1

Para testar ao centro do ecrã:

.\codex-counter-compact.ps1 -Center

Para actualizar mais depressa:

.\codex-counter-compact.ps1 -RefreshSeconds 10

A barra mostra apenas:

Session 85% · reset 1h20   Contexto 30%   Turno 79k

Comando de Terminal

Resumo simples:

.\codex-counter.ps1

JSON:

.\codex-counter.ps1 -Json

Modo vivo no terminal:

.\codex-counter.ps1 -Watch

Dashboard HTML local:

.\codex-counter.ps1 -Dashboard

O dashboard é gerado como dashboard.html e é ignorado pelo git por poder conter métricas locais.

Barra Completa

Existe também uma barra maior com cartões:

.\codex-counter-bar.ps1

Para uso diário, a barra compacta é a recomendada.

Privacidade

Esta ferramenta foi desenhada para ser segura para uso local:

• Não lê prompts nem respostas para apresentar na UI.
• Filtra apenas eventos com token_count.
• Não envia dados para nenhum servidor.
• Não modifica ficheiros do Codex.
• Não deve publicar dashboard.html, logs ou capturas com métricas reais se isso for sensível.

Limitações

• Não fica embutida dentro da UI do Codex Desktop. É uma janela flutuante.
• Os campos dependem do formato actual dos logs locais do Codex.
• O valor Session vem dos metadados locais de rate limit; se o Codex mudar esse formato, a ferramenta pode precisar de ajuste.

Licença

MIT. Consulte LICENSE.