From a3f4adc5daa6976dae35ebb05eb7d9ff3a6fef97 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Fri, 31 Jul 2026 08:11:21 +0000
Subject: [PATCH] docs: document macOS sandbox clipboard sharing
---
smolvm/cli/create.mdx | 4 ++++
smolvm/guides/macos-sandboxes.mdx | 28 ++++++++--------------------
2 files changed, 12 insertions(+), 20 deletions(-)
diff --git a/smolvm/cli/create.mdx b/smolvm/cli/create.mdx
index 75e3e2c..18659e2 100644
--- a/smolvm/cli/create.mdx
+++ b/smolvm/cli/create.mdx
@@ -53,6 +53,10 @@ smolvm sandbox create [OPTIONS]
Allow writes to every shared folder from this command.
+
+ Share the clipboard between your Mac and a macOS sandbox desktop. On by default for macOS guests. Use `--no-clipboard` to keep the two clipboards separate. The choice is saved with the sandbox and applies across stop and start. See [Copy and paste between your Mac and the sandbox](/smolvm/guides/macos-sandboxes#copy-and-paste-between-your-mac-and-the-sandbox).
+
+
Approve the one-time macOS image download and preparation without an interactive prompt.
diff --git a/smolvm/guides/macos-sandboxes.mdx b/smolvm/guides/macos-sandboxes.mdx
index d507067..6c5a2c0 100644
--- a/smolvm/guides/macos-sandboxes.mdx
+++ b/smolvm/guides/macos-sandboxes.mdx
@@ -124,32 +124,20 @@ After the one-time setup, you only need two commands: create the sandbox, then o
-## Copy text from your Mac
+## Copy and paste between your Mac and the sandbox
-Until clipboard sharing is available, use a temporary browser note to move text from your Mac into the sandbox.
+Copy and paste works in both directions between your Mac and a macOS sandbox out of the box. Copy on one side, paste on the other — no extra setup.
-
-
- Add a unique, hard-to-guess phrase to `https://notepad.pw/`. For example, a phrase such as `maple-comet-7429` produces this address:
-
- ```text
- https://notepad.pw/maple-comet-7429
- ```
-
- Use your own random phrase instead of the example above.
-
+If you would rather keep the two clipboards separate, turn clipboard sync off when you create the sandbox:
-
- Open your note address in a browser on your Mac, then paste the text you want to transfer.
-
+```bash
+smolvm sandbox create --os macos --name private-mac --no-clipboard
+```
-
- Open Safari in the macOS sandbox and visit the same note address. Copy the text into an app inside the sandbox, then clear the note when you finish.
-
-
+The choice is saved with the sandbox, so stopping and starting it later keeps the same setting.
- Anyone who knows the note address may be able to read its contents. Use this workaround only for non-sensitive text. Keep passwords, API keys, personal information, and other secrets out of the note.
+ With clipboard sync on, text you copy on your Mac is readable from inside the running sandbox, including passwords, API keys, and other secrets. Use `--no-clipboard` for sandboxes where you do not want the guest to see host clipboard contents.
## Share a local folder