diff --git a/.cursor/environment.json b/.cursor/environment.json
new file mode 100644
index 000000000..fbb1bb4ae
--- /dev/null
+++ b/.cursor/environment.json
@@ -0,0 +1,11 @@
+{
+  "name": "ComfyUI Docs",
+  "install": "bash .cursor/install.sh",
+  "terminals": [
+    {
+      "name": "mint-dev",
+      "command": "npm run dev"
+    }
+  ],
+  "ports": [{ "name": "docs dev server", "port": 3000 }]
+}
diff --git a/.cursor/install.sh b/.cursor/install.sh
new file mode 100755
index 000000000..d5a92a65d
--- /dev/null
+++ b/.cursor/install.sh
@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Cloud Agent install for the ComfyUI docs repo.
+# Idempotent: safe to run repeatedly against cached or partial state.
+
+cd "$(dirname "$0")/.."
+
+# Node dependencies for the Mintlify docs site (mint, sharp).
+npm ci
+
+# Bun toolchain for the i18n / CMS / analytics pipelines (translate, cms:*, analytics:*).
+# Skip the download when bun is already available.
+if ! command -v bun >/dev/null 2>&1; then
+  export BUN_INSTALL="$HOME/.bun"
+  curl -fsSL https://bun.sh/install | bash
+  # Expose bun on the default PATH for login and non-login shells.
+  sudo ln -sf "$HOME/.bun/bin/bun" /usr/local/bin/bun
+fi
+
+bun --version