Всё, что умеет Headroom.

Каждая возможность целиком — в GNOME, KDE Plasma, трее Headroom и на macOS. Выберите тему или листайте подряд.

Панель на любом рабочем столе.

Где живёт индикатор в GNOME, KDE Plasma, трее Headroom, Waybar и строке меню macOS — и как он выглядит на самом деле.

Все режимы верхней панели GNOME: один лимит кольцом, полосой с отметкой темпа или текстом, с провайдером и окном или без, несколько лимитов с логотипами провайдеров и знак Headroom в цвете самого тревожного лимита. — Листайте вбок, чтобы увидеть снимок целиком в полный размер.

GNOME: Слева, по центру или справа — или зажмите индикатор и перетащите его по верхней панели.
macOS: Несколько лимитов становятся отдельными значками в строке меню, до трёх. Их можно передвинуть с ⌘, и они остаются на своих местах.
KDE Plasma: У виджета те же режимы, узкий вариант для вертикальных панелей и подсказка со всеми лимитами. Переносится в режиме редактирования панели.
Трей Headroom: Значок рисует одно или два кольца, полосы или знак Headroom. Где он стоит, решает сам трей.
Waybar: Несколько провайдеров в одном модуле:headroom waybar --providers claude,codex

Видно заранее.

Headroom доводит прогноз каждого лимита до сброса и заранее говорит, когда он закончится. С версии 0.6.1 прогноз следует за тем, как вы на самом деле работаете, а не за часами на стене.

Остаток: от сервиса, при каждом обновлении
Прогноз: следует за логами, за секунды

Вживую, пока работают агенты.

Окна сессии прогнозируются по темпу последнего отрезка активной работы, и считается только рабочее время. Пока Claude Code или Codex работают, прогноз за секунды следует за расходом токенов в их локальных логах и сверяется с шагами процентов самого сервиса.

Проценты на карточке всегда от сервиса. Оценка двигает только прогноз.
Когда ничего не запущено, карточка пишет «Пауза · хватит ≈3 ч работы» вместо отсчёта до исчерпания, которого не будет.
Уведомление «закончится до сброса» приходит один раз и повторяется только после сброса или когда темп действительно снизился. На паузе оно не приходит.

Недельные лимиты — по среднему.

Длинные окна прогнозируются по среднему темпу с начала окна, поэтому один напряжённый вечер не окрашивает всю неделю в красный. Прокрутите неделю и посмотрите, как меняются отметка, прогноз и цвет.

Нажмите на время сброса, чтобы переключиться между обратным отсчётом и точным временем — в 12- или 24-часовом формате, как часы системы.

headroom status в терминале: недельный лимит Claude закончится примерно через два дня, а недельный лимит Codex на паузе, и остатка хватит примерно на три часа работы. — Тот же прогноз в headroom status.

ClaudeНеделя

Осталось49%

При текущем темпе: закончится через 2 д 13 ч · сброс через 4 д 9 ч

Прокрутите неделю

Уведомления по вашим правилам.

Выберите, когда приходит «почти исчерпан»: при остатке меньше 5, 10, 20 или 30%, отдельно для каждого сервиса или никогда. Ещё Headroom предупредит, если по темпу лимит закончится раньше сброса. Всё это приходит в уведомления рабочего стола или в Центр уведомлений macOS, каждое один раз; предупреждения о темпе повторяются только после сброса или когда темп действительно спадёт.

Тихие часы придерживают уведомления ночью и присылают одну сводку, когда заканчиваются. Критичные при этом могут прийти сразу.

Предупреждать, когда осталось меньшеДля уведомления «Почти исчерпан»

Тихие часыПридерживать уведомления, пока вас нет

Два аккаунта — одна карточка.

Рабочий и личный Codex — рядом или вместе. В общей карточке шкала поделена на сегменты по аккаунтам, видно, сколько осталось от общего объёма, ближайший сброс и единый прогноз темпа.

Наведите на лимит, чтобы увидеть каждый аккаунт. По умолчанию режим выключен: его включает один переключатель в настройках — в GNOME, KDE Plasma, трее и macOS.

Балансы с оплатой по факту остаются в своей валюте: юани в юанях, доллары в долларах, без пересчёта и сложения.

DeepSeek¥128.40
DeepSeek$6.25
Moonshot API$42.15
Kilo Code$18.60

Объединять аккаунты одного сервисаОдна карточка на сервис, лимиты его аккаунтов складываются

Сессия

Осталось 59%Осталось 145% из 200%Сброс через 1 ч 48 минСброс через 1 ч 48 мин

