Напоминалка для Claude Code на Electron: хуки, журнал уведомлений Windows и цена в мегабайтах
Есть одна бытовая проблема, с которой я столкнулся, когда начал пользоваться Claude Code: даёшь ассистенту задачу на четверть часа, уходишь в браузер или игру, а он через две минуты упирается в вопрос «можно запустить эту команду?» и стоит. Уведомление Windows при этом честно показывается, но на несколько секунд и в углу, куда я не смотрю. Возвращаешься — а простоя уже на двенадцать минут.
Будильник и звук не помогли: звук привычно игнорируешь, будильник не знает, что именно произошло. Нужно было что-то, что реагирует на событие и достаточно нахально, чтобы его заметить. Так появилась маленькая программа «Маскот»: оранжевый человечек, который выглядывает из правого нижнего угла экрана, а при игнорировании выходит целиком и топает по панели задач. Ниже — не реклама, а заметки по тому, как это сделано, и, раз сайт железячный, честные цифры по ресурсам. Электрон не лёгкий, и скрывать это бессмысленно.

Две задачи, а не одна
реклама
Сначала я думал, что надо просто нарисовать окошко. Оказалось, что есть две независимые задачи:
- узнать, что Claude ждёт ответа;
- показать это так, чтобы заметили, но чтобы окно не лезло в работу.
Первая задача хитрее, чем кажется.
Откуда берётся сигнал
У терминального Claude Code есть хуки. В файле ~/.claude/settings.json можно описать команду, которую запустят при определённом событии, а JSON с подробностями придёт ей в stdin. Для моей задачи подходит событие Notification. Команда в хуке тривиальная: она просто пересылает stdin на локальный порт, где слушает программа:
curl -s -m 2 --data-binary @- http://127.0.0.1:47821/hook || exit 0
Хвост || exit 0 важен: если маскот не запущен, команда должна молча завершиться успешно, иначе Claude Code на каждом событии будет ругаться на упавший хук. Сервер у программы слушает только 127.0.0.1 и отбрасывает запросы с заголовком Origin. Браузер всегда его добавляет, так что любая открытая вкладка не сможет «позвонить» в порт и вызвать маскота; утилита вроде curl заголовка не шлёт и проходит.
На этом я решил, что всё готово, и проверил в терминале: работает. А потом открыл десктопную версию Claude, и маскот молчал. Выяснилось, что вкладка Code в десктопном приложении при запросе разрешения или вопросе событие Notification не отправляет. Пришлось добавить ещё два хука: PermissionRequest и PreToolUse с фильтром по инструментам, которые сами задают вопрос или просят утвердить план. Программа прописывает их при запуске, предварительно делая копию settings.json (пять последних копий хранятся рядом), и чужие хуки не трогает.
Но и этого мало: уже открытые сессии могут не подхватить новые хуки до перезапуска. Нужен был второй источник, не зависящий от Claude вообще.
Журнал уведомлений Windows
Оказалось, что Windows 10 и 11 складывает каждую показанную плашку в обычную базу SQLite: %LOCALAPPDATA%\Microsoft\Windows\Notifications\wpndatabase.db. В таблице NotificationHandler лежат идентификаторы приложений, в Notification — сами уведомления с возрастающим Id. Десктопный Claude значится там как Claude_…!Claude. Достаточно раз в секунду открывать базу только на чтение и спрашивать максимальный Id среди его уведомлений: если число выросло — пришло новое.
select max(n.Id) from Notification n join NotificationHandler h on h.RecordId = n.HandlerId where h.PrimaryId glob 'Claude_*!Claude' and n.Type = 'toast'
Вызов node:sqlite встроен в Node, поэтому ни сборки, ни нативных модулей. Плюс этого приёма в том, что он не лезет в Claude и работает с уже запущенным процессом. Минус тоже понятен: база — внутренняя, формат Microsoft не документирует, и в какой-то версии Windows всё может поменяться. Поэтому ошибки чтения не роняют программу: при блокировке или отсутствии базы она молча пробует снова через десять секунд.
Плашка Windows против маскота
Интересное осложнение: пока Windows рисует свою плашку, а маскот выглядывает одновременно, получается дубль. Для этого сделана опция «заменять плашку маскотом». Она выставляет для приложения Claude параметр ShowBanner = 0 в ветке реестра HKCU\Software\Microsoft\Windows\CurrentVersion\Notifications\Settings. Баннеры пропадают, а записи в центре уведомлений и в базе остаются, поэтому маскот их по-прежнему видит. Самое важное здесь — аккуратно вернуть всё обратно. Прежнее значение (или факт, что значения не было) сохраняется в конфиг и восстанавливается при выключении опции, при выходе, при завершении сеанса Windows, а также при следующем старте, если программа до этого упала. Менять чужие настройки реестра и не вернуть — это то, что я сам терпеть не могу в чужом софте.
Окно, которое сверху, но не мешает
С визуальной частью проще, чем думалось, потому что почти всё уже есть в Electron. Окно без рамки, прозрачное, alwaysOnTop на уровне screen-saver (чтобы перекрывать и полноэкранные приложения), skipTaskbar, focusable: false — последнее принципиально, иначе пока вы набираете сообщение, фокус уйдёт к маскоту и половина слов улетит в никуда.
Остаётся вопрос кликов. Окно растянуто на всю ширину рабочей области (высота 190 пикселей над панелью задач), и по идее оно закрывает полосу экрана, на которой вы работаете. Выручает пара вызовов: setIgnoreMouseEvents(true, { forward: true }) делает окно прозрачным для кликов, но продолжает пересылать странице движения мыши. Страница ловит наведение на самого маскота и включает клики обратно, а когда курсор уходит — выключает. Вручную считать форму окна не пришлось.

