CodexBar — все лимиты ИИ-кодинга в одном menu bar

CodexBar — бесплатная утилита с открытым исходным кодом (open source) для macOS, которая показывает лимиты, время сброса, кредиты и расходы AI-провайдеров прямо в строке меню. Она помогает заранее оценить доступную квоту, выбрать подходящий сервис и проверить лимит перед автоматическим запуском задачи.

Данные актуализированы 5 сентября 2026 года по официальному репозиторию и документации CodexBar. Актуальная версия на момент проверки — 0.56.5.

Что показывает CodexBar

CodexBar работает на macOS 14 Sonoma и новее. Приложение живёт в строке меню без отдельной иконки в Dock. Для каждого включённого провайдера оно выводит доступные окна использования и время их сброса. Набор показателей зависит от того, какие данные предоставляет конкретный сервис.

Основные возможности:

Раздел Usage & Spend показывает локальные оценки, а не банковский документ или счёт провайдера. Суммы могут рассчитываться по публичным ценам моделей. Если источник отдельно сообщает списанные по плану расходы, CodexBar показывает оба значения. Суммы в разных валютах не складываются.

Поддерживаемые провайдеры и источники данных

По состоянию на дату проверки CodexBar регистрирует 69 идентификаторов провайдеров. Среди них:

• Codex — OAuth API или локальный CLI; данные веб-дашборда OpenAI подключаются отдельно;
• OpenAI — Admin API для расходов и статистики организации, с ограниченным резервным режимом для обычного API-ключа;
• Claude — Admin API, OAuth, Claude CLI или веб-сессия в зависимости от режима;
• Cursor — браузерная сессия, сохранённая сессия или локальная авторизация Cursor.app;
• Gemini — OAuth-данные Gemini CLI;
• GitHub Copilot — GitHub device flow и внутренний API Copilot;
• Kiro — команда kiro-cli для плана, месячных и бонусных кредитов;
• Vertex AI — Google Application Default Credentials и метрики Cloud Monitoring;
• OpenRouter, ElevenLabs, DeepSeek, Warp и другие API-сервисы — ключи соответствующих провайдеров;
• JetBrains AI, Windsurf, OpenCode Go и ряд других интеграций — известные локальные файлы или базы данных;
• Cursor, Perplexity, Mistral, Command Code и другие веб-интеграции — автоматические или вручную заданные cookies.

Полный перечень и порядок резервных источников приведены в официальной документации по провайдерам.

Наличие провайдера в списке не означает, что для него доступны все метрики. Один сервис может отдавать проценты квоты и дату сброса, другой — только баланс или статус. Часть интеграций требует локально установленного CLI, API-ключа, браузерной сессии или доступа к облачным метрикам.

Установка приложения на macOS

Homebrew

Актуальная команда для приложения:

brew install --cask codexbar

Для обновления используйте стандартную команду Homebrew:

brew upgrade --cask codexbar

GitHub Releases

Universal-сборка для Apple Silicon и Intel доступна на странице GitHub Releases. Релизы приложения поддерживают обновление через Sparkle.

Первый запуск и подключение провайдеров

1. Откройте Settings → Providers.
2. Включите только те провайдеры, которыми пользуетесь.
3. Подключите подходящий источник: OAuth, device flow, API-ключ, браузерную сессию, локальное приложение или CLI.
4. При необходимости откройте Settings → Providers → Codex и добавьте OpenAI cookies в режиме Automatic или Manual для расширенных данных веб-дашборда.
5. Дождитесь обновления и откройте меню CodexBar. У подключённого провайдера должны появиться доступные окна, баланс или другой поддерживаемый показатель.

Если карточка остаётся пустой, сначала проверьте авторизацию и выбранный источник. Затем убедитесь, что нужный CLI установлен или что API-ключ и cookies ещё действуют. Не каждый тариф и аккаунт возвращает одинаковый набор полей.

Установка и использование CLI

Для Linux отдельная Homebrew-формула CLI устанавливается так:

brew install steipete/tap/codexbar

Готовые архивы также выпускаются для:

• macOS arm64 и x86_64;
• Linux glibc aarch64 и x86_64;
• Linux musl aarch64 и x86_64.

В установленном macOS-приложении CLI можно подключить через Preferences → Advanced → Install CLI.

Проверка установки

codexbar --version
codexbar usage --format json --pretty

Первая команда должна вывести версию. Вторая возвращает JSON с данными включённых провайдеров или структурированными ошибками источников.

Полезные команды

# Состояние включённых провайдеров
codexbar usage

# Машиночитаемый результат
codexbar usage --format json --pretty

# Все зарегистрированные провайдеры
codexbar usage --provider all