При текущем темпе к сбросу останется ~36%При текущем темпе к сбросу останется ~71% из 200%

НеделяТемп превышен

Осталось 34%Осталось 112% из 200%Сброс через 2 д 14 чСброс через 2 д 14 ч

При текущем темпе: закончится через 2 д 6 ч · сброс через 2 д 14 чПри текущем темпе к сбросу останется ~15% из 200%

Сессия

Осталось 86%Сброс через 3 ч 55 мин

При текущем темпе к сбросу останется ~35%

Неделя

Осталось 78%Сброс через 5 д 2 ч

При текущем темпе к сбросу останется ~20%

Расходы по моделям и проектам.

Сегодня, вчера, за 7 или 30 дней — в долларах, в токенах или как цена за миллион токенов. Те же цифры, что в окне Headroom: по локальным логам и публичным ценам.

Проект — это рабочая папка, которую записали в логи Claude Code и Codex. Полоска каждого проекта поделена по сервисам.

Нужны только итоги? Выключите «Показывать модели и проекты» в настройках, и список под кольцом исчезнет.

Наведите на сервис, чтобы увидеть его модели.

$533

12 моделей

gpt-5.533,9%$180.77
claude-opus-4-530,0%$160.06
claude-sonnet-4-513,2%$70.85
grok-45,9%$31.65
gpt-5.5-mini5,2%$27.81
Другие· 7 моделей11,5%$61.61

Повторы убираются по идентификатору ответа, куски потокового ответа не складываются, а стоимость хранится в целых микродолларах.

Записи лога

msg_01XFDU…claude-sonnet-4-5+50 739учтено
msg_01XFDU…claude-sonnet-4-5+50 739повтор, пропущено
resp_68d241…gpt-5-codex+26 924учтено
msg_01KqTz…claude-sonnet-4-5+64 950учтено
msg_01KqTz…claude-sonnet-4-5+64 950повтор, пропущено
resp_68d29b…gpt-5-codex+29 014учтено
resp_68d20d…custom-model+4 999нет цены
msg_01VbLk…claude-sonnet-4-5+65 724учтено
msg_01VbLk…claude-sonnet-4-5+65 724повтор, пропущено

Сегодня

Ввод: 123 364
Чтение кэша: 5 535 799
Запись в кэш, 5 мин: 192 444
Запись в кэш, 1 час: 77 392
Вывод: 117 579
из них рассуждения: 23 872

Потрачено

$4.31неполная

Частично без цены, в стоимость не входит

Цены из LiteLLM и models.dev

Группировка по моделям, проектам, сервисам или дням — за любое число дней.

headroom spend--by model|project|provider|day--since 30d

~/code/app $ headroom spend --by project --since 30dSpend by project  Aug 27 – Sep 25 · project = working directory of the sessionProject          Tokens     Cost   Share~/code/headroom     73M  $245.07   46.0%  ████████████~/code/app        42.9M  $143.84   27.0%  ███████(no project)      17.5M   $58.60   11.0%  ███~/work/api        11.1M   $37.29    7.0%  ██~/code/dotfiles    6.3M   $21.31    4.0%  █~/work/infra       4.8M   $15.98    3.0%  █~/scratch          3.2M   $10.66    2.0%  █──────────────────────────────────────────────────────Total              159M  $532.75  100.0%~/code/app $ 

~/code/app $ headroom spend --by model --since 30dSpend by model  Aug 27 – Sep 25 · estimated from local logsModel              Provider  Input  Output  Cache read  Cache write     Costgpt-5.5            Codex     36.9M      3M       19.7M            0  $180.77claude-opus-4-5    Claude    10.2M    821K        5.4M            0  $160.06claude-sonnet-4-5  Claude    11.4M    918K        6.1M            0   $70.85grok-4             Grok       6.2M    501K        3.3M            0   $31.65gpt-5.5-mini       Codex     12.5M      1M        6.7M            0   $27.81gpt-5.4-codex      Codex      6.6M    529K        3.5M            0   $18.54claude-opus-4-1    Claude     1.5M    121K        797K            0   $13.12claude-haiku-4-5   Claude     3.6M    290K        1.9M            0   $10.50grok-code-fast-1   Grok       2.7M    215K        1.4M            0    $6.95claude-sonnet-4    Claude     1.8M    145K        957K            0    $5.25o4-mini            Codex      3.6M    288K        1.9M            0    $4.64claude-3-5-haiku   Claude     1.5M    121K        797K            0    $2.62────────────────────────────────────────────────────────────────────────────Total                        98.4M    7.9M       52.4M            0  $532.75~/code/app $ 