Чтобы понять, активно ли окно Claude (тогда маскот не нужен и сразу убегает), используется WinAPI через koffi: GetForegroundWindow и несколько соседних функций вызываются из JavaScript без node-gyp и без установленных Visual Studio Build Tools. Окно считается окном Claude, если процесс называется claude.exe или слово «claude» есть в заголовке. Опрос раз в 300 мс. Клик по маскоту разворачивает окно Claude; если оно спрятано в трей, запускается claude.exe повторно, и приложение само показывает уже открытое окно.
Характер
Поведение я отлаживал на HTML-демо ещё до программы. Сценарий такой: три выглядывания из угла с паузой семь секунд (первые два спокойные, третье уже с нахмуренными бровями), потом маскот выходит целиком на двадцать секунд, краснеет, топает, трясёт кулаками, из головы идёт пар. Затем уходит и всё повторяется, пока вы не откликнетесь. Звук синтезируется на лету через WebAudio: «бормотание», рот открывается по слогам. Чтобы звук играл без клика, пришлось включить autoplayPolicy: 'no-user-gesture-required'. Фразы выбираются случайно, но не повторяются подряд — иначе через два дня они бесят сильнее самого простоя.

Сколько это стоит в мегабайтах
реклама
Теперь то, ради чего я бы сам читал такую запись на этом сайте. Электрон-приложение ради одного человечка, который почти всё время сидит в трее, — это спорная трата памяти, и я решил замерить, прежде чем говорить красивые слова.
Стенд: Windows 10 Enterprise LTSC 2021, сборка win-unpacked версии 1.1.0 (Electron 45), запуск с отдельным каталогом данных, программа в простое: окно создано, маскот спрятан, работают опрос активного окна (300 мс) и опрос базы уведомлений (1 с). Замер через 25 секунд после запуска, затем ещё 30 секунд наблюдения за процессорным временем.
| Показатель | Значение |
|---|---|
| Процессов Mascot.exe | 4 |
| Рабочий набор, сумма | ≈ 306 МБ |
| Приватная память, сумма | ≈ 193 МБ |
| Процессорное время за 30 секунд простоя | 0,2 с (около 0,7% одного ядра) |
| Размер файла portable / установщика | 98,6 МБ / 108,3 МБ |
Выводы у меня такие. Процессор программа почти не нагружает: опросы редкие и дешёвые. А вот память — это обычная цена Chromium: четыре процесса Chromium и под двести мегабайт приватной памяти ради нескольких SVG-картинок. Если у вас 8 ГБ и вы и так упираетесь в память, это заметно. Я думал о том, чтобы вынести логику в крошечный нативный процесс, а рисовать только по требованию, но пока не стал: портативность и возможность за вечер поправить анимацию в HTML перевесили. Если у кого-то есть соображения, как урезать аппетит Electron в таком сценарии, — напишите в комментариях, мне правда интересно.
Для сравнения: размер файла в сто мегабайт — это почти целиком сам Chromium и рантайм Node, программа в нём занимает совсем немного.
Обновления и мелкие грабли
Установщик (NSIS) обновляется сам через electron-updater с GitHub Releases: проверка через 15 секунд после старта и затем раз в шесть часов, новую версию скачивает в фоне и ставит при перезапуске. Portable-версия так не умеет, поскольку запущена из временной папки распаковки, поэтому только сообщает о новой версии и открывает страницу релиза. Из-за той же временной папки пришлось отдельно решать вопрос автозапуска: путь берётся из переменной PORTABLE_EXECUTABLE_FILE, а не из process.execPath.
Ещё одна мелочь, которая стоила мне вечера: electron-builder загружает артефакты в релиз параллельно и иногда плодит дубликаты релиза с одним тегом. Лечится тем, что в GitHub Actions релиз сначала создаётся командой gh release create, а уже потом в него отправляются файлы.

Что в меню
Размер маскота (1, 1,5 или 2; по умолчанию 1,5), звук, автозапуск, язык интерфейса (русский, английский или как в Windows), отдельные переключатели каждого источника сигнала, проверка обновлений и пункт «Показать тест» — чтобы можно было убедиться, что всё работает, не дожидаясь настоящего вопроса от Claude.
Где взять
реклама
Программа бесплатная, лицензия MIT, исходники открыты. Установщик и portable лежат на странице релизов: github.com/OlegChe77/claude-mascot/releases/latest, код — github.com/OlegChe77/claude-mascot. Проверял я на Windows 10; у Windows 11 тот же журнал уведомлений, но на ней я не тестировал. Если знаете, какие ещё события Claude стоит ловить, или у вас есть идея, как сделать то же самое легче по памяти, — буду рад обсуждению.
Лента материалов
Соблюдение Правил конференции строго обязательно!
Флуд, флейм и оффтоп преследуются по всей строгости закона!
Комментарии, содержащие оскорбления, нецензурные выражения (в т.ч. замаскированный мат), экстремистские высказывания, рекламу и спам, удаляются независимо от содержимого, а к их авторам могут применяться меры вплоть до запрета написания комментариев и, в случае написания комментария через социальные сети, жалобы в администрацию данной сети.

