Однажды посреди плотной рабочей сессии в свежей версии Google Antigravity 2.0 в ленту чата тихо падает системная плашка:

“This conversation grew too large, so the history before this point may be missing or incomplete.”

В переводе с агентного на человеческий это означает простую и неприятную вещь: серверу показалось, что диалог распух, и он отрезал «префикс» — самое начало переписки — либо схлопнул ранние ходы в сжатый чекпоинт.

В обычном чат-боте, где вы спрашиваете рецепт пасты, отрезанное начало — это забытое «привет». Но в автономной агентной среде разработки в начале чата лежит самое дорогое: исходное ТЗ, архитектурные ограничения, договорённости «что именно трогать нельзя» и история запущенных фоновых процессов. Когда бэкенд тихо подрезает хвост памяти постфактум, у агента случается то, что на форумах уже метко прозвали Compaction Amnesia: модель уверенно продолжает работать, но начинает изобретать отменённые два часа назад решения или ломать инварианты, о которых она буквально только что забыла.

И ладно бы я любил марафонские сессии на пятьсот сообщений! Наоборот — я никогда не затягиваю чаты до бесконечности и всегда закрываю их по своей методичке: с честным аудитом задач, подведением итогов и записью выжимки для следующего чата. Но чтобы вовремя нажать на тормоз и закрыть сессию до автосжатия, нужно хотя бы краем глаза видеть, сколько контекста уже съедено.

Оказалось, что в десктопном Antigravity 2.0 такой базовой приборной панели просто нет, а готовые решения в сети либо не закрывают задачу, либо требуют патчить саму IDE. Пришлось, как это обычно бывает, всё делать самому — вернее, руками самого Gemini под моим «чутким» руководством. Начал я с маленького плагина chat_tokens, а в итоге ушёл в полноценное нативное macOS-приложение ContextRing.

Зачем вообще считать токены, если можно просто «поболтать»?

Мой подход к работе с ИИ-агентами строится на довольно жёсткой гигиене сессий. Чтобы проекты не тонули в каше из противоречивых правок, в репозиториях живёт многоуровневая память и отдельный регламент — Методичка завершения чата.

Если кратко, перед тем как начать новую задачу в свежем чате, мы не просто пишем «ну, до завтра», а проводим структурированное закрытие сессии:

  1. Многоуровневая карта памяти проекта:

    • Точка входа проекта (00_НАЧАТЬ_ЗДЕСЬ.md) — текущий статус направлений и журнал чатов в одну строку на сессию.

    • Вход раздела (00_ВХОД.md) — актуальное состояние (новое заменяет старое, а не дописывается рядом с ним) и ровно один следующий исполнимый шаг.

    • Решения (РЕШЕНИЯ.md) — утверждённые договорённости дословной цитатой и с датой.

    • Знания (ЗНАНИЯ.md) — проверенные выводы, ограничения и отмены. Отменённое решение никогда не стирается молча, а помечается как «заменено…», чтобы следующий агент не наступил на те же грабли.

    • Контексты сессий (SESSION_<дата>_<тема>.md) — концентрат того, что пробовали, почему отказались от тупиковых веток и какими командами воспроизвести результат.

  2. Ритуал закрытия перед переходом в новый чат:

    • Честный аудит каждого пункта: пройти весь диалог с первого сообщения и по каждому обещанию, идее и замечанию зафиксировать честный исход (сделано / отвечено / отложено с причиной / блокировано / снято).

    • Гигиенический проход: проверить, не превратилась ли гипотеза в «подтверждённый факт», нет ли файлов-сирот без ссылок со входа раздела, и разобрать временную папку (не удаляя ничего безвозвратно без команды, а убирая в корзину с записью в манифест).

  3. Аварийный протокол — «Быстрая контрольная точка»: На случай, если контекст уже на излёте и полный ритуал провести мы не успеем, в методичке есть сокращённый сценарий сброса минимального снимка состояния и явного списка шагов, которые остались непроверенными.

И вот здесь возникает главный конфликт. В методичке у меня даже пришлось дописать грустную оговорку:

«Если часть переписки уже сжата и не видна — прямо указать, что аудит неполный и какие сохранённые контексты использованы».