Это у меня или у них?

Включите страницы статуса сервисов, и инцидент или сбой появится прямо на карточке, со ссылкой на страницу статуса. Больше не нужно гадать, что лежит: ваша сеть или сервис.

По умолчанию выключено. Когда включено, Headroom раз в 5 минут читает публичную страницу статуса каждого сервиса, которым вы пользуетесь, и следит только за важными для него частями.

Claude
Codex
Copilot
Cursor
Devin
Kimi Code
Moonshot API
MiniMax
Kilo Code
Warp
Poe

Чинится само.

Кнопка «Повторить» делает то, что нужно: после смены аккаунта заново находит аккаунты, а входы, которыми владеет Headroom, обновляет сама. Если истёк вход в CLI, «Войти» открывает терминал со входом самого CLI, а новый вход Headroom замечает сам. Скопировать команду по-прежнему можно.

Спокойно при ограничениях.

Когда сервис ограничивает запросы, карточка сохраняет последние цифры и показывает тихую строку вместо ошибки. Claude опрашивается не чаще раза в 3 минуты, потому что Claude Code опрашивает тот же адрес.

При повторных ограничениях пауза перед новой попыткой растёт — или длится столько, сколько просит сервис

5 мин
10 мин
20 мин
40 мин
60 мин

История для каждого аккаунта.

Аккаунт Claude или Codex, добавленный через Headroom, получает историю использования, расходы и обновление вживую из логов самого CLI, если этот CLI вошёл в тот же аккаунт. Каждый лог по-прежнему учитывается один раз.

Чаще, пока вы пишете код.

Пока Claude Code, Codex или Grok пишут логи использования, их аккаунты обновляются раз в минуту, а после 10 минут тишины возвращаются к обычному интервалу. На Linux в настройках есть кнопка «Проверить сейчас» для обновлений.

Трей Headroom.

Для любого рабочего стола без GNOME Shell и Plasma. Установщик в одну команду ставит его сам.

Значок показывает темп: Кольцо, полоска с отметкой ровного темпа, два лимита рядом или знак Headroom — цвет по самому тревожному лимиту.
То же окно: Расходы, лимиты, прогнозы, вход и сбои сервисов — карточка в карточку, как в GNOME и на macOS.
Родные настройки: Окно на GTK 4 / libadwaita: «Общие», «Аккаунты», «Уведомления», «Расширенные» и «О программе». «Аккаунты» — список и панель подробностей. При первом запуске — окно приветствия.
Глобальное сочетание клавиш: Через портал GlobalShortcuts на Wayland, перехватом клавиш на X11 — или повесьте headroom-tray --toggle на клавишу сами.
Пакеты: headroom-tray для deb, rpm и Arch — рядом с основным пакетом в каждом релизе.

Работает в

Xfce
Cinnamon
MATE
Budgie
LXQt
Hyprland
Sway
niri
river
labwc
Wayfire
COSMIC
i3bar, polybar и tint2 через snixembed

Настройки трея Headroom, «Аккаунты»: список аккаунтов слева и подробности выбранного аккаунта Codex справа

Кольцо, полоска, два лимита или знак

Настройки трея Headroom, вкладка «Общие»: тема, язык, формат времени, плотность и значок в трее — «Общие» с настройками значка

Настройки под вас.

Все настройки хранит демон, поэтому окно, панель, Waybar и CLI всегда показывают одно и то же.

Аккаунты — как на Mac.

С версии 0.6.1 страница «Аккаунты» в GNOME, Plasma и трее — это список и панель подробностей, как в приложении для macOS.

Список: Все провайдеры и аккаунты с тарифом и почтой, звёздочка для тех, что всегда открыты, и точка состояния или предупреждение. В GNOME порядок меняется перетаскиванием, а везде — кнопками «Выше» и «Ниже» в подробностях.
Подробности: Показ на панели и во всплывающем окне, «Всегда показывать открытым», подпись, переключатель для каждого лимита с остатком, ссылки на статус и панель управления, порядок и «Удалить…»
Вышли из аккаунта?: «Войти снова…» — прямо на странице аккаунта.
Узкое окно: Страница складывается: сначала список, потом подробности с кнопкой «Назад».

Настройки Headroom в GNOME, «Аккаунты»: слева список аккаунтов со звёздочками, точками состояния и предупреждениями, справа подробности рабочего аккаунта Codex

Страница «Аккаунты» в узком окне GNOME: подробности аккаунта Claude без входа, кнопка «Назад» и «Войти снова…»

