Orbit Counter

Conexão e limites

O Orbit localiza o Codex CLI no PATH e inicia codex app-server --stdio sem shell. O login ChatGPT é feito pelo próprio Codex, por ação explícita do usuário; o Orbit não lê credenciais nem pede API key.

Os percentuais exibidos são limites oficiais retornados pelo Codex App Server. Tokens locais não são convertidos em porcentagem ou custo. Dependendo do plano, o limite do Codex pode compartilhar a cota de recursos agentic compatíveis da conta ChatGPT.

Se aparecer “Codex CLI não encontrado”, instale ou atualize o Codex CLI, confirme que codex funciona em um novo terminal e reinicie o Orbit Counter.

Widget local para Windows que mostra os limites de uso informados pelo Codex App Server. O nome do produto é Orbit Counter; Codex é apenas a integração suportada.

Requisitos

• Windows 10/11
• Codex CLI instalado e autenticado com uma conta ChatGPT (codex login)
• Node.js 20+

Instalação

Depois de clonar ou baixar este repositório, abra o PowerShell na pasta raiz do projeto. Com o Node.js 20 LTS instalado e conexão com a internet, instale as dependências registradas no repositório:

npm ci

O comando usa o package-lock.json para instalar as versões exatas. As pastas node_modules, dist, dist-test e release não fazem parte do repositório; elas são criadas localmente quando necessárias.

Verifique a instalação e gere o executável com:

npm test
npm run dist

O executável portátil será criado em release\Orbit Counter.exe. Na primeira execução, o npm e o Electron baixam as dependências necessárias.

Para testar o aplicativo durante o desenvolvimento, execute:

npm start

Para usar o Orbit Counter, instale o Codex CLI e autentique a sua conta ChatGPT:

codex login

Desenvolvimento

npm install
npm test
npm start
npm run dist

Versão e commits

A versão em package.json é a versão distribuída pelo Electron e exibida no painel. Depois de executar npm run setup:hooks, o hook incrementa automaticamente a versão SemVer como no LouvaFit: novo arquivo de código sobe MINOR; alteração em código existente sobe PATCH; PATCH 10 carrega MINOR e MINOR 10 carrega MAJOR. Mudanças só de documentação e assets não recebem bump.

Para publicar uma versão, envie primeiro o commit e depois a tag correspondente: git tag vX.Y.Z; git push origin vX.Y.Z. O GitHub Actions executa os testes, gera o .exe e cria a Release. A aba Atualizações consulta as Releases oficiais uma vez a cada 24 horas.

Para separar contribuições de agentes no GitHub, configure antes a coautoria local do Codex (a conta-bot e seu e-mail verificado precisam existir):

git config --local orbit.codexCoauthor "codex-bot@users.noreply.github.com"

Commits feitos pelo Codex usam Co-authored-by: Codex <e-mail-configurado>; o Claude Code mantém seu rodapé Co-authored-by próprio. Confira o histórico com npm run commits:agents.

O app inicia codex app-server --stdio sem shell e usa somente as operações de leitura de conta, limites, uso e login ChatGPT. Para a origem e semântica dos campos, consulte o App Server oficial.

Privacidade

Orbit Counter não lê ~/.codex/auth.json, não aceita API keys e não envia telemetria. O histórico de percentuais fica no diretório local de dados do Electron. A indexação de sessões extrai somente ID, data e nome-base do projeto; prompts, código e payloads não são armazenados.