Как создавался десктопный виджет лимитов для Claude со встроенным анимированным крабом

Разработчик поделился опытом создания компактного виджета лимитов для Claude под Windows, который за месяц эволюционировал из простого скрипта в многофункциональное приложение с анимированным маскотом-крабом, погодными эффектами и системой кастомизации.

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

Предпосылки создания и первая версия виджета

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

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

Развитие проекта и добавление интерактивного маскота

Свободное пространство над индикатором пятичасового лимита натолкнуло на мысль разместить на нем анимированного персонажа. В качестве визуального образа был выбран пиксельный краб Clawd, знакомый пользователям по экрану приветствия терминального интерфейса.

Поведение персонажа и реакция на состояние сессии

Маскот получил набор анимаций, отражающих текущий статус работы системы:

• в неактивном состоянии персонаж погружается в песок и отдыхает;
• во время выполнения активных задач сессии он перемещается по экрану;
• при ожидании пользовательского ввода маскот приветственно машет лапой;
• при приближении к исчерпанию лимита краб начинает визуально потеть;
• после полной выработки лимитов персонаж переворачивается кверху лапками.

Погода, динамический фон и функциональные модули

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

Функциональность расширили за счет напоминаний, списков задач с чекбоксами и регулярных заданий по расписанию, которые корректно приостанавливают активность при критическом исчерпании лимитов. Кроме того, в интерфейс интегрировали недельную статистику расхода квот, список активных проектов и сеансов с удаленных машин. Из-за растущей популярности у пользователей в различных организациях потребовалась гибкая персонализация, после чего в систему внедрили различные цветовые темы и скины для маскота.

Особенности разработки с использованием ИИ

Создание утилиты велось без ручного написания исходного кода: автор формировал текстовые требования, оценивал полученные результаты и отправлял их на доработку. Такой подход напоминал взаимодействие с технической командой разработки. В результате месячной работы объем утилиты вырос до десяти тысяч строк и тридцати шести модулей, сохранив при этом архитектуру на чистом PowerShell без сторонних зависимостей.

Итоговый функционал и возможности утилиты

Готовый продукт представляет собой плавающее окно поверх рабочего стола и значок в системном трее. Для работы требуются операционная система Windows и установленный клиент Claude Code без дополнительных громоздких установщиков или сред выполнения вроде Node.js.

Основные компоненты виджета

• Лимиты: отображение процента использования пятичасовой сессии, недельных квот и таймера до сброса с использованием официальной команды терминала без расхода токенов модели.
• Сессии: мониторинг активных процессов и агентов, ожидающих ответа.
• История и статистика: графики расхода за неделю и перечень приоритетных проектов.
• Статус сервисов: проверка работоспособности официальных серверов и актуальной версии ПО.
• Интерфейс и оформление: настраиваемый маскот, погодные эффекты, поддержка восьми тем оформления и более двадцати визуальных скинов, а также мультиязычный интерфейс (английский, русский, французский).
• Обслуживание: встроенный механизм автоматического обновления с функцией отката при возникновении сбоев.

Распространение и установка

Проект опубликован в открытом доступе на GitHub и привлек внимание сообщества, которое занялось созданием портов утилиты для других операционных систем, включая macOS, Linux, Android и iOS.

Для инсталляции необходима система Windows 10 или 11 с настроенным и активным клиентом Claude Code. После клонирования репозитория или загрузки архива достаточно запустить управляющий файл сценария для инициализации работы виджета.