Любая, даже самая продуманная методичка превращается в русскую рулетку, если вы не видите заполнение окна контекста. Вы спокойно делаете рефакторинг, рассчитываете через пару ходов красиво подвести итоги и разобрать все пункты диалога, отправляете очередное сообщение — а в ответ прилетает “This conversation grew too large…”. Всё: начало диалога уже отрезано, часть договорённостей испарилась, и честный аудит по всей сессии уже невозможен.


Парадокс Antigravity: почему все уже сделали счётчик контекста, а Google — нет?

Если посмотреть на соседние агентные среды, индикатор контекста там давно воспринимается как спидометр в машине — никому не нужно объяснять, зачем он на приборной панели:

  • В Cursor и OpenAI Codex аккуратный круговой индикатор (или шкала токенов) висит прямо рядом с полем ввода.

  • В Claude Code прямо в статусной строке отображаются использованные токены, процент окна и стоимость, плюс в любой момент доступна команда /context.

  • В Cline, Roo Code и Windsurf прогресс-бар контекстного окна, доля попаданий в кэш и лимит модели постоянно перед глазами над окном чата.

А что у Google Antigravity?

Самое смешное, что в консольном Antigravity CLI (agy) команда /context есть! Она даже рисует в широком терминале наглядную пропорциональную сетку из квадратиков ◉ и □ с разбивкой по системным инструкциям, сообщениям, инструментам и буферу чекпоинтов. И ручная команда /compact тоже существует.

Но стоит открыть флагманское десктопное приложение Antigravity 2.0 — вокруг поля ввода стерильная пустота. Ни цифр, ни процентов, ни прогресс-бара, ни предупреждения о том, что вы в шаге от авто-компактификации. На Google AI Developers Forum и в Reddit (r/google_antigravity) регулярно всплывают темы с одним и тем же вопросом: разработчики буквально просят нарисовать хотя бы крошечное кольцо контекста рядом с выбором модели, потому что обрезка на ~200k–275k токенов прилетает внезапно, даже если в настройках выбрана модель с миллионным окном (ради скорости отклика и экономии серверных ресурсов бэкенд всё равно режет или сворачивает хвост раньше теоретического предела).

Почему команда UI в Google до сих пор не вывела одну простую цифру в интерфейс? Скорее всего, причина в том, что под капотом Antigravity 2.0 всё устроено заметно сложнее обычного чата:

  • почти весь статический контекст гоняется через агрессивный Prompt Caching (95–99% токенов читаются из кэша);

  • в режиме Orchestrator в одном и том же чате работают разные модели (планировщик и исполнитель) со своими системными промптами, инструментами и разной «длиной» контекста;

  • часть правил и навыков подгружается динамически по ходу задачи.

Но самое ироничное во всей этой истории вот что: сам Antigravity идеально точно считает все токены после каждого шага и аккуратно складывает эти логи на диск в открытом виде. Просто никто не вывел их на экран.


Вскрываем логи Antigravity и делаем chat_tokens: /чат за 0 токенов и боковая панель

Когда я полез смотреть, что Antigravity хранит у себя под капотом, всё оказалось предельно прозрачным. Для каждой сессии IDE ведёт два локальных источника правды:

  1. Построчный журнал шагов в ~/.gemini/antigravity/brain/<conversationId>/.system_generated/logs/transcript.jsonl (и полный вариант transcript_full.jsonl). На каждом шаге (USER_INPUT, PLANNER_RESPONSE, CHECKPOINT, SYSTEM_MESSAGE) там записаны точные поля от API модели: input_tokens, cache_read_tokens и output_tokens, имя модели, временные метки, вызванные инструменты и затронутые файлы. Полный объём активного контекста на конкретном шаге — это сумма input_tokens + cache_read_tokens.

  2. Индекс всех бесед в SQLite-базе ~/.gemini/antigravity/conversation_summaries.db (с WAL-журналом): названия чатов, привязка к открытым рабочим папкам (workspace_uris), количество шагов и время последнего пользовательского ввода.

Значит, нам не нужно лезть ни в какие приватные серверные API, не нужны токены авторизации и не нужно патчить бинарник Electron. Достаточно читать только локальные файлы — в режиме строго read-only.

