Об этом проекте
Vole — локальный монитор использования, затрат и аномалий для ИИ-агентов, пишущих код. Он рассчитан на разработчиков, которые запускают несколько агентов параллельно и хотят видеть не только расходы, но и признаки некорректного поведения агента.
Приложение работает на macOS 26+ для Apple silicon и размещается в строке меню. Оно читает логи, которые инструменты уже записывают на диск, приводит их к общей схеме и сохраняет все данные локально: без облачных API, без аккаунта и без хранения содержимого промптов или инструментов. Требуется только необязательное разрешение на уведомления; доступ ко всему диску не запрашивается, поскольку источники — локальные dotfiles и файлы application support.
Поддерживаются несколько инструментов, включая Claude Code, OpenCode, Codex CLI, Grok CLI, Cursor, Devin и Antigravity. Различаются уровни достоверности данных: точные значения, считанные напрямую из логов инструментов; детерминированные оценки с записанным методом; и строки только об активности, когда инструмент фиксирует вызов, но недостаточно деталей для измерения токенов. Итоги указывают, какие уровни в них входят, а неизвестные модели возвращают NULL, а не угадываются.
Дашборд показывает основные показатели токенов и затрат, спарклайн, столбцы по инструментам и таймлайн с пометками инцидентов. Таймлайн складывает токены по инструментам и отмечает инциденты, что упрощает анализ всплесков и их причин. Элемент в строке меню может показывать живые токены, затраты или просто статусный маркер и подсвечивается, пока инцидент открыт.
Обнаружение аномалий включает правила для всплесков billable burn, повторяющихся циклов вызовов, штормов ошибок, давления rate-limit и давления контекста. Базовые линии строятся методом leave-one-out, чтобы отдельный всплеск не скрывался внутри собственной базовой линии. Обнаружение циклов сочетает объем вызовов, плоский вывод и рост чтений из кэша, чтобы снизить ложные срабатывания.
Стоимость рассчитывается как эквивалент API по прайс-листу, а не по подписке. Тарифы хранятся как версионированные данные, могут переопределяться для конкретной установки, а неизвестные модели остаются null. Команда верификации независимо пересчитывает сохраненные строки из исходных записей, чтобы находить ошибки ценообразования или разбора.
В проект также входят CLI-команды для живых сессий, дайджестов, таблиц использования по PR, статусных строк, результатов оптимизации, бюджетных лимитов, эффективности моделей и проверок состояния. MCP-сервер предоставляет тем же локальным данным доступ агентам, позволяя агенту запрашивать стоимость собственной сессии, использование контекста и статус инцидентов. Бюджетные лимиты могут применяться через поддерживаемые hooks, где они доступны, и остаются рекомендательными для инструментов без поддержки hooks.
Известные ограничения включают ограниченные локальные данные о токенах для Devin и Antigravity, частично выводимые времена сообщений Cursor, недавнее отсутствие локальных подсчетов токенов в Cursor, покрытие только API-ошибок, нижние границы скорости генерации для некоторых инструментов и разрешение контекстного окна только для first-party идентификаторов моделей.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.