Repolode
Enviar
JingbiaoMei

JingbiaoMei/Tokdash

Dashboard local que acompanha o uso de tokens, os custos por sessão e as janelas de cota de assinaturas em agentes de programação com IA, como Claude Code, Codex e OpenCode.

Ver no GitHubSite
Estrelas
92
Forks
21
Issues abertas
8
Último commit
ontem

O que é?

Tokdash é um dashboard local de tokens e custos para ferramentas de programação com IA. Ele lê os logs de sessão que clientes como Claude Code, Codex, OpenCode e Gemini CLI gravam na sua máquina e mostra detalhamentos exatos dos tokens de entrada, cache e saída, análises detalhadas por sessão e custos estimados.

Os mesmos dados locais alimentam quatro visualizações: uma WebUI servida pelo FastAPI, com mapas de calor e relatórios semanais, mensais e anuais; um dashboard de terminal iniciado com `tokdash tui`; um app complementar nativo para a barra de menus do macOS e a área de notificação do Windows; e um item de statusline que pode aparecer na barra de prompt de um agente. Os custos são calculados com base em um banco de dados de preços incluído, que pode ser substituído localmente.

O acompanhamento de cotas é opcional. As janelas móveis do Codex são estimadas com base nos logs locais, enquanto as janelas de assinatura de outros provedores exigem a ativação explícita da consulta periódica em tempo real, usando a sessão que sua CLI já tem. A instalação é feita via pipx, com o comando `tokdash setup`, que registra um serviço local em segundo plano.

Recursos principais

  • 01Detalhamento exato dos tokens de entrada, cache e saída por sessão, ferramenta e modelo.
  • 02Mapa de calor de contribuições e relatórios de uso semanais, mensais ou anuais, exportáveis como PNG.
  • 03Aba de cotas com barras das janelas de assinatura e contagem regressiva para a redefinição em vários provedores.
  • 04Dashboard de terminal com sete painéis, incluindo Overview, Sessions, Quota e Pricing.
  • 05Integração com statusline e app complementar nativo para macOS e Windows.
  • 06Permite combinar o uso de várias instâncias do Tokdash executadas em máquinas diferentes.

Casos de uso

  • Verificar quanto os agentes de programação com IA de uma equipe gastam por dia ou mês.
  • Comparar em uma única tela o uso de tokens do Claude Code, Codex e outros agentes.
  • Acompanhar quando as cotas de assinatura serão redefinidas sem abrir um navegador.
  • Evitar que o histórico local dos agentes seja apagado pelas configurações de retenção dos clientes.

Início rápido

  1. 1

    Instale o pacote com pipx

    pipx install tokdash
  2. 2

    Execute setup para registrar o serviço local e obter a URL do painel

    tokdash setup

Antes de usar

  • O acompanhamento de cotas é opcional e requer configuração adicional para cada provedor.
  • Requer Python 3.10 ou mais recente.

Em coleções

Ferramentas, skills e plugins para Claude CodeAssistentes e agentes de programação com IAFerramentas de CLI e terminalPainéis e ferramentas de business intelligencePlataformas de OpenTelemetry e observabilidade

Tópicos

#token-usage#ai-coding#dashboard#cost-tracking#claude-code#codex#observability#cli#agent#analytics

Perguntas frequentes

O que é Tokdash?
Dashboard local que acompanha o uso de tokens, os custos por sessão e as janelas de cota de assinaturas em agentes de programação com IA, como Claude Code, Codex e OpenCode. Tokdash é um dashboard local de tokens e custos para ferramentas de programação com IA. Ele lê os logs de sessão que clientes como Claude Code, Codex, OpenCode e Gemini CLI gravam na sua máquina e mostra detalhamentos exatos dos tokens de entrada, cache e saída, análises detalhadas por sessão e custos estimados.
Tokdash é gratuito? Qual é a licença?
Tokdash é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
Tokdash ainda é mantido?
Manutenção ativa. O último commit de Tokdash foi em 6 de nov. de 2026.
Para que posso usar Tokdash?
Verificar quanto os agentes de programação com IA de uma equipe gastam por dia ou mês. Comparar em uma única tela o uso de tokens do Claude Code, Codex e outros agentes. Acompanhar quando as cotas de assinatura serão redefinidas sem abrir um navegador. Evitar que o histórico local dos agentes seja apagado pelas configurações de retenção dos clientes.
Como instalar Tokdash?
Instale o pacote com pipx: pipx install tokdash Execute setup para registrar o serviço local e obter a URL do painel: tokdash setup
Onde consigo Tokdash?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/JingbiaoMei/Tokdash

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados