Codex Usage Tracker — плагин
Плагин и MCP-инструменты показывают, куда в Codex уходят токены, время, кредиты и деньги, по локальным метаданным сессий.
- 196 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Плагин читает локальные метаданные сессий Codex и держит базу на диске.
Установка
- Работает в
Ручная установка
pipx install "codex-usage-tracking==0.28.0"Первый шаг README: Python-часть в изолированном окружении.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Плагин читает локальные метаданные сессий Codex и держит базу на диске.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Codex Usage Tracker превращает локальные метаданные сессий Codex в точные проверяемые факты о том, как работа расходует токены, время, инструменты, лимит доступа, кредиты и стоимость. Агент задает вопросы через MCP и получает компактные выборки со стабильными ссылками на свидетельства, а объяснение строит сам. Текущая версия 0.28.0 держит шесть MCP-инструментов, Evidence Console и ядро на SQLite. Python-часть ставится через pipx, а плагин подключается из репозитория как маркетплейс Codex и запускает исполняемый файл `codex-usage-tracker`. Все данные остаются на вашей машине.
Для кого. Пользователям Codex, которые разбираются, почему сессия съела лимит или кредиты, и хотят ответ с цифрами, а не прикидку.
Подходит, если
- Лимит доступа кончился раньше срока, и нужно найти сессии с самым большим расходом.
- Сравнивают стоимость задач с кешем и без него.
- Агент объясняет по метаданным, какие инструменты съели больше всего времени.
- Расход кредитов разбирают по дням и по сессиям с опорой на конкретные записи.
Не подходит, если
- Нужен учет расходов для других агентов, например Claude Code.
- Хочется красивый общий дашборд, а не набор фактов для агента.
- Требуется облачная панель для команды.
Пример запроса к агенту
Найди три сессии Codex, которые съели больше всего кредитов за неделю, и объясни, какие инструменты и вызовы дали основной расход.Ограничения
Работает только с Codex и читает его локальные журналы. Версия 0.28.0 считается замороженным эталоном на время переписывания: автор готовит чистое ядро, ориентированное на агента, и старый код будет удален перед новым релизом. Новая версия не открывает и не переносит старую базу. После установки нужна свежая задача Codex, иначе набор инструментов плагина не подхватится. Реальные журналы, запросы и ответы в публичные репозитории не отправляйте.
Как отключить. Отключите плагин командой Codex для удаления плагинов и выполните `pipx uninstall codex-usage-tracking`. Локальную базу и кеш удалите вручную.
Частые вопросы
Как поставить плагин?
Выполните `pipx install "codex-usage-tracking==0.28.0"`, затем `codex plugin marketplace add douglasmonsky/codex-usage-tracker --ref v0.28.0` и `codex plugin add codex-usage-tracker@codex-usage-tracker`.
Что измеряется?
Токены, время, вызовы инструментов, ресурсы, лимит доступа, кредиты и стоимость по сессиям, ходам и вызовам.
Уходят ли данные в облако?
Нет, проект построен локально: данные берутся из метаданных ваших сессий Codex на машине.
Что будет с проектом дальше?
Автор переписывает его как компактное ядро для агента с быстрым запуском за 24 часа или за все время. Версия 0.28.0 пока поддерживается.
Зачем плагину pipx?
Плагин запускает исполняемый файл `codex-usage-tracker` из окружения pipx, поэтому Python-часть ставится отдельно и в изоляции.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныCLI показывает расход лимитов Codex и число ручных сбросов, а по явному подтверждению тратит один сброс.
Скилл для Codex: безопасное обслуживание локального состояния, отчет без записи по умолчанию, бэкап и архив вместо удаления, чистка логов и воркстри
TokenTracker считает токены и расходы в Claude Code, Codex, Cursor, Gemini CLI и других агентах по локальным логам и показывает их на панели localhost:7680
CLI и MCP-сервер, которые считают расход токенов по 41 инструменту и агенту, показывают трату по проекту и модели и помогают срезать лишние токены
Считает токены и стоимость сессий Claude Code и Codex по локальным журналам и показывает остаток лимитов в статусной строке
Splitrail считает токены и стоимость Claude Code, Codex, Cline, OpenCode и других агентов по логам и отдает данные по MCP
Коротко о README
Проект называет себя локальным продуктом данных для вопросов о расходах Codex. Дальнейшая работа описана в документах PRODUCT_DIRECTION и в списке задач с контрактом на каждую.