Sobre el proyecto
PokeTokenBar es una app de barra de menús de macOS que gamifica el uso de tokens de codificación con IA convirtiendo tu gasto de tokens en un compañero Pokémon. Rastrea el uso de Claude Code, Codex, Gemini CLI, Antigravity, OpenCode, Hermes Agent, Cursor, Grok CLI, Copilot CLI, Kiro CLI, Pi Agent, omp y Aside leyendo registros locales directamente; no se necesita CLI externo.
**Mecánicas principales:**
- 🥚 **Eclosionar**: Los tokens que consumes incuban un huevo que eclosiona en un Pokémon de la Gen 1–5 (329 inicios posibles), ponderado por las tasas oficiales de captura; los legendarios son raros (1 de cada 129). Cada eclosión genera una de 25 naturalezas, con una probabilidad rara de ✨ Shiny.
- ⚡ **Evolucionar**: Seguir programando hace crecer tu Pokémon por su árbol de evolución real (1/2/3 etapas, con ramificaciones), con celebraciones relámpago en cada paso.
- 🎓 **Graduarse y coleccionar**: La forma final + el umbral lo archivan permanentemente en tu Pokédex (los más raros tardan más: ~3 días común → ~24 días legendario con uso intenso), y llega un huevo nuevo.
- 🍬 **Caramelo Raro**: Llena un límite de uso de 5 horas o semanal para ganar Caramelo Raro, que puedes gastar desde la Bolsa para hacer crecer tu Pokémon actual.
- 🛒 **Tienda**: Los tokens que has usado son moneda para Caramelo Raro, una Menta (reroll de naturaleza), un Amuleto Shiny (aumenta permanentemente las probabilidades de shiny) o huevos (Huevo Pokémon, Huevo Poco Común, Huevo Raro) para empezar de nuevo.
**Características:**
- **Barra de menús**: Sprite animado de Gen-V junto al total de tokens de hoy (formato compacto como `200.7M`), con visualización opcional de coste o porcentaje del límite.
- **Mascota flotante de escritorio**: Mueve tu compañero al escritorio a cualquier tamaño (48–384px), con avisos al pasar el cursor, clic para abrir, menú contextual y alertas de límite en burbuja de diálogo.
- **Pokédex y registro de capturas**: Una celda por especie (24 por página, orden por número de dex, ✨ para shinies), más un registro de capturas con líneas evolutivas completas, rareza, naturaleza y fecha de captura.
- **Límites oficiales**: Rastrea la utilización de 5 horas/semanal de Claude, Codex y Antigravity con cuentas atrás de reinicio y previsiones de ritmo de consumo.
- **Desglose por modelo**: Uso de Pi Agent atribuido a IDs de modelo reales cuando varios modelos comparten un registro de sesión.
- **Ajustes**: Elementos de la barra de menús, intervalo de actualización (1–15 min o manual), iniciar al arrancar, exclusión del Llavero, alertas de límite con umbrales, notificaciones del compañero e interfaz completa en KO/EN/JA/ES/FR/PT/DE y nombres de Pokémon.
- **Dificultad de crecimiento**: Ajusta umbrales y precios de la tienda del 10% al 200%; las eclosiones de líneas ya graduadas crecen 2× más rápido.
- **Gráfico diario**: Gráfico mensual compacto que muestra tokens (y coste) por día.
- **Carpetas de escaneo adicionales**: Apunta a registros fuera de las rutas integradas (por proveedor, con comodines).
- **Clave de sesión de claude.ai**: Pegado opcional para límites oficiales sin acceso al Llavero.
- **Modo de bajo consumo**: La animación de la barra de menús continúa con calidad de ahorro de energía.
- **Actualizaciones en la app**: Comprobación de actualizaciones con un clic.
**Herramientas compatibles y seguimiento:**
| Herramienta | Rastreado | Límites oficiales |
|---|---|---|
| Claude Code | hoy · bloque de 5h · semana · mes | ✅ 5h / semanal |
| Codex | hoy · semana · mes | ✅ 5h / semanal |
| Gemini CLI | hoy · semana · mes | — |
| Antigravity | hoy · bloque de 5h · semana · mes | ✅ 5h / semanal |
| OpenCode | hoy · bloque de 5h · semana · mes | — |
| Hermes Agent | hoy · bloque de 5h · semana · mes | — |
| Cursor | hoy · bloque de 5h · semana · mes | — |
| Grok CLI | hoy · bloque de 5h · semana · mes | — |
| Copilot CLI | hoy · bloque de 5h · semana · mes | — |
| Kiro CLI | hoy · bloque de 5h · semana · mes | — (estimado) |
| Pi Agent | hoy · bloque de 5h · semana · mes | — |
| omp (oh-my-pi) | hoy · bloque de 5h · semana · mes | — |
| Aside | hoy · bloque de 5h · semana · mes | — |
**Fuentes de datos:** Lee registros locales (JSONL, SQLite, etc.) de las rutas estándar de cada herramienta, además de PokéAPI para datos de especies/evolución y sprites (obtenidos en tiempo de ejecución, almacenados en caché localmente). Los límites oficiales usan endpoints no oficiales (Anthropic, codex app-server, APIs de Google de Antigravity) con acceso al Llavero solo en la actualización manual.
**Privacidad:** Primero en el dispositivo: no se sube el uso. Las solicitudes salientes van a 12 hosts (PokéAPI, sprites de GitHub, Anthropic, claude.ai, cursor.com, APIs de Google, páginas de estado, comprobación de actualizaciones de GitHub) pero nunca llevan registros de uso, prompts ni rutas de proyecto. El Llavero es opcional y solo se lee en la actualización manual.
**Instalación:** macOS 14+ (Apple Silicon o Intel). Cask de Homebrew (`brew install --cask chattymin/tap/poke-token-bar`), descarga manual del zip o compilación desde el código fuente con Swift 6. Ad-hoc/autofirmado, por lo que aparece una advertencia de Gatekeeper en el primer inicio (se elimina con clic derecho → Abrir o `xattr -dr com.apple.quarantine`).
**Licencia:** MIT (cubre solo el código fuente original; los recursos de Pokémon no están incluidos: se obtienen en tiempo de ejecución). Proyecto fan de Pokémon no oficial y no comercial.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.