Окно настройки Headroom в KDE Plasma, «Аккаунты»: слева аккаунты по провайдерам, справа подробности выбранного аккаунта

Настройки трея Headroom, «Аккаунты»: слева список аккаунтов, справа подробности выбранного аккаунта

Картинка для Plasma — предпросмотр, элементы управления на ней приблизительные.

Все страницы

На скриншотах — GNOME. В трее те же страницы плюс раздел «Значок в трее» и «О программе», в Plasma они в окне настройки виджета, а на macOS есть ещё вкладка «Служба».

Настройки Headroom в GNOME, вкладка «Общие»: тема, язык, формат времени, плотность и полупрозрачность — Тема, язык, 12- или 24-часовое время и компактный вид, в который влезает больше аккаунтов.

Настройки верхней панели: несколько лимитов с логотипами провайдеров, стиль индикатора, подпись и положение — Один лимит, несколько или только знак; кольцо, полоска или текст; слева, по центру или справа.

Настройки расходов: показ расходов, показ моделей и проектов, период по умолчанию, единицы и разбивка при наведении — С каким периодом, единицами и разбивкой открывается карточка расходов, и **«Показывать модели и проекты»**, чтобы скрыть или показать список под кольцом.

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

Настройки конфиденциальности: скрытие цифр при демонстрации экрана, проверка обновлений, страницы статуса и сочетание клавиш — Скрывать цифры при демонстрации экрана, проверка обновлений и страницы статуса сервисов.

Окно «Назначить сочетание», ожидающее нажатия клавиш — Глобальное сочетание, которое открывает Headroom откуда угодно.

Настройки уведомлений: события, порог уведомлений и пороги по провайдерам — Предупреждать, когда осталось 5, 10, 20 или 30 %, и свой порог для каждого провайдера.

Тихие часы с 22:00 до 08:00, критичные уведомления по-прежнему показываются — В выбранные часы уведомления копятся и приходят одной сводкой после. Критичные могут приходить и так.

Расширенные настройки: состояние службы, журнал, копирование диагностики, сброс настроек и группа «Поддержать Headroom» с кнопкой «Открыть GitHub» — Уровень журнала, файл журнала, «Скопировать диагностику» и сброс всех настроек, при котором аккаунты остаются. В самом низу — **«Поддержать Headroom»**: звезда на GitHub.

Поставьте звезду на GitHub

Звёзды помогают другим найти Headroom. Это бесплатно и занимает секунду.

Открыть GitHub

Первый запуск.

Headroom показывает, что нашёл: инструменты, в которые вы вошли, с переключателем у каждого, вход для установленных, но без входа, остальное — бледным. Начните сразу или выберите позже.

Добро пожаловать в Headroom · Вот что мы нашли
Headroom живёт в верхней панели
То же приветствие в трее

Для скриптов и агентов.

headroom guard спрашивает у запущенного демона, есть ли запас в лимитах, и отвечает кодом выхода. Поставьте его перед запуском агента или в git-хук.

Коды выхода

0Во всех проверенных лимитах осталось не меньше --min процентов.
1Хотя бы один ниже порога: по строке ✗ на каждое окно, со временем сброса.
2Свежих данных по проверенным лимитам нет или демон не запущен.

--window session|weekly, --provider, --account, --quiet и --json сужают проверку.

Хук pre-push

.git/hooks/pre-push

#!/bin/sh
if headroom guard --min 15 --provider claude --quiet; then
    claude -p "review the commits about to be pushed" --output-format text
else
    echo "headroom: Claude is below 15%, skipping the AI review" >&2
fi

Агент проверяет коммиты перед отправкой, только пока у Claude есть запас.

Ещё для терминала

headroom spend --by project --since 30d
Расходы по моделям, проектам, провайдерам или дням из локальных логов.
headroom waybar --providers claude,codex
Несколько провайдеров в одном модуле Waybar, тревожные значения выделены цветом.
headroom accounts login <id>
Заново войти в аккаунт: добавленный Headroom — в той же папке, аккаунт CLI — в терминале, где запущен вход самого CLI.
headroom diagnostics
Версии, система и состояние аккаунтов для отчёта об ошибке — без токенов, почты и идентификаторов.

Скрипты в README

Знай, сколько осталось.

Одна команда для любого рабочего стола Linux, одна для macOS. Бесплатно и с открытым кодом.

curl -fsSL https://github.com/daniarjabagin/headroom/releases/latest/download/get-headroom.sh | sh

brew install --cask daniarjabagin/tap/headroom

Все способы установки Звезда на GitHub

Вопросы, ошибки и новые провайдеры: Обсуждения Задачи Как помочь