01Что это
GSD Cloud Daemon — небольшой Go-бинарник, который ты ставишь на свою рабочую машину. Он поднимает persistent websocket-соединение с GSD Cloud relay (облачный сервис от GSD) и работает мостом между твоим локальным Claude Code и облаком.
Зачем это нужно? Чтобы доступ к твоим Claude Code сессиям был с любого устройства — с телефона на пробежке, с планшета в кафе, с другого ноутбука. Daemon делает это возможным, не теряя главного: код и сессии остаются на твоей машине. В облако стримятся только output и метаданные.
Open source — можно проверить код
В отличие от закрытых cloud-демонов, у этого ты можешь посмотреть весь исходник перед установкой. Никакой телеметрии, никаких скрытых данных в облако. Что в коде — то и работает.
02Установка
One-liner
$ curl -fsSL https://install.gsd.build | shЛогин и старт
$ gsd-cloud login $ gsd-cloud startВсё. Daemon работает в фоне, поддерживает соединение с relay'ем и регистрирует твою машину в твоём аккаунте GSD Cloud. Можешь подключаться к локальным сессиям с других устройств через web-интерфейс GSD Cloud.
Дополнительные команды
# Логи демона $ gsd-cloud logs # Проверить версию $ gsd-cloud version # Файлы состояния
~/.gsd-cloud/03Что делает
Чёткие границы того, что демон делает и не делает.
Persistent websocket
Поддерживает постоянное соединение с GSD Cloud relay. Heartbeat'ы, авто-реконнект при разрыве, online/offline индикация для UI.
Управление Claude Code сессиями
Запускает локальные сессии Claude Code от твоего имени и трекает их статус. Метадата активных сессий доступна через локальный socket.
Стрим output
Стримит output сессии обратно в облако для доступа с других устройств. Только output, который ты сам попросил произвести.
Local write-ahead log
Сохраняет состояние сессий в локальный WAL в ~/.gsd-cloud/. Crash-safe — после рестарта демона ничего не теряется.
04Operator Diagnostics Boundary
Демон намеренно экспонирует небольшую remote-поверхность. Это важная часть design'а — даёт операторам облака минимальные диагностические возможности без захвата контроля над твоей машиной.
✓ Что демон делает
- + Heartbeats relay'ю — periodic ping для определения online/offline статуса
- + Local socket status — даёт информацию о состоянии локального socket'а
- + Active session metadata — какие сессии запущены, их PID, статус (без содержимого)
- + Task output — output, который пользователь сам попросил демона произвести
✗ Что демон НЕ делает
- − Нет remote daemon-log стриминга для операторов — логи остаются на твоей машине
- − Нет background support bundle upload — ничего не отправляется в фоне без твоего ведома
- − Нет автоматического upload локальных логов при failures — даже при крэшах
Если incident требует инспекции daemon-логов, supported path — локальный доступ на твоей машине: gsd-cloud logs или файл логов в ~/.gsd-cloud/.
Единственный bounded upload-путь в демоне сейчас — explicit task-related image upload в relay (когда ты явно попросил отправить картинку). Этот путь не является general-purpose диагностическим каналом и не должен использоваться как такой при incident response.
05Сборка из исходников
Если хочешь собрать сам или поучаствовать в разработке:
$ git clone https://github.com/gsd-build/daemon.git
$ cd daemon
$ go build -o gsd-cloud . $ ./gsd-cloud versionСтандартный Go-проект. Зависимости минимальны. Структура читаемая — cmd/, internal/, main.go в корне.
В связке с экосистемой
GSD Cloud daemon — облачная инфраструктура для всей экосистемы:
- get-shit-done — daemon позволяет смотреть прогресс сессий с любого устройства
- gsd-2 — особенно полезен с
auto mode: запустил, ушёл, проверяешь прогресс с телефона - Любой Claude Code workflow — daemon универсален, не привязан к GSD-инструментам
06Глоссарий
gsd-cloud CLI.