Об этом проекте

PokeTokenBar — это приложение для строки меню macOS, которое геймифицирует расход токенов ИИ-кодинга, превращая ваши траты токенов в спутника-покемона. Оно отслеживает использование из Claude Code, Codex, Gemini CLI, Antigravity, OpenCode, Hermes Agent, Cursor, Grok CLI, Copilot CLI, Kiro CLI, Pi Agent, omp и Aside, читая локальные логи напрямую — внешний CLI не нужен. **Основная механика:** - 🥚 **Вылупление**: Сожжённые токены инкубируют яйцо, из которого вылупляется покемон из поколений 1–5 (329 возможных стартов), с весами по официальным показателям поимки — легендарные редки (1 из 129). Каждое вылупление даёт один из 25 характеров с редким шансом на ✨ Shiny. - ⚡ **Эволюция**: Продолжая кодить, вы растите покемона по его реальному дереву эволюции (1/2/3 стадии, с ветвлениями), со вспышками-празднованиями на каждом шаге. - 🎓 **Выпуск и коллекция**: Финальная форма + порог навсегда архивируют его в вашем Покедексе (чем реже, тем дольше: ~3 дня для обычного → ~24 дня для легендарного при интенсивном использовании), и приходит новое яйцо. - 🍬 **Rare Candy**: Заполните 5-часовой или недельный лимит использования, чтобы получить Rare Candy, который можно тратить из Сумки на рост текущего покемона. - 🛒 **Магазин**: Использованные токены — это валюта для Rare Candy, Mint (переброс характера), Shiny Charm (навсегда повышает шансы на shiny) или яиц (Pokémon Egg, Uncommon Egg, Rare Egg), чтобы начать заново. **Возможности:** - **Строка меню**: Анимированный спрайт Gen-V рядом с сегодняшним общим числом токенов (компактный формат вроде `200.7M`), с опциональным отображением стоимости или процента лимита. - **Плавающий питомец на рабочем столе**: Переместите спутника на рабочий стол любого размера (48–384px), с подсказками при наведении, открытием по клику, контекстным меню по правому клику и уведомлениями о лимитах в виде речевого пузыря. - **Покедекс и журнал поимок**: Одна ячейка на вид (24 на страницу, в порядке номера декса, ✨ для shiny), плюс журнал поимок с полными линиями эволюции, редкостью, характером и датой поимки. - **Официальные лимиты**: Отслеживание 5-часовой/недельной загрузки Claude, Codex и Antigravity с обратным отсчётом до сброса и прогнозами скорости расхода. - **Разбивка по моделям**: Использование Pi Agent привязывается к реальным ID моделей, когда несколько моделей делят один лог сессии. - **Настройки**: Элементы строки меню, интервал обновления (1–15 мин или вручную), запуск при входе, отказ от Keychain, уведомления о лимитах с порогами, уведомления о спутнике и полный интерфейс и имена покемонов на KO/EN/JA/ES/FR/PT/DE. - **Сложность роста**: Настройка порогов и цен магазина от 10% до 200%; вылупления из уже выпущенных линий растут в 2× быстрее. - **Дневной график**: Компактный месячный график с токенами (и стоимостью) по дням. - **Дополнительные папки сканирования**: Укажите на логи вне встроенных путей (по провайдеру, с подстановочными знаками). - **Ключ сессии claude.ai**: Опциональная вставка для официальных лимитов без доступа к Keychain. - **Режим низкого энергопотребления**: Анимация в строке меню продолжается в качестве Power saver. - **Обновления в приложении**: Проверка обновлений в один клик. **Поддерживаемые инструменты и отслеживание:** | Инструмент | Отслеживается | Официальные лимиты | |---|---|---| | Claude Code | сегодня · блок 5ч · неделя · месяц | ✅ 5ч / неделя | | Codex | сегодня · неделя · месяц | ✅ 5ч / неделя | | Gemini CLI | сегодня · неделя · месяц | — | | Antigravity | сегодня · блок 5ч · неделя · месяц | ✅ 5ч / неделя | | OpenCode | сегодня · блок 5ч · неделя · месяц | — | | Hermes Agent | сегодня · блок 5ч · неделя · месяц | — | | Cursor | сегодня · блок 5ч · неделя · месяц | — | | Grok CLI | сегодня · блок 5ч · неделя · месяц | — | | Copilot CLI | сегодня · блок 5ч · неделя · месяц | — | | Kiro CLI | сегодня · блок 5ч · неделя · месяц | — (оценочно) | | Pi Agent | сегодня · блок 5ч · неделя · месяц | — | | omp (oh-my-pi) | сегодня · блок 5ч · неделя · месяц | — | | Aside | сегодня · блок 5ч · неделя · месяц | — | **Источники данных:** Читает локальные логи (JSONL, SQLite и т. д.) из стандартных путей каждого инструмента, а также PokéAPI для данных о видах/эволюции и спрайтов (загружаются во время выполнения, кэшируются локально). Официальные лимиты используют неофициальные эндпоинты (Anthropic, codex app-server, Antigravity Google APIs) с доступом к Keychain только при ручном обновлении. **Конфиденциальность:** Приоритет на устройстве — логи использования не загружаются. Исходящие запросы идут к 12 хостам (PokéAPI, спрайты GitHub, Anthropic, claude.ai, cursor.com, Google APIs, страницы статуса, проверка обновлений GitHub), но никогда не несут логи использования, промпты или пути проектов. Keychain опционален и читается только при ручном обновлении. **Установка:** macOS 14+ (Apple Silicon или Intel). Homebrew cask (`brew install --cask chattymin/tap/poke-token-bar`), ручная загрузка zip или сборка из исходников с Swift 6. Ad-hoc/самоподписанное, поэтому предупреждение Gatekeeper при первом запуске (снять через правый клик → Open или `xattr -dr com.apple.quarantine`). **Лицензия:** MIT (покрывает только оригинальный исходный код; ассеты Pokémon не включены — загружаются во время выполнения). Неофициальный некоммерческий фанатский проект по Pokémon.