O que é o Codenotch
Se você usa Claude Code, Cursor, Codex ou outras ferramentas de IA para programar, sabe a sensação de descobrir que bateu o limite de uso só quando o assistente já parou de responder. O Codenotch resolve isso: é um app que fica discretamente pinado numa borda da tela (Mac) — ou numa janela leve (Windows) — mostrando, em tempo real, quanto de cada limite você já usou.
Passe o mouse num anel e ele mostra a janela daquele limite e quando ela reseta. No Claude, é a mesma janela de sessão atual que o próprio /usage do Claude Code mostra, então os dois números nunca ficam desalinhados.
Quais ferramentas ele monitora
O app lê os dados oficiais (ou o mais próximo disso) de cada provedor:
| Ferramenta | Como ele lê |
|---|---|
| Claude Code | Cache do Claude Desktop, depois o /usage do Claude Code instalado, depois o token do keychain |
| Cursor | Sessão local do editor ou login do cursor-agent |
| Codex | Login local do Codex; mostra limite de 5h e semanal |
| Antigravity | Endpoint oficial quando licenciado, senão uma contagem simples |
| GitHub Copilot | Sessão da GitHub CLI (gh auth login) |
| Ollama / LM Studio (local) | Detecção automática dos modelos carregados, RAM/VRAM e velocidade |
Também há suporte a DeepSeek, GLM, MiniMax, Grok, OpenCode, Command Code e Kimi. Cada provedor pode ser ligado ou desligado individualmente nas configurações.
Instalando no Mac
- Baixe o
Codenotch.dmgdireto na página do projeto — o link sempre aponta para a versão mais recente. - Arraste o app para a pasta Aplicativos.
- Se o macOS avisar que o app está
danificado, na verdade é só a flag de quarentena. Rode no Terminal:
xattr -dr com.apple.quarantine /Applications/Codenotch.app
Funciona em macOS 15 ou mais recente, binário universal (Intel e Apple Silicon). O app se atualiza sozinho depois disso.
Instalando no Windows
- Baixe o instalador
Codenotch-Setup.exena mesma página. - Como o instalador ainda não é assinado digitalmente, o Windows SmartScreen vai avisar "O Windows protegeu o seu PC". Clique em Mais informações e depois em Executar assim mesmo.
- A instalação não exige permissão de administrador e baixa o WebView2 automaticamente, se faltar.
O que dá para fazer com ele
- Alertas automáticos: quando um limite cruza 80% e 100%, o macOS/Windows dispara uma notificação — uma vez por cruzamento, sem repetir enquanto continuar acima.
- Status da sessão: um anel gira enquanto a IA está trabalhando e pulsa quando está esperando uma resposta sua; clicar nele traz o app correto para a frente.
- Ligar o celular: em Configurações › Telefone, um QR code de 5 minutos conecta o app do celular (iOS/Android) para ver os mesmos números — só na mesma rede Wi-Fi, nunca pela internet.
- Contas separadas: se você usa mais de uma conta de Claude Code ou Codex (perfis
~/.claude-work, por exemplo), cada uma ganha seu próprio anel. - Aparência: escolha a borda da tela, o tamanho do indicador, a cor do destaque e se ele some quando não está em uso.
É seguro?
O projeto é open source (licença MIT) e o próprio README detalha, provedor por provedor, de onde vem cada dado. Ele nunca lê tokens, senhas ou o conteúdo dos seus prompts — só números de uso que os próprios apps (Claude Desktop, Cursor, Codex etc.) já expõem localmente. Quando algo falha, o app mostra um status visível (desatualizado, precisa logar, erro) em vez de inventar uma porcentagem.
