Sobre o projeto
O PokeTokenBar é um app de barra de menus do macOS que gamifica o uso de tokens de codificação por IA, transformando seu gasto de tokens em um companheiro Pokémon. Ele rastreia o uso do Claude Code, Codex, Gemini CLI, Antigravity, OpenCode, Hermes Agent, Cursor, Grok CLI, Copilot CLI, Kiro CLI, Pi Agent, omp e Aside lendo logs locais diretamente — sem necessidade de CLI externa.
**Mecânicas principais:**
- 🥚 **Chocar**: Os tokens que você queima incubam um ovo que choca em um Pokémon da Gen 1–5 (329 iniciais possíveis), ponderado pelas taxas oficiais de captura — lendários são raros (1 em 129). Cada chocada sorteia uma de 25 naturezas, com chance rara de um ✨ Shiny.
- ⚡ **Evoluir**: A codificação contínua faz seu Pokémon crescer por sua árvore de evolução real (1/2/3 estágios, com ramificações), com celebrações relâmpago em cada etapa.
- 🎓 **Graduar e colecionar**: Forma final + limite arquiva permanentemente o Pokémon na sua Pokédex (mais raro leva mais tempo: ~3 dias comum → ~24 dias lendário em uso intenso), e um novo ovo chega.
- 🍬 **Doce Raro**: Preencha um limite de uso de 5 horas ou semanal para ganhar Doce Raro, gastável na Bolsa para fazer crescer seu Pokémon atual.
- 🛒 **Loja**: Os tokens que você usou são moeda para Doce Raro, uma Menta (re-sorteia a natureza), um Amuleto Shiny (aumenta permanentemente as chances de shiny) ou ovos (Ovo Pokémon, Ovo Incomum, Ovo Raro) para recomeçar.
**Recursos:**
- **Barra de menus**: Sprite animado da Gen-V ao lado do total de tokens de hoje (formato compacto como `200.7M`), com exibição opcional de custo ou porcentagem do limite.
- **Pet flutuante na área de trabalho**: Mova seu companheiro para a área de trabalho em qualquer tamanho (48–384px), com balões ao passar o mouse, clique para abrir, menu de clique direito e alertas de limite em balão de fala.
- **Pokédex e registro de capturas**: Uma célula por espécie (24 por página, em ordem de número da dex, ✨ para shinies), além de um registro de capturas com linhas de evolução completas, raridade, natureza e data de captura.
- **Limites oficiais**: Acompanhe a utilização de 5 horas/semanal do Claude, Codex e Antigravity com contagens regressivas de reset e previsões de taxa de consumo.
- **Detalhamento por modelo**: Uso do Pi Agent atribuído a IDs de modelos reais quando vários modelos compartilham um log de sessão.
- **Configurações**: Itens da barra de menus, intervalo de atualização (1–15 min ou manual), iniciar ao fazer login, opt-out do Keychain, alertas de limite com limites, notificações do companheiro e interface completa em KO/EN/JA/ES/FR/PT/DE e nomes de Pokémon.
- **Dificuldade de crescimento**: Ajuste limites e preços da loja de 10% a 200%; chocadas de linhas já graduadas crescem 2× mais rápido.
- **Gráfico diário**: Gráfico mensal compacto mostrando tokens (e custo) por dia.
- **Pastas de varredura adicionais**: Aponte para logs fora dos caminhos integrados (por provedor, com curingas).
- **Chave de sessão do claude.ai**: Colagem opcional para limites oficiais sem acesso ao Keychain.
- **Modo de Baixo Consumo**: A animação da barra de menus continua com qualidade de economia de energia.
- **Atualizações no app**: Verificação de atualização com um clique.
**Ferramentas suportadas e rastreamento:**
| Ferramenta | Rastreado | Limites oficiais |
|---|---|---|
| Claude Code | hoje · bloco de 5h · semana · mês | ✅ 5h / semanal |
| Codex | hoje · semana · mês | ✅ 5h / semanal |
| Gemini CLI | hoje · semana · mês | — |
| Antigravity | hoje · bloco de 5h · semana · mês | ✅ 5h / semanal |
| OpenCode | hoje · bloco de 5h · semana · mês | — |
| Hermes Agent | hoje · bloco de 5h · semana · mês | — |
| Cursor | hoje · bloco de 5h · semana · mês | — |
| Grok CLI | hoje · bloco de 5h · semana · mês | — |
| Copilot CLI | hoje · bloco de 5h · semana · mês | — |
| Kiro CLI | hoje · bloco de 5h · semana · mês | — (estimado) |
| Pi Agent | hoje · bloco de 5h · semana · mês | — |
| omp (oh-my-pi) | hoje · bloco de 5h · semana · mês | — |
| Aside | hoje · bloco de 5h · semana · mês | — |
**Fontes de dados:** Lê logs locais (JSONL, SQLite, etc.) dos caminhos padrão de cada ferramenta, além da PokéAPI para dados de espécies/evolução e sprites (buscados em tempo de execução, armazenados em cache localmente). Limites oficiais usam endpoints não oficiais (Anthropic, codex app-server, APIs do Google do Antigravity) com acesso ao Keychain apenas na atualização manual.
**Privacidade:** Prioridade no dispositivo — nenhum upload de uso. Requisições de saída vão para 12 hosts (PokéAPI, sprites do GitHub, Anthropic, claude.ai, cursor.com, APIs do Google, páginas de status, verificação de atualização do GitHub), mas nunca carregam logs de uso, prompts ou caminhos de projeto. O Keychain é opcional e só é lido na atualização manual.
**Instalação:** macOS 14+ (Apple Silicon ou Intel). Cask do Homebrew (`brew install --cask chattymin/tap/poke-token-bar`), download manual do zip ou compilação a partir do código-fonte com Swift 6. Ad-hoc/autoassinado, então há aviso do Gatekeeper na primeira execução (contorne com clique direito → Abrir ou `xattr -dr com.apple.quarantine`).
**Licença:** MIT (cobre apenas o código-fonte original; os assets de Pokémon não são incluídos — buscados em tempo de execução). Projeto de fã de Pokémon não oficial e não comercial.
Comments
0 people shared their preference · Deer Point appears after 10 participants
Sign in to join the discussion.