Идея №1: команда /ctx и /чат без единого лишнего токена

Первую версию инструмента — плагин chat_tokens — я собрал ещё на другом компьютере. Задача стояла простая: хочу написать в чат /ctx или /чат и сразу увидеть, сколько контекста занято.

Но тут сразу была ловушка: если оформить /ctx как обычный скилл (SKILL.md), то сообщение отправится на сервер к LLM! Получится абсурд: чтобы проверить, не пора ли завершать чат ради экономии контекста, мы сами же сжигаем время, квоту и токены.

Решение нашлось в системе расширений Antigravity — связка пустых скиллов (skills/ctx/SKILL.md и skills/чат/SKILL.md, чтобы команды красиво выпадали в меню автодополнения по /) и локального PreInvocation-хука (scripts/chat_tokens_hook.py):

  1. Вы вводите /чат (или, например, /чат 256k, /ctx 1M, чтобы на лету задать порог предупреждения).

  2. Перед отправкой запроса в модель Antigravity запускает Python-скрипт хука и передаёт ему JSON с текстом ввода и ID/путём к транскрипту.

  3. Скрипт за несколько миллисекунд читает transcript.jsonl, считает контекст, процент, дельту, кэш, модель, ходы и возвращает ответ с директивой "terminationBehavior": "terminate".

  4. Запрос обрывается до обращения к LLM: 0 токенов контекста, 0 расхода квоты, мгновенный ответ.

Правда, пока мы доводили этот «простой» хук до ума, собрали сразу три классических грабли рантайма Antigravity:

  • Грабли 1. Призрачная документация metadata.user_markdown и паника в Go-рантайме. В официальной встроенной документации хуков Antigravity (hooks.md) чёрным по белому написано: чтобы вывести в чат красивый Markdown без участия модели, нужно вернуть systemMessage с metadata.user_markdown. Мы радостно сверстали таблицу и сворачивающийся блок <details>… Запускаю /чат — тишина на секунду, а потом запрос улетает в живую модель! Полезли разбираться и выяснили, что в Go-рантайме Antigravity (utils.ScrubInternalFields) при передаче строки в metadata возникает внутренняя паника (cannot convert string to message). В результате движок молча отбрасывает весь JSON-ответ хука вместе с командой terminate! Единственным железобетонным транспортом, который гарантированно останавливает отправку в модель и выводит текст пользователю за 0 токенов, оказался errorMessage.userMessage. Да, в чате у блока будет заголовок уровня уведомления, зато 100% без утечки запроса в LLM.

  • Грабли 2. Предательский /usr/bin/python3 на macOS. В интерактивной оболочке у нас жил свежий Python 3.12, где аннотации вроде def parse(raw: str) -> int | None: работают из коробки. Но после перезапуска фонового сервера Antigravity подхватил системный /usr/bin/python3 (на macOS это всё ещё Python 3.9.6), и хук начал молча падать на SyntaxError ещё до запуска! Лекарство в одну строчку — from future import annotations в самом начале скрипта.

  • Грабли 3. Как CommonMark склеил всё в кашу. UI рендерит errorMessage.userMessage через Markdown-парсер, где одиночный \n склеивается в пробел, а свёрнутая шапка тянет начало строки. Когда мы нарисовали красивый разделитель из ────────, в свёрнутом виде показалась строка дефисов и слипшийся абзац. Пришлось переделать формат в лаконичную «светофорную» формулу:

🟢 Контекст: 142 300 / 200k (71%) · +3 420 · кэш 96% · 4 Neon High · сообщ. 6

Идея №2: живая боковая панель Context Monitor (Sidecar)

Одних текстовых команд в чате быстро стало мало — хотелось графиков, разбивки по категориям и списка прошлых сессий без лишнего мусора в самой переписке. Так внутри chat_tokens вырос нативный Sidecar (sidecars/context_monitor/main.mjs + index.html) на встроенном в IDE sidecar_sdk, который встраивается в правую боковую панель (Auxiliary Pane) и не требует ни одной сторонней npm-зависимости.

