デスクトップアプリ

Clowld Space Desktop は macOS、Windows、Linux で利用できます。Web 版と同じアカウントとワークスペースデータを使いますが、ローカルマシンのデーモンを自動で管理し、ワークスペースごとに独立したタブのセットを保持します。

Desktop と Web

ちょっと確認するだけのときや共用のパソコンでは、Web のほうが手軽です。

両方に同時にサインインできます。同じ Clowld Space サービスに接続している限り、表示されるデータは共有されます。

インストール

Clowld Space ダウンロードページから、OS と CPU アーキテクチャに合ったインストーラーを選びます:

インストール後、ブラウザで続行を選びます。ブラウザですでに同じサービスへサインイン済みならそのまま Desktop に戻り、未サインインなら Web でメールまたは Google を選択します。Desktop はデーモンを起動し、AI コーディングツールを検出して、公式 clowld を ~/.clowld-space/bin/ に配置します。

デスクトップタブ

Desktop はワークスペースごとにタブを保存します。たとえば、ワークスペース A でタスクを 3 つ開いてからワークスペース B に切り替えると、B 自身のタブが表示されます。A に戻ると、先ほどの 3 つのタブがそのまま残っています。

同じリソースは現在のワークスペースで一度しか開きません。タブは並べ替え、ピン留め、クローズができ、それぞれが進む・戻るの履歴とスクロール位置を保持します。このデプロイのアプリリンクをクリックまたは貼り付けると、ブラウザに移動せずタブ内で直接開きます。

サインアウトすると、このマシンに保存されたすべてのタブが消去されるため、次にサインインした人が前のアカウントの残したページを見ることはありません。

内蔵デーモン

サインイン後、Desktop は現在の Clowld Space サービス専用の CLI プロファイルを作成し、それを使ってデーモンを起動します。プロファイルの場所:

~/.clowld-space/cli/profiles/desktop-<host>/

同じサービスでは、ターミナルのデフォルトプロファイルは現在の Desktop アカウントに追従しますが、ターミナルと Desktop デーモンは別々の資格情報を使います。アカウント切り替え前には確認を表示し、サインアウト時には Desktop が作成したターミナル資格情報だけを削除します。別サービスのデフォルトプロファイルとすべての名前付きプロファイルは変更しません。

管理中は、デフォルトプロファイルの clowld daemon status/start/stop/restart が Desktop を確認または起動し、2 つ目の terminal daemon は作りません。clowld issue list などは Desktop が停止中でもバックエンド API を直接呼び出します。独立デーモンが必要な場合は clowld --profile self-host daemon start のように名前付きプロファイルを明示します。

ランタイムの状態とログは Desktop の設定で確認できます。ツールが検出されないときは、まず通常のターミナルで動作しサインイン済みであることを確認してから、Desktop のデーモンを再起動してください。

Desktop の更新

自動更新はデフォルトで有効です。アプリはバックグラウンドで新しいバージョンを確認してダウンロードします。ダウンロードが完了したら、すぐに再起動してインストールすることも、次回終了時にインストールさせることもできます。設定 → アップデート で自動確認をオフにしたり、手動で新しいバージョンを確認したりもできます。

Desktop が管理する公式ターミナル CLI も Desktop と一緒に更新されます。このモードの clowld update は Desktop の更新確認を呼び出します。

更新は OS と CPU アーキテクチャごとに配布されます:

• Windows arm64 と macOS x64（Intel）は、それぞれ専用の更新フィードを使います。
• その他のアーキテクチャはデフォルトの更新フィードを使います。
• アプリが更新フィードを自動で選択するため、手動で選ぶ必要はありません。
• Linux で自動更新が有効なのは .AppImage だけです。.deb と .rpm は新しいパッケージをダウンロードして上書きインストールします。
• 自動更新が失敗した場合も、同様にダウンロードページから対応するインストーラーを取得して上書きインストールしてください。

Desktop のアンインストール

Windows のアンインストーラーでは、Desktop が配置した CLI を独立 CLI として残すか、削除するかを選べます。削除は管理記録のパスとチェックサムが一致するときだけ行われ、どちらを選んでも名前付きプロファイル、設定、ワークスペースデータは削除しません。macOS と Linux では Desktop を削除すると既存 CLI は独立モードへ戻ります。

セルフホストインスタンスへの接続

Desktop はデフォルトで Clowld Space に接続します。セルフホストインスタンスに接続するには、ホームディレクトリの .clowld-space の中に desktop.json を作成します:

これらはデフォルトの場所です。ホームディレクトリを移動またはリダイレクトしている場合は、実際のパスを使ってください。

{
  "schemaVersion": 1,
  "apiUrl": "https://api.example.com"
}

apiUrl はバックエンドの公開アドレスです。必須で、http または https を使う必要があります。残りの 2 つのアドレスは省略でき、Desktop が自動で導出します:

• wsUrl: apiUrl のスキームを ws または wss に置き換え、パスの末尾に /ws を追加します。
• appUrl: ホスト名が api. で始まりラベルが 3 つ以上ある場合は api. プレフィックスを取り除きます（api.example.com → example.com）。それ以外は apiUrl と同じままです。

通常は apiUrl だけで十分です。導出結果がデプロイと合わない場合にのみ明示的に上書きします。よくあるのは次の 3 つのケースです:

• Web アプリと API が異なるドメインにある。
• WebSocket を別途デプロイしている。
• ホスト名がプレフィックス除去の規則に合わない（api.local のような 2 ラベルのホストはプレフィックスが残ります）。

