The VS Code of video editing, built for agents.
TypeScript
docs: add warning about avoiding cloud-synced locations for project folders
konstantin-paulus47d38fb60259
diff --git a/docs/reference/tools/open.md b/docs/reference/tools/open.mdindex 5e3e07ad..bf875df2 100644--- a/docs/reference/tools/open.md+++ b/docs/reference/tools/open.md@@ -26,6 +26,8 @@ Nothing else is written — no tsconfig, README, or .gitignore. Those come withThe app remembers the folder, so the project reopens across app relaunches and stays addressable by folder name or project id.+Keep the folder out of cloud-synced locations: iCloud Drive (including a synced Desktop or Documents), Dropbox, OneDrive, and Google Drive. Sync clients evict media to placeholders, upload half-written renders, and leave conflict copies. Open a local folder outside the synced tree instead.+## From a shell`diffusion open` is also how the app starts: it launches Diffusion Studio (macOS and Windows) or surfaces the running instance, then, given a path, calls the tool. With no path it only makes sure the app is up, printing nothing and exiting `0` once the app answers. Relative paths resolve against the shell's working directory. `--background` launches or keeps the app without raising a window — the way to drive the editor headless.