Казалось бы, вот он — готовый продукт, можно жить и радоваться. Но через пару дней активной работы вскрылось неудобство, которое перечеркнуло половину кайфа.


«Кнопка-пилюля — не годится!»: как родилась идея ContextRing

Когда работаешь с кодом, правая боковая панель в Antigravity почти всегда закрыта, чтобы не отъедать место у редактора и чата. А открывать её вручную каждый раз, чтобы глянуть на проценты контекста, быстро надоедает.

Я открыл чат с Gemini и задал, казалось бы, простой вопрос: «А можно добавить новую команду с /, чтобы она сама открывала нашу боковую панель? Или повесить на неё сочетание клавиш?»

Выяснилось архитектурное ограничение Antigravity 2.0: хуки и плагины не могут программно распахнуть боковую панель или зарегистрировать собственный хоткей в sidecar.json. Максимум, на что способна среда, — вставить в ленту чата специальную «кнопку-пилюлю» вида [Context Monitor](sidecar://chat_tokens/context_monitor/), по которой всё равно придётся кликать мышкой и которая через пару сообщений уедет вверх вместе с историей переписки.

Это был тупик внутри возможностей самой IDE. Помню, в полвторого ночи я написал в чат дословно следующее:

«Не годится. А что если сделать приложение для макоса, которое будет рисовать кольцо (как в кодексе от гпт), по которому при наведении коротко выведется инфа о чате, а при нажатии — подробно? Кольцо должно находиться поверх антигравити с возможностью перемещать его куда угодно, в идеале оно должно отслеживать окно проги с учётом полноэкранного режима, листания окон свайпом и перемещения… Такое возможно?»

И тут у нас закрутилась настоящая нативная разработка под macOS.

Почему мы разделили chat_tokens и ContextRing

Сначала был соблазн объединить плагин и macOS-приложение в один «комбайн v2», чтобы ContextRing сам ставил хуки и сайдкар. Но когда мы трезво посмотрели на архитектуру, поняли, что это два разных продукта для разных сценариев:

  • chat_tokens — лёгкий, кроссплатформенный (macOS / Linux / Windows) плагин строго внутри Antigravity. Никаких прав Accessibility, никаких сторонних бинарников, только Node.js (уже встроенный в IDE) и стандартный Python 3.

  • ContextRing — нативная macOS-утилита на Swift (AppKit + SwiftUI), которой, наоборот, вообще не нужны ни Node.js, ни Python, ни система плагинов Antigravity.

Мы полностью разделили репозитории, а все новые аналитические фичи — разбивку контекста, статистику за 24 часа и 7 дней, переключатель моделей оркестратора — после обкатки в ContextRing аккуратно перенесли обратно в chat_tokens v1.1.0.


Под капотом ContextRing: 5 инженерных задач, которые оказались интереснее, чем казались

Чтобы нативное кольцо ощущалось частью самой IDE, а не чужеродным «стикером» поверх всех окон, нам пришлось решить пять вполне взрослых системных задач. Без единого стороннего фреймворка и даже без тяжеловесного .xcodeproj — весь ContextRing собирается за пару секунд скриптом build.sh напрямую через swiftc в Universal Binary (arm64 + x86_64).

1. Оверлей, который не ворует фокус, и ловушка zoomLevel

Само кольцо живёт в безрамочной прозрачной панели RingPanel (NSPanel со стилем [.borderless, .nonactivatingPanel] и переопределёнными canBecomeKey = false, canBecomeMain = false). Благодаря этому вы можете навести курсор на кольцо, открыть поповер или перетащить его в другое место — и при этом фокус клавиатуры не уйдёт из поля ввода чата в Antigravity.

А вот с привязкой позиции мы чуть не пошли по ложному пути. Первая моя идея звучала так: «Давай просто посчитаем координаты кнопки „Отправить“ в процентах от ширины окна и приклеим кольцо над ней!».

Хорошо, что вовремя проверили макет Electron:

  1. У центральной ленты чата есть свой max-width. Когда вы растягиваете окно на широкий монитор или открываете/закрываете левую и правую боковые панели, кнопка «Отправить» смещается не пропорционально ширине всего окна.

  2. Более того, при изменении масштаба интерфейса IDE (Cmd + / Cmd -) элементы UI съезжают нелинейно.

В итоге сделали умнее:

  • Вы перетаскиваете кольцо туда, где оно вам удобно (например, аккуратно в правый нижний угол чата или в шапку), а ContextRing запоминает привязку к двум ближайшим краям окна — причём раздельно для обычного оконного режима и для macOS Fullscreen (плюс есть режим «Свободно на экране»).

  • С помощью NSWorkspace, CGWindowListCopyWindowInfo и системного AXObserver приложение отслеживает окна Antigravity на всех рабочих столах (Spaces) и при свайпах в полноэкранном режиме. Переключились в браузер — кольцо моментально исчезло. (С единственным исключением: пока открыто собственное окно настроек ContextRing, кольцо не прячется, чтобы вы видели результат, когда двигаете ползунки размера и толщины дуги!)

  • И главная фишка для тех, кто часто меняет масштаб в IDE: ContextRing подглядывает параметр zoomLevel в ~/Library/Application Support/Antigravity/User/settings.json и пропорционально масштабирует само кольцо, шрифт процентов, всплывающую подсказку и поповер вместе с интерфейсом Antigravity.

2. Event-driven движок и 0.0% CPU в простое

В первых прототипах приложение периодически сканировало папку чатов по таймеру. Но когда в ~/.gemini/antigravity/brain/ накапливается 40–50 сессий по несколько сотен шагов, крутить регулярный опрос — преступление против батареи ноутбука.

В версии 1.1.0 мы полностью перевели AntigravityDataReader на событийную модель:

  • На активный transcript.jsonl, каталог brain/ и файлы SQLite (conversation_summaries.db и conversation_summaries.db-wal) вешаются системные файловые вотчеры ядра DispatchSourceFileSystemObject.

  • Так как transcript.jsonl — это append-only лог (строки только дописываются в конец), парсер хранит lastProcessedOffset и при пробуждении делает FileHandle.seek(toFileOffset:), дочитывая и разбирая исключительно новые байты в хвосте файла.

  • Отслеживание окон переведено на AXObserver.

Результат: когда чат активен, данные обновляются мгновенно в тот же момент, как модель завершила шаг, а когда Antigravity свёрнут или неактивен — в фоне не крутится ни одного цикла опроса. Нагрузка в простое — ровно 0% CPU.

3. Детектив с «ложными сжатиями» и загадка Оркестратора

На одном из этапов тестирования я скинул в чат скриншот и пожаловался: «Смотри, два последних сообщения отмечены красной молнией сжатия, хотя никакого предупреждения о переполнении от Antigravity не было! Может, модель просто ответила коротко без инструментов, а программа подумала, что контекст сжался?»

Мы написали быстрый исследовательский скрипт и прогнали его по всем 40+ реальным транскриптам у меня на диске. И вот что вскрылось — это, пожалуй, самое интересное техническое открытие за весь проект.

Каждая без исключения просадка контекста на 10%–35% без системного CHECKPOINT была вызвана не «коротким ответом», а двумя совершенно конкретными событиями в логах:

  1. Ручная смена модели прямо посреди чата. В USER_INPUT пишется скрытый служебный тег <USER_SETTINGS_CHANGE> с текстом вроде changed setting Model Selection from Claude Opus ... to Gemini 4 .... На следующем же шаге cache_read_tokens падает в 0 (весь накопленный диалог заново заливается в новую модель как свежий input_tokens), а итоговый размер контекста сдвигается на 24%–35% только за счёт другого токенизатора и другого системного промпта!

  2. Автоматическое переключение фаз в режиме Orchestrator (Plan ↔ Execute). Перед таким скачком в логе всегда идут вызовы exit_plan_mode / enter_plan_mode или системное сообщение с тегом режима планирования. В одном и том же чате тяжёлая модель-планировщик и быстрая модель-исполнитель работают в разных контекстных «слоях» с разными системными инструкциями.

Считать падение процентов «сжатием» оказалось в корне неверно. Поэтому мы:

  • Научили парсер строго отличать реальную компактификацию (type == "CHECKPOINT" или системные маркеры вроде "Resuming from a compaction" / "This conversation grew too large") от переключений модели и уровня рассуждений (Reasoning Effort: Low / Medium / High / XHigh). В истории ходов появились точные бейджи: ⚡ сжатие, ⇄ модель и ⇄ уровень.

  • Сделали Переключатель скоупов (Scope Switcher) прямо в шапке поповера. Если чат идёт в режиме Оркестратора, одним кликом можно переключаться между Общее | Оркестр | Исполнитель; если вы вручную меняли модели в чате — между Общее | <Модели>; а если в одной длинной сессии успели поработать оба режима — включается двухуровневый переключатель. Причём выбор скоупа пересчитывает сразу всё: и цифру в плавающем кольце, и процент в менюбаре, и карточки сводки!

4. Баг пустого чата и «почему одно слово “привет” весит 15 300 токенов?!»

Буквально перед финальным пушем вылезла забавная мелочь: открываю в Antigravity совершенно новый пустой чат — а кольцо всё ещё показывает ненулевые проценты из предыдущего разговора.

Полезли в AntigravityDataReader.swift и нашли сразу две «медвежьи услуги» в коде: когда у нового пустого чата заголовок окна равен просто "Antigravity" или "ContextRing - Antigravity" (без названия беседы), наш резолвер включал фоллбэк по workspace_uris и услужливо подтягивал последний завершённый чат в этом же проекте.

Починили: теперь в пустом чате кольцо честно уходит в нейтральное серое состояние с прочерком —, а как только вы отправляете первое сообщение, вотчер папки brain/ моментально подхватывает свежесозданный transcript.jsonl.

Проверяю фикс: открываю новый чат, пишу одно слово — привет. Кольцо оживает и рисует: 15.3k токенов (8%).

Я даже переспросил в чате: «15Кт за одно сообщение? Это правда?»

Кликнул по кольцу, раскрыл вкладку «Структура контекста → Система и правила» — и сам себе ответил на этот вопрос. Само слово «привет» там занимает от силы 10 токенов. Но вместе с первым ходом Antigravity отправляет в модель всю базовую инфраструктуру сессии:

  • системные правила поведения агента, протокол планирования и артефактов;

  • полные JSON-схемы всех встроенных инструментов (read_file, edit_file, run_command, invoke_subagent, swarm, search_web и других);

  • описания доступных навыков (skills) и плагинов;

  • глобальные пользовательские правила и метаданные рабочего пространства.

На первом сообщении вся эта 15-тысячная глыба идёт как свежий input_tokens, зато уже со второго сообщения 96–99% этого объёма читается из Prompt Cache почти бесплатно по задержке. Видеть эту механику в реальном времени оказалось невероятно полезно — сразу понимаешь, во сколько обходится каждый лишний подключённый MCP-сервер или раздутый системный файл правил.

5. Жизнь в экосистеме macOS: LaunchAgent, сертификат для Accessibility и не-админские учётки

Ещё три детали, которые редко допиливают в пет-проектах, но без которых утилитой неприятно пользоваться каждый день:

  • Режим запуска «С Antigravity» без фонового процесса. Мне не хотелось, чтобы кольцо висело в оперативной памяти круглосуточно, если сама IDE закрыта — и при этом не хотелось связывать его с плагином. Сделали через нативный LaunchAgent (LaunchAgentManager.swift), который регистрирует WatchPaths на служебные файлы ~/Library/Application Support/Antigravity/ (SingletonLock, window_state.json, Preferences). Пока IDE закрыта — процесса ContextRing в системе нет вообще. Открываете Antigravity — launchd тут же запускает приложение; закрываете IDE — ContextRing сам корректно завершается. (Но при желании в настройках можно выбрать и классический SMAppService «С системой» или «Вручную»).

  • Чтобы права Accessibility не слетали после каждой пересборки. Любой, кто собирал локальные Swift-утилиты под macOS, знает эту боль: стоит перекомпилировать бинарник — и macOS TCC сбрасывает галочку «Универсального доступа», приходится каждый раз удалять и добавлять приложение заново. В ContextRing добавили скрипт setup_signing_cert.sh, который один раз создаёт локальный 10-летний сертификат подписи кода, а build.sh привязывает codesign designated requirement к subject.CN сертификата вместо хеша исполняемого файла. Пересобираете приложение сколько угодно раз — права остаются на месте.

  • Обычная (не-админская) учётка macOS. При установке через ./install.sh без прав записи в /Applications установщик либо вызывает стандартный нативный диалог авторизации администратора macOS, либо (при отмене или с флагом --user) аккуратно ставит приложение в ~/Applications/ContextRing.app.


Визуальный тур: что умеют ContextRing и chat_tokens сейчас

Оба инструмента показывают одинаковую, выверенную аналитику, синхронизируют тёмную и светлую тему с самим Antigravity (плюс есть кнопка переключения Авто / Светлая / Тёмная прямо в шапке) и полностью переведены на русский и английский языки.

1. Вкладка «Контекст» (текущая сессия)

Тёмная тема
Тёмная тема

Что здесь есть:

Порог предупреждения: пресеты 128k, 160k, 200k, 256k, 1M и поле Свой (300k, 500000, 1.5M и т.д.).

Переключатель последних 10 чатов в один клик (с автовозвратом к текущему активному окну Antigravity при смене вкладки в IDE).

Переключатель скоупов (Общее | Оркестр | Исполнитель или по моделям).

Выровненная таблица «Структура контекста» по 6 категориям: Система и правила (с подкатегориями), Файлы в контексте (раскрывается список реально открытых/изменённых файлов), Инструменты и команды (раскрывается со счётчиком вызовов), Ответы модели, Рассуждения (Thinking) и Сообщения пользователя. Строки с 0 токенов не захламляют экран.

Сводка из 6 плиток: основная модель с пилюлей уровня рассуждений (Low / Medium / High / XHigh), прирост за последний ход, эффективность кэша (последний ход и среднее за чат), счётчик сообщений/шагов и исторический пик, суммарный вход/вывод и длительность сессии.

Светлая тема
Светлая тема

Кнопка «Скопировать промпт для HANDOFF.md» в 1 клик — готовая заготовка, чтобы красиво передать эстафету новому чату до того, как сработает сжатие (честно не знаю что это, агент сделал, я даже не проверял содержание и работоспособность)

История по шагам или по сообщениям с бейджами ⚡ сжатие, ⇄ модель и ⇄ уровень.

2. Вкладка «Статистика» (24ч / 7дн) и единое окно настроек

Глобальная статистика (24ч / 7дн)
Глобальная статистика (24ч / 7дн)

На вкладке Статистика собирается аналитика по всем чатам за последние 24 часа или 7 дней: количество чатов, сообщений, вызовов моделей и сжатий, свежий вход, объём чтения из кэша, генерация вывода, активное время, а также раскрывающиеся списки использованных моделей, самых частых файлов, инструментов и кликабельный список активных чатов.

Окно настроек (Тёмная)
Окно настроек (Тёмная)

В настройках можно выбрать один из трёх визуальных стилей кольца (Классика, Минимал, Codex), привязать масштаб к zoomLevel IDE, подкрутить диаметр, толщину дуги, размеры шрифтов и режим автозапуска.

Когда мы с Gemini почти допилили оба проекта, я попросил проверить на GitHub — может, пока мы всё это строили, кто-то уже выкатил ровно то же самое? (на самом деле я раньше просил проверить, на другом компе, гемини еще тогда ответил что нет того что я хочу)

Картина в экосистеме Antigravity оказалась показательной:

  • Есть сайдкар-плагины внутри IDE (dimitr-io/antigravity-desktop-context, ahmetdotsh/agy-context, myslithell/antigravity-tokens-hud, n2ns/antigravity-panel) — они дают панель внутри самой среды, как наш chat_tokens, но без 0-токен /чат-перехватчика в переписке и, конечно, без плавающего оверлея поверх окна.

  • Есть утилиты в строке меню для квот (cursoraiht-maker/gemini_antigravity, а для других сред — ClaudeBar, TokenBar) — они следят в основном за серверными лимитами и таймерами сброса (для этого им нередко приходится подключаться к внутреннему недокументированному локальному RPC-порту процесса IDE, что легко ломается при обновлениях). Мы принципиально не стали лезть во внутренние порты и сетевые токены ради сохранения подхода «100% чтение файлов с диска, 0 сетевых вызовов».

  • Есть инлайн-патчи вроде brien9/antigravity-context-ring, которые пытаются встроить кольцо прямо в интерфейс самой IDE через модификацию клиента — а значит, рискуют слетать после каждого автообновления Antigravity.

А между нашими двумя проектами выбор максимально простой:

Критерий

chat_tokens

ContextRing

Платформы

macOS / Linux / Windows

macOS 13+ (Universal: Apple Silicon + Intel)

Где живёт интерфейс

Правая боковая панель IDE (Sidecar) + чат

Плавающее кольцо поверх окна IDE + строка меню

Работает при закрытом сайдбаре

Только по команде /чат / /ctx в переписке

Да, всегда перед глазами

Команды /чат и /ctx за 0 токенов

Да (PreInvocation хук)

Нет (только визуальный интерфейс)

Отслеживание окон, Spaces и Fullscreen

Не требуется (внутри окна IDE)

Да (раздельные якоря + скейлинг с zoomLevel)

Структура контекста, Оркестратор, Статистика 24ч/7дн

Да

Да

Нагрузка в простое

По запросу в UI / хуке

0% CPU (событийные вотчеры + seek хвоста)

Зависимости и права

Встроенный в IDE Node.js + Python 3

Чистый нативный Swift, желательно право Accessibility

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


Выход в Open Source и дежавю с Co-Authored-By на GitHub

Оба проекта полностью открыты под лицензией MIT — без телеметрии, без скрытых сетевых запросов и без модификации системных файлов IDE.

Правда, при публикации снова не обошлось без комичного эпизода на GitHub. Однажды, когда мы выкладывали другую нашу macOS-утилиту TurboControl, ассистент сам вписал в трейлер коммита Co-authored-by: ... <antigravity@google.com>, и GitHub радостно добавил в контрибьюторы репозитория совершенно незнакомого американского разработчика, за которым, видимо, когда-то числился этот ящик.

В первых коммитах chat_tokens мы решили подстраховаться и написали аккуратнее: Co-Authored-By: Antigravity (Google DeepMind) <antigravity@users.noreply.github.com>. Открываю страницу репозитория на GitHub — и снова вижу в контрибьюторах постороннего человека! Оказалось, логин @antigravity на GitHub давным-давно занят обычным пользователем, и платформа привязала коммиты к его профилю. Пришлось вычищать трейлер, чтобы не пугать случайных людей внезапным соавторством в Swift- и Python-репозиториях.


Как поставить и попробовать

1. ContextRing (нативное кольцо для macOS)

  • Репозиторий: github.com/vladsboev-web/ContextRing

  • Установка через Homebrew (рекомендуется):

    brew install --cask vladsboev-web/tap/contextring
    
  • Сборка из исходников (понадобится только xcode-select --install):

    git clone https://github.com/vladsboev-web/ContextRing.git
    cd ContextRing
    ./setup_signing_cert.sh   # один раз создаёт локальный сертификат, чтобы не слетали права Accessibility
    ./install.sh              # или ./install.sh --user для установки в ~/Applications без прав админа
    

2. chat_tokens (кроссплатформенный плагин для IDE: Sidecar + /чат и /ctx)

  • Репозиторий: github.com/vladsboev-web/chat_tokens

  • Установка через CLI agy:

    agy plugin install https://github.com/vladsboev-web/chat\\_tokens
    
  • Или вручную (затем перезапустить Antigravity 2.0):

    git clone https://github.com/vladsboev-web/chat\\_tokens.git ~/.gemini/config/plugins/chat_tokens
    

Если вы тоже пользуетесь Google Antigravity и хоть раз ловили внезапное “This conversation grew too large…” в самый неподходящий момент — забирайте, тестируйте и рассказывайте в комментариях, на каких объёмах контекста у вас обычно включается сжатие и как вы передаёте контекст между сессиями!


Уважаемые разрабы Google, прислушивайтесь к своим юзерам, можете Gemini озадачить, он поможет.

Вся работа и статья и дизайн - Gemini 4 Argon High