{
  "schemaVersion": 1,
  "apiUrl": "https://api.example.com",
  "appUrl": "https://app.example.com",
  "wsUrl": "wss://ws.example.com/socket"
}

保存後に Desktop を再起動します。この設定は起動時に一度だけ読み込まれます。2 つの失敗の現れ方は異なるため、これが切り分けの手がかりになります:

• ファイルが見つからない（ディレクトリが違う、またはファイル名が desktop.json ではない）: Desktop はデフォルトの Cloud 設定を使い、エラーは表示しません。つまり Desktop が Cloud のアドレスを表示したままで設定エラーも出ない場合、ファイルは Desktop が探している場所にありません。
• ファイルは見つかったが無効（JSON、バージョン、URL のいずれかに問題がある）: Desktop は設定エラーを表示し、自動では Cloud にフォールバックしません。

そのファイルを削除して再起動すれば、デフォルトの Cloud 設定に戻ります。

Windows: ファイル名とエンコーディングを確認する

Windows では、エディタの 2 つのデフォルト動作が Desktop の読めないファイルを気づかないうちに作ってしまいます:

• メモ帳は .txt を付け足します。 desktop.json として保存したつもりでも実際には desktop.json.txt になることがあり、Desktop はファイルが見つからないものとして扱います。エクスプローラーでファイル名拡張子の表示を有効にするか、保存ダイアログですべてのファイルを選んでください。実際のファイル名を確認するには、PowerShell で Get-ChildItem "$env:USERPROFILE\.clowld-space" -Filter "desktop.json*" を実行します。Name 列がちょうど desktop.json になっている必要があります。
• PowerShell のリダイレクトは UTF-16 や BOM 付きで書き込みます。 > desktop.json や Out-File はパースできないエンコーディングを生成することがあり、設定エラーとして現れます。

どちらも避けるには、PowerShell で一度に作成します:

$dir = "$env:USERPROFILE\.clowld-space"
New-Item -ItemType Directory -Force $dir | Out-Null
$json = @'
{
  "schemaVersion": 1,
  "apiUrl": "https://api.example.com"
}
'@
[System.IO.File]::WriteAllText("$dir\desktop.json", $json)

Windows Defender が Clowld Space をウイルスとして検出する

症状: Windows セキュリティが Trojan:Script/Wacatac.B!ml のような脅威を報告し、Desktop のインストール先にあるファイルを隔離します。対象になるのは通常、アプリ本体の実行ファイルではなく同梱の CLI です。

C:\Users\<ユーザー名>\AppData\Local\Programs\Clowld Space\resources\app.asar.unpacked\resources\bin\clowld.exe

これは誤検知です。 !ml というサフィックスは、この判定がマルウェアのシグネチャ一致ではなく Defender の機械学習ヒューリスティックによるものであることを示します。Clowld Space の Windows ビルドはまだ Authenticode コード署名を行っておらず、公開されたばかりで署名がなく、バックグラウンドプロセスを起動してネットワーク接続を張るバイナリは、この種のヒューリスティックが最も疑わしいと判定するプロファイルそのものです。Windows 向けの成果物はすべて、このリポジトリの公開ソースから GitHub Actions でビルドされています。

自分で検証できます — 各 GitHub リリースには、すべての CLI アーカイブを網羅した checksums.txt が公開されています。

Get-FileHash .\clowld-cli-<version>-windows-amd64.zip -Algorithm SHA256

公開 Clowld CLI リリースマニフェストを開き、そこにある checksums.txt アセットの URL から該当ハッシュを照合してください。

対処方法:

1. 隔離されたファイルを復元する — Windows セキュリティ → ウイルスと脅威の防止 → 保護の履歴 → Clowld Space の項目を選択 → 操作 → 復元。

2. 除外を追加する（再び隔離されないように）— ウイルスと脅威の防止 → 設定の管理 → 除外 → 除外の追加または削除 → フォルダー で、次の両方を追加します。

   • %LOCALAPPDATA%\Programs\Clowld Space
   • %APPDATA%\Clowld Space

   両方が必要です。同梱の CLI が失われると Desktop は代替バイナリを %APPDATA%\Clowld Space\bin にダウンロードするため、インストール先だけを除外してもダウンロードした代替バイナリが再び隔離され、同じことの繰り返しになります。

3. 誤検知を Microsoft に報告する — Microsoft Security Intelligence のファイル送信ページで Software developer と Incorrectly detected as malware を選択します。すべてのユーザーに対して検出を取り下げてもらうにはこの手順が必要で、通常は数日で反映されます。

次のステップ

• クイックスタート — 初回接続の流れ。
• デーモンとランタイム — 内蔵デーモンの仕組み。
• トラブルシューティング — 接続問題の診断。

外観とショートカット

設定 → 環境設定でライト、ダーク、システム連動を選択します。半透明サイドバーはネイティブ材質をサポートする Desktop ウィンドウのみ表示され、Web と独立タスクウィンドウには適用されません。

設定 → キーボードショートカットで操作を検索し、新しいキーを入力するか既定に戻せます。変更はこの端末に保存されます。macOS は Cmd、他は Ctrl を使い、既定の Cmd/Ctrl+B は左側栏、Cmd/Ctrl+/ は現在の詳細ページの右側栏を切り替えます。入力欄で編集中はこの2つを実行しません。

Desktop の Cmd/Ctrl+1～8 は現在のワークスペースの対応位置のタブ、Cmd/Ctrl+9 は最後のタブを選択します。存在しない位置では何も起きません。