Desktop app

Что такое Multica Desktop, чем он отличается от веб-приложения и когда имеет смысл его использовать.

Multica Desktop — нативное desktop-приложение для macOS, Windows и Linux. Для настроенного окружения оно работает с тем же backend, что и веб-приложение, и показывает те же данные. По умолчанию Desktop использует Multica Cloud; self-hosted инстансы настраиваются через локальный runtime config file. Desktop добавляет то, чего нет в браузере: независимые группы вкладок на каждый workspace, автоматический запуск daemon и обновление в один клик.

Desktop или веб — что выбрать

	Web	Desktop
Доступ	URL в браузере	Установка нативного приложения
Несколько вкладок	Вкладки браузера (без разделения по workspace)	Отдельная группа вкладок на каждый workspace
Daemon	Запускаете `multica daemon start` сами	Стартует автоматически при запуске
Обновления	Обновите страницу	Приложение проверяет в фоне и ставит при следующем запуске
Данные после входа	Идентичны	Идентичны

Выбирайте веб для разового использования, работы на чужой машине или если не хотите ничего устанавливать. Выбирайте desktop для ежедневной работы, нескольких workspace или если не хотите управлять daemon вручную.

Несколько вкладок: что происходит при смене workspace

Desktop хранит отдельную группу вкладок для каждого workspace, в котором вы состоите. При переключении workspace вкладки текущего workspace скрываются целиком, а вкладки предыдущего восстанавливаются в том виде, в каком вы их оставили — похоже на multi-workspace в VSCode или смену workspace в Slack.

Пример: вы открыли 3 вкладки с issue в workspace A и переключились на workspace B. Три вкладки A исчезают, в B показывается то, что было открыто в прошлый раз. Вернитесь в A — те же 3 вкладки на месте. Вкладки не «утекают» между workspace.

Выход из аккаунта очищает состояние вкладок всех workspace — данные не остаются на общей машине.

Как Desktop обновляется автоматически

При запуске Desktop проверяет GitHub Releases на более новую версию. Если она есть:

Новая версия скачивается тихо в фоне.
Появляется сообщение «готово — установится при следующем запуске».
При выходе (или следующем перезапуске) приложение ставит обновление перед закрытием.
Следующий запуск уже на новой версии.

Весь процесс не прерывает текущую работу.

На Windows ARM64 и x64 — отдельные каналы обновлений. Установите неверную архитектуру — обновления не обнаружатся. При скачивании выберите .exe под вашу машину (сборка ARM помечена суффиксом arm64).

Сборка для macOS подписана и notarized — при первом запуске не будет предупреждения «unidentified developer». Linux — .AppImage; auto-update через electron-updater на некоторых дистрибутивах нестабилен. Если auto-update не сработал, скачайте новую версию вручную и замените файл.

Нужны ли отдельные CLI и daemon?

Нет. Desktop включает тот же бинарник multica CLI и при старте запускает свой daemon profile (изолированно от daemon, который вы могли запустить в терминале вручную).

Если CLI уже установлен и вы запускали multica daemon start руками, Desktop не перехватывает ваш daemon — он поднимает свой с отдельным profile. Оба регистрируются как разные runtime, в UI вы увидите два независимых runtime.

Для CLI-команд в терминале отдельного пути в Desktop нет — используйте установленный отдельно CLI или bundled-копию в resources/bin/multica внутри каталога resources приложения.

Скачивание и установка

Установщик для вашей платформы — на странице загрузок Multica:

Platform	File
macOS (Intel or Apple Silicon)	`.dmg`
Windows x64	`.exe` (standard)
Windows ARM64	`.exe` (with `arm64` suffix)
Linux	`.AppImage`

При первом запуске нужен вход — тот же email + код подтверждения, что и в вебе. После входа Desktop автоматически синхронизирует список workspace.

Desktop по умолчанию на Multica Cloud, но можно указать self-hosted через локальный config file. In-app picker «connect to self-host» по-прежнему нет. Desktop читает ~/.multica/desktop.json до старта renderer; если файла нет — defaults Cloud.

Минимальный self-host config:

{
  "schemaVersion": 1,
  "apiUrl": "https://api.your-domain"
}

apiUrl обязателен и должен быть http или https. Desktop выводит wsUrl как /ws на том же origin (wss для https, ws для http) и appUrl из origin API. Если у развёртывания разные origin, задайте явно:

{
  "schemaVersion": 1,
  "apiUrl": "https://api.your-domain",
  "wsUrl": "wss://api.your-domain/ws",
  "appUrl": "https://your-domain"
}

Если desktop.json есть, но невалиден, Desktop fail closed и показывает блокирующую ошибку config вместо тихого fallback на Cloud. В dev-сборках VITE_API_URL / VITE_WS_URL / VITE_APP_URL по-прежнему имеют приоритет при electron-vite dev. Runtime self-host config для Desktop реализован в issue #1371.

Дальше

Cloud Quickstart — onboarding в Cloud для Desktop
Self-Host Quickstart — свой backend и подключение через CLI или Desktop runtime config
Daemon and runtimes — как работает daemon (Desktop запускает его за вас, поведение то же)