TokenLens
Painel que mostra, em tempo real, quantos tokens cada sessão do Claude Code, do Codex e do pi está gastando. Roda só na sua máquina: sem nuvem, sem telemetria e sem conexão externa.
- Papel
- Autor
- Onde
- Projeto pessoal, open source (MIT)
- Período
- 09/2026 – atual
- Stack
- TypeScript · React · Fastify · Node.js 24 · SQLite · Electron
Desafio
Claude Code, Codex e pi já gravam cada conversa em arquivos .jsonl no meu diretório pessoal. Faltava ler esses registros enquanto a sessão roda e ver o gasto por sessão e por projeto, sem mandar nada para fora da máquina.
- Ver, em tempo real, quantos tokens cada sessão do Claude Code, do Codex e do pi está gastando.
- Saber quando o contexto de uma sessão passa de 100 mil tokens.
- O formato dos .jsonl não é API pública de nenhum dos três agentes e pode mudar sem aviso.
Abordagem
O TokenLens só lê esses arquivos. Ele acompanha o que é acrescentado, soma os tokens por sessão e manda a atualização na hora para o navegador. Por trás, um processo Node com Fastify e SQLite embutido; o painel é em React.
- Só lê os .jsonl que os agentes já gravam no disco.
- Não intercepta chamadas: não é proxy da API e não precisa de chave.
- A API só escuta em localhost; sem CDN, telemetria ou script de terceiros.
- Painel no navegador ou app de desktop (Windows e Linux).
Resultado
Publiquei três releases entre 29 e 30 de setembro de 2026, com instalador para Windows e AppImage para Linux. Na última, o painel passou a mostrar para onde vai o custo e a avisar quando o contexto de uma sessão passa de 100 mil tokens.
- Cada resposta aparece no painel em até meio segundo.
- Um único processo Node, cerca de 190 MB.
- Com o cache de totais, a próxima subida leva menos de 1 segundo.
- Open source, licença MIT.
