Masko for Claude Code

Что такое Masko for Claude Code?

Masko for Claude Code — бесплатный open-source компаньон для macOS, который отображает анимированного персонажа поверх сессий Claude Code. Он отслеживает активность сессий в реальном времени, появляется при необходимости разрешения или внимания от Claude и позволяет одобрять или отклонять действия, не переключаясь из вашего рабочего процесса кодирования.

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

Ключевые возможности

• macOS overlay mascot для Claude Code: Персонаж плавает поверх других окон и обновляется в зависимости от состояния сессии (например, idle, working, attention).
• Обработка разрешений в реальном времени: Когда Claude запрашивает выполнение команды, наложение предлагает поток allow/deny с клавиатуры вместо переключения мышью.
• Панель уведомлений: Панель показывает снимки сессий (например, running/awaiting input/compacting), ленту событий с цветовой кодировкой и сводки сессий.
• Отслеживание субагентов: Мониторит дочерние агенты в реальном времени, чтобы вы видели, что происходит за пределами основной сессии.
• Управление сессиями с клавиатуры: Включает сочетания клавиш для переключения между сессиями, перехода на вкладку терминала с Claude Code и подтверждения разрешений.
• Локальное поведение: Приложение использует систему хуков Claude Code для получения метаданных событий (названия инструментов и статус сессии), но не читает ваш код; работает локально без отправки кода на сервер.

Как использовать Masko for Claude Code

1. Скачайте и установите на macOS: Установите приложение через предоставленный DMG для macOS; оно размещается в меню-бاره, не загромождая Dock.
2. Предоставьте доступ один раз: При первом запуске приложение автоматически устанавливает хуки Claude Code и запросит разрешение на доступность для наложения.
3. Запустите Claude Code: Откройте терминал и запустите Claude Code как обычно, чтобы приложение могло наблюдать за сессиями.
4. Взаимодействуйте через наложение: При запросе (например, Claude хочет выполнить команду или задать вопрос) используйте сочетания клавиш для одобрения/отклонения и фокусировки нужной вкладки терминала.
5. Выберите персонажа: Используйте один из шести встроенных персонажей по умолчанию или загрузите кастомные с masko.ai в десктопное приложение.

Сценарии использования

• Одобряйте команды Claude Code без смены контекста: Когда Claude запрашивает разрешение на выполнение (например, команды сборки), наложение предлагает действия allow/deny для быстрого подтверждения с клавиатуры.
• Следите за действиями Claude в нескольких сессиях: С переключателем сессий и переходом на вкладку терминала вы можете управлять несколькими сессиями Claude и перемещаться на точную вкладку для каждой.
• Просматривайте активность сессий и вызовы инструментов: Используйте панель уведомлений для анализа упорядоченных событий (вызовы инструментов и завершения) и понимания изменений в сессии со временем.
• Обрабатывайте моменты «ожидание ввода»: Когда сессия ожидает ввода, панель и уведомления помогают выявить это состояние и быстро отреагировать.
• Отслеживайте активность агентов с субагентами: Если ваш процесс запускает дочерние агенты, отслеживание субагентов показывает их активность в реальном времени для полного пути выполнения.

FAQ

Masko for Claude Code бесплатный?

Да. Десктопный компаньон бесплатный и open source под лицензией MIT.

Требует ли Masko сервер или API-ключи?

Нет. Нет файлов конфигурации, сервера или API-ключей — всё работает локально.

Что собирает Masko и читает ли он мой код?

Masko использует систему хуков Claude Code и получает метаданные событий, такие как названия инструментов и статус сессии. Ваш код не читается.

Как работают персонажи?

Приложение включает шесть персонажей по умолчанию. Вы также можете создавать или загружать кастомные с masko.ai в десктопное приложение.

Может ли Masko переключить на нужный терминал?

Да. Наложение предоставляет сочетание клавиш для мгновенного фокуса на вкладке терминала с Claude Code и поддерживает терминалы и редакторы со страницы (например, iTerm2, Terminal.app, VS Code, Ghostty).

Альтернативы

• Подходы нативные для терминала/редактора (без оверлея): Полагайтесь на промпты Claude Code внутри терминала или IDE, отвечая на месте. Это отличается необходимостью переключать внимание вместо постоянного оверлея и дашборда.
• Общие инструменты уведомлений/автоматизации для macOS: Используйте маршрутизацию уведомлений или автоматизацию клавиатуры для выделения промптов и действий. Это более общее решение и может не обеспечивать специфическую для Claude Code наблюдаемость сессий или состояние на основе персонажа.
• Другие оверлеи для продуктивности разработчиков: Ищите инструменты с трекингом сессий и быстрым перемещением для рабочих процессов разработчиков. Они обычно фокусируются на навигации по коду или истории чатов, а не на промптах разрешений Claude Code и ленте событий сессий.
• Только CLI-рабочий процесс с ручными проверками разрешений: Запускайте Claude Code из командной строки и вручную просматривайте команды перед выполнением. Это обеспечивает максимальную простоту, но лишено видимости дашборда в реальном времени и одобрения одним кликом/клавишей из оверлея.