# Локальная история Codex за 30 дней
codexbar cost --provider codex --days 30

# История Claude в JSON
codexbar cost --provider claude --format json --pretty

# Проверка недельного остатка перед автоматизацией
codexbar guard --provider codex --min-remaining 20 --window weekly --json

# Локальный HTTP-интерфейс на loopback-адресе
codexbar serve --port 8080

Команда cost поддерживает историю Codex, Claude, Cursor и Antigravity, но источники различаются. Для Codex и Claude читаются локальные журналы сессий. Cursor обращается к веб-дашборду с cookie-аутентификацией, а Antigravity использует локальную историю токенов без расчёта стоимости в долларах.

Команда guard подходит для автоматизации: код возврата 0 означает достаточную квоту, 1 — остаток ниже порога, 69 — квоту проверить не удалось. Флаг --fail-open разрешает продолжить работу при недоступных данных, поэтому его стоит применять только там, где неизвестная квота не создаёт риска.

Где хранится конфигурация

Новые установки используют файл:

~/.config/codexbar/config.json

Существующие установки продолжают читать прежний путь ~/.codexbar/config.json, если нового XDG-конфига нет. Путь можно переопределить переменной CODEXBAR_CONFIG; абсолютный XDG_CONFIG_HOME также поддерживается.

В конфигурации могут находиться API-ключи, ручные cookie-заголовки, выбранные источники и токены аккаунтов. Когда CodexBar записывает файл, он устанавливает права 0600 на macOS и Linux.

Проверить структуру файла можно командой:

codexbar config validate

Приватность и разрешения macOS

CodexBar не обходит весь диск. При включённых функциях он читает ограниченный набор известных источников: cookies и локальное хранилище браузеров, конфиги провайдеров, базы приложений и журналы сессий.

• Full Disk Access нужен опционально для чтения данных Safari. Вместо него можно использовать поддерживаемый браузер, ручные cookies, OAuth, API-ключ или CLI, если провайдер допускает такой источник.
• Keychain access может потребоваться для расшифровки Chromium cookies и отдельных OAuth-сценариев. Фоновые операции не должны сами вызывать интерактивный запрос доступа.
• Files & Folders может появиться, когда запущенный CodexBar вспомогательный CLI обращается к проектной папке или внешнему диску.

Пароли CodexBar не сохраняет, однако cookies, OAuth-токены и API-ключи сами по себе являются секретами. Перед подключением веб-источника учитывайте, какие данные сессии сможет прочитать приложение.

Полезные сценарии

Планирование длинной задачи

Условие: Codex или Claude уже подключён и возвращает сессионное либо недельное окно. Перед большим рефакторингом откройте карточку провайдера и сравните остаток с временем до сброса. Наблюдаемый результат — в меню видны процент квоты и дата или обратный отсчёт. Если источник не отдаёт окно, по CodexBar нельзя надёжно решить, хватит ли лимита.

Выбор провайдера с доступной квотой

Условие: настроены два или больше сервисов. Сравните их карточки или включите Merge Icons для переключения в одном пункте меню. Результат — можно выбрать провайдера с подтверждённым доступным окном до запуска задачи. Проценты разных сервисов нельзя считать напрямую сопоставимыми: у них отличаются тарифы и правила учёта.

Проверка лимита в автоматизации

Условие: CLI видит нужного провайдера без интерактивного запроса авторизации. Добавьте codexbar guard перед ресурсоёмким заданием и обработайте коды возврата. Проверяемый результат — pipeline продолжает работу при достаточной квоте и останавливается ниже заданного порога. При недоступном источнике команда возвращает отдельное состояние unknown.

Контроль локальной истории расходов

Условие: включено отслеживание стоимости и у провайдера есть поддерживаемая история. Откройте Settings → Usage & Spend или выполните codexbar cost. Результат — локальная разбивка по дням, токенам и моделям в пределах доступного покрытия. Эти значения являются оценкой и не заменяют счёт провайдера.

Требования и текущее состояние проекта

Проект обновляется часто, поэтому команды, список провайдеров и способы авторизации лучше сверять с документацией конкретной версии.

Официальные ссылки

• GitHub-репозиторий
• Документация по провайдерам
• Документация CLI
• Конфигурация и хранение секретов
• Документация по статусу провайдеров
• Задачи и обсуждения репозитория
• Последний релиз
• Changelog

Следующий шаг

Если вы используете Codex вместе с другими coding-агентами, продолжите с обзором OpenAI Codex — облачный coding-агент для параллельной разработки.

CodexBar полезен как часть рабочего контура, где запуск задач зависит от доступной квоты и наблюдаемого состояния провайдеров.

Если захотите обсудить, как это применить у себя или в команде — пишите в Telegram @pimenov