remote-claude-daemon

remote-claude-daemon

Демон для Telegram-бота Remote Desktop: стримит экран Mac в Mini App, принимает управление (клики/клавиатура) и выполняет AI-запросы через локальный Claude Code.

Запуск

npx remote-claude-daemon --token <токен>

Токен выдаёт бот после оформления подписки (/start).

По умолчанию команда запускает daemon в фоне и сразу освобождает терминал; управление остаётся в иконке menu bar. Логи: ~/.remote-claude/logs/daemon.log и ~/.remote-claude/logs/daemon-error.log.

# Диагностика в привязанном к терминалу режиме
npx remote-claude-daemon --token <токен> --debug

# Проверить или остановить фоновый процесс
npx remote-claude-daemon --status
npx remote-claude-daemon --stop

Фоновый запуск действует до logout/reboot или --stop; автозапуск через launchd пока намеренно не устанавливается.

Требования

Везде: Node.js 22+. Опционально: Claude Code — для AI-запросов из чата.

macOS

• Готовые universal-бинарники для Apple Silicon и Intel уже входят в npm-пакет: первый запуск не компилирует Swift и не требует Xcode Command Line Tools. Swift остаётся только запасным путём для разработки из исходников или редкой неподдерживаемой архитектуры.
• Разрешения в Системных настройках → Конфиденциальность: Запись экрана (трансляция), Камера (если включаете её из иконки в строке меню) и Универсальный доступ (клики/клавиатура)
• ffmpeg (brew install ffmpeg) — для голосовых сообщений

Windows (бета)

• ffmpeg в PATH: winget install ffmpeg (или choco install ffmpeg)

Linux (бета, только X11)

• ffmpeg и xclip: sudo apt install ffmpeg xclip
• Wayland пока не поддерживается — нужен X11-сеанс

AI-режим в Mini App

Кнопка ✨ AI переключает строку ввода из режима печати в удалённое окно в режим задачи для локального Claude Code. Удержание 🎤 в этом режиме записывает до 10 секунд команды, распознаёт её локальным Whisper и передаёт Claude для выполнения. Например: «запусти браузер».

Камера

На macOS иконка демона в строке меню позволяет выбрать «Транслировать экран» или «Транслировать камеру». Одновременно работает только один источник. Камера включается только когда Mini App открыта у владельца; гостям по /share её кадры не передаются — они увидят статус «Камера недоступна гостям».

Микрофон и первый запуск

Трансляция микрофона по умолчанию выключена: включите «Трансляция микрофона» в tray (⌘M) или /audio в боте. После первого отправленного видеокадра демон в фоне подготавливает аудио-бинарник, но не захватывает и не передаёт микрофон до явного включения.