デスクトップアプリ

Multica Desktop とは何か、Web アプリとどう違うのか、そしてどんなときに使う価値があるのかを解説します。

Multica Desktop は macOS、Windows、Linux 向けのネイティブデスクトップアプリです。設定された環境に対して、Web アプリと同じバックエンドに接続し、同じデータを表示します。Desktop はデフォルトで Multica Cloud を使用しますが、セルフホスト環境はローカルのランタイム設定ファイルで構成できます。Desktop はブラウザにはできないいくつかの機能も追加で提供します。ワークスペースごとの独立したタブグループ、デーモンの自動起動、ワンクリックアップグレードです。

Desktop か Web か — どちらを選ぶか

	Web	Desktop
アクセス方法	ブラウザで URL を開く	ネイティブアプリをインストール
複数タブ	ブラウザ自体のタブ（ワークスペースの区別なし）	ワークスペースごとに独立したタブグループ 1 つ
デーモン	`multica daemon start` を自分で実行	起動時に自動的に開始
アップグレード	更新すると最新版になる	アプリがバックグラウンドで確認し、次回起動時にインストール
ログイン後のデータ	同一	同一

Web を選ぶ: 一度きりの利用、他人のマシンでの作業、何もインストールしたくないとき。 Desktop を選ぶ: 毎日の利用、複数のワークスペースを同時に扱うとき、デーモンを手動で管理したくないとき。

複数タブ: ワークスペースを切り替えるとどうなるか

Desktop は参加しているすべてのワークスペースごとに独立したタブグループを保持します。ワークスペースを切り替えると、現在のワークスペースのタブが 1 つの単位として非表示になり、以前のワークスペースのタブは離れたときのまま復元されます — VSCode のマルチワークスペースの挙動や、Slack でワークスペースを切り替えるのに似ています。

例: ワークスペース A でイシューのタブを 3 つ開いた状態でワークスペース B に切り替えます。A のタブ 3 つは消え、B には B で最後に開いていたものが表示されます。再び A に切り替えると、その 3 つのタブが以前の状態そのままに戻ってきます。タブはワークスペース間で決して漏れ出しません。

ログアウトするとすべてのワークスペースのタブ状態が消去されるため、複数のユーザーでマシンを共有していてもデータが漏れることはありません。

Desktop の自動更新の仕組み

起動時に Desktop は GitHub Releases でより新しいバージョンがないかを確認します。新しいバージョンが見つかると、

バックグラウンドで新しいバージョンを静かにダウンロードします。
「準備完了 — 次回起動時にインストールされます」と通知します。
終了時（または次回の再起動時）に、アプリが閉じる前に更新をインストールします。
次回起動時に新しいバージョンが実行されます。

このプロセス全体は作業中の内容を妨げません。

Windows では ARM64 と x64 は別々の更新チャンネルです — 間違ったアーキテクチャをインストールすると更新が検出されません。ダウンロードする際は、マシンに合った .exe を選んでください（ARM ビルドには arm64 のサフィックスが付いています）。

macOS ビルドは署名・公証されているため、初回起動時に「未確認の開発者」の警告は表示されません。Linux ビルドは .AppImage です — 自動更新は electron-updater に依存しており、一部のディストリビューションでは不安定になることがあります。自動更新が動作しない場合は、新しいバージョンを手動でダウンロードして古いファイルを置き換えてください。

単体の CLI とデーモンはまだ必要ですか?

いいえ。 Desktop には同じ multica CLI バイナリが内蔵されており、起動時に独自のデーモンプロファイルを起動します（ターミナルから手動で実行しているデーモンとは隔離されます）。

すでに CLI をインストールして multica daemon start を手動で実行していても、Desktop はそのデーモンを乗っ取りません — 別のプロファイルで独自のデーモンを開始します。両者は異なるランタイムとして登録され、UI では 2 つの独立したランタイムが表示されます。

ターミナルで CLI コマンドを実行したい場合、Desktop は特別な経路を提供しません — 別途インストールした CLI を使うか、アプリのリソースディレクトリ内 resources/bin/multica にあるバンドル済みのコピーを実行してください。

ダウンロードとインストール

Multica ダウンロードページから、使用するプラットフォームのインストーラーを入手してください。

プラットフォーム	ファイル
macOS (Intel または Apple Silicon)	`.dmg`
Windows x64	`.exe`（標準）
Windows ARM64	`.exe`（`arm64` サフィックス付き）
Linux	`.AppImage`

初回起動時にはログインが必要です — Web アプリと同じメール + 認証コードのフローです。ログインすると、Desktop はワークスペース一覧を自動的に同期します。

Desktop はデフォルトで Multica Cloud を使用しますが、ローカルの設定ファイルでセルフホスト環境を指すように設定できます。 アプリ内には依然として「セルフホストに接続」を選ぶピッカーはありません。Desktop はレンダラーが起動する前に ~/.multica/desktop.json を読み込みます。ファイルがない場合は Cloud のデフォルト値を使用します。

最小構成のセルフホスト設定:

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

apiUrl は必須で、http または https を使用する必要があります。Desktop は同一オリジン上で wsUrl を /ws として導出し（https なら wss、http なら ws）、API オリジンから appUrl を導出します。デプロイ環境が異なるオリジンを使用する場合は明示的に設定してください。

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

desktop.json は存在するが無効な場合、Desktop は安全側に倒して動作を停止し、Cloud に静かにフォールバックする代わりにブロック型の設定エラーを表示します。開発ビルドの場合、electron-vite dev 中は依然として VITE_API_URL / VITE_WS_URL / VITE_APP_URL が優先されます。ランタイムでの Desktop セルフホスト構成は issue #1371 で実装されました。

次のステップ

Cloud Quickstart — Desktop 向けの Cloud オンボーディングフロー
Self-Host Quickstart — 自前のバックエンドを実行し、CLI または Desktop のランタイム設定で接続する
デーモンとランタイム — デーモンの仕組み（Desktop が代わりに起動してくれますが、動作は同じです）