使い始め方と、よくある質問への回答。

macOS ワークスペース（macOS 13 以降）：共有フォルダは自動的にマウントされます——Finder を開いて /Volumes/My Shared Filesの下を確認してください。コマンドは不要です。

Linux ワークスペース：各共有フォルダには専用のマウントコマンドがあり、アプリ内のワークスペースの「共有ファイル」タブに直接表示されます。そのフォルダ自身のタグを使って、次のような形になります：

mkdir -p /mnt/my_folder
sudo mount -t virtiofs <folder-tag-shown-in-app> /mnt/my_folder

アプリに表示されている通りのタグを使ってください——フォルダごとに固有なので、他から持ってきたコマンドをコピーしても動作しません。

Linux でのクリップボード共有は、ゲスト内で動作するエージェントに依存します。次の手順を順番に確認してください：

1. ワークスペースの「リソース」タブで、 クリップボード共有 がオンになっていることを確認します。
2. ゲスト内で、 spice-vdagent がインストールされていることを確認します：

   sudo apt install spice-vdagent

3. エージェントが実際に動作しているか確認します：

   systemctl status spice-vdagentd

   非アクティブな場合は、 sudo systemctl start spice-vdagentdで起動し、グラフィカルデスクトップを使用している場合はログアウトして再度ログインし、デスクトップセッションに反映させてください。
4. 一部の最小構成またはヘッドレスなデスクトップ環境では、 spice-vdagent が自動的に起動しません——エージェントがインストールされ動作しているのにまだうまくいかない場合は、デスクトップ環境の自動起動設定を確認してください。

クリップボード共有は現在 Linux ワークスペースでのみ動作します。

Debian は Ubuntu と同じ apt と update-binfmts ツールを使用します。ワークスペースの「リソース」タブで Rosetta をオンにし、ワークスペースを起動してから、ゲスト内で一度だけ次を実行してください：

sudo mkdir -p /media/rosetta
sudo mount -t virtiofs rosetta /media/rosetta

sudo apt-get update
sudo apt-get install -y binfmt-support

sudo /usr/sbin/update-binfmts --install rosetta /media/rosetta/rosetta \
  --magic "\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x3e\x00" \
  --mask "\xff\xff\xff\xff\xff\xfe\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff" \
  --credentials yes --preserve yes --fix-binary yes

Fedora には Debian の update-binfmts ツールは含まれていませんが、 systemd-binfmtは含まれており、設定ファイルから、まったく同じカーネルの binfmt_misc 登録を読み込みます。ワークスペースの「リソース」タブで Rosetta をオンにし、ワークスペースを起動してから、ゲスト内で一度だけ次を実行してください：

sudo mkdir -p /media/rosetta
sudo mount -t virtiofs rosetta /media/rosetta

sudo mkdir -p /etc/binfmt.d
sudo tee /etc/binfmt.d/rosetta.conf > /dev/null <<'EOF'
:rosetta:M::\x7fELF\x02\x01\x01\x00\x00\x00\x00\x00\x00\x00\x00\x00\x02\x00\x3e\x00:\xff\xff\xff\xff\xff\xfe\xfe\x00\xff\xff\xff\xff\xff\xff\xff\xff\xfe\xff\xff\xff:/media/rosetta/rosetta:CF
EOF

sudo systemctl restart systemd-binfmt

rosetta.conf ファイルは再起動後も保持されるため、この設定はワークスペースごとに一度だけ行えば済みます。

1. ワークスペースの外、あなたの Mac 上で Ollama をインストールして実行します。
2. ワークスペースで AI ブリッジを有効にします（AI サンドボックスプロファイルではデフォルトでオン、または自分でワークスペースの「統合」または「リソース」設定でオンにします）。
3. ワークスペースを起動し、その AI ブリッジタブを開きます——ローカルエンドポイントのアドレスと、Linux ゲストの場合は接続を転送するための正確なコマンドが表示されます。
4. ワークスペース内で、標準的な chat-completions API 形式を話すローカルサーバーに接続するのと同じように、ツールをそのアドレスに向けてください。

閉じた瞬間に、ディスクごと自動的に削除されます。その後復元する方法はありません——保持しておく必要のあるものには使い捨てワークスペースを使わないでください。

ワークスペースを停止し、停止したワークスペースに表示されるバナーから ベースイメージとして保存 を選択します。同じワークスペースを後で再度保存すると、以前のものを上書きするのではなく、新しい独立したベースイメージが作成されます——不要になったベースイメージは環境設定 → ベースイメージから管理・削除できます。

ワークスペースのディスクとベースイメージは、Mac 上の ~/Library/Application Support/VeloWorkspaces に保存されています。空き容量を確保するには、ライブラリから不要なワークスペースを削除し、環境設定 → ベースイメージから未使用のベースイメージを削除してください。

このリリースでは未対応です。Velo Workspaces は現在 Linux と macOS ゲストに対応しています。

CPU、メモリ、ストレージ、共有フォルダ、その他いくつかの設定は仮想マシンの構成の一部であり、実行中は変更できません（Apple の Virtualization フレームワークはこれらのホットプラグに対応していません）。ワークスペースを停止し、変更を行ってから、再度起動してください。

macOS ゲストにはホストとして Apple シリコン搭載 Mac が必要です。Intel Mac では、Linux ゲストは引き続き完全にサポートされています。