diff --git a/.cursor/environment.json b/.cursor/environment.json
new file mode 100644
index 000000000..03ec01385
--- /dev/null
+++ b/.cursor/environment.json
@@ -0,0 +1,4 @@
+{
+  "name": "CrewAI",
+  "install": "bash .cursor/install.sh"
+}
diff --git a/.cursor/install.sh b/.cursor/install.sh
new file mode 100755
index 000000000..d04a9c402
--- /dev/null
+++ b/.cursor/install.sh
@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+# Idempotent Cloud Agent bootstrap for the CrewAI uv workspace.
+set -euo pipefail
+
+# Install uv (the project's package manager) if it is not already available.
+if ! command -v uv >/dev/null 2>&1; then
+  curl -LsSf https://astral.sh/uv/install.sh | sh
+fi
+
+# Make uv available on PATH for the rest of this script.
+if [ -f "$HOME/.local/bin/env" ]; then
+  # shellcheck disable=SC1091
+  . "$HOME/.local/bin/env"
+fi
+
+# Sync the whole workspace: every package, the dev dependency group, and all
+# extras. This matches the documented contributor setup and is a no-op when the
+# environment is already up to date.
+uv sync --all-groups --all-extras