feat: add dotenv support and environment validation

sdk/quickstart/.env.example

@@ -0,0 +1,2 @@
+# Copy this file to .env and fill in your key
+CURSOR_API_KEY = your_api_key_here

sdk/quickstart/package.json

@@ -14,11 +14,13 @@
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
   "devDependencies": {
+    "@types/dotenv": "^6.1.1",
     "@types/node": "^25.6.0",
     "tsx": "^4.21.0",
     "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@cursor/sdk": "^1.0.7"
+    "@cursor/sdk": "^1.0.7",
+    "dotenv": "^17.4.2"
   }
 }

sdk/quickstart/src/index.ts

@@ -1,23 +1,32 @@
-import { Agent } from "@cursor/sdk"
+import { Agent } from "@cursor/sdk";
+import * as dotenv from "dotenv";
 
-const agent = await Agent.create({
-  apiKey: process.env.CURSOR_API_KEY,
-  name: "SDK quickstart",
-  model: { id: process.env.CURSOR_MODEL ?? "composer-2" },
-  local: { cwd: process.cwd() },
-})
+// Load variables from .env into process.env
+dotenv.config();
 
-const prompt = "Explain this project in one paragraph."
-const run = await agent.send(prompt)
+async function main() {
+  const apiKey = process.env.CURSOR_API_KEY;
 
-for await (const event of run.stream()) {
-  if (event.type !== "assistant") continue
+  if (!apiKey) {
+    console.error("Error: CURSOR_API_KEY is not set in environment variables.");
+    console.log("Please copy .env.example to .env and fill in your API key.");
+    process.exit(1);
+  }
+
+  const agent = await Agent.create({
+    apiKey,
+    name: "SDK quickstart",
+    model: { id: process.env.CURSOR_MODEL ?? "composer-2" },
+    local: { cwd: process.cwd() },
+  });
 
-  for (const block of event.message.content) {
-    if (block.type === "text") {
-      process.stdout.write(block.text)
-    }
+  const run = await agent.send("Summarize what this repository does");
+
+  for await (const event of run.stream()) {
+    console.log(event);
   }
+
+  await run.wait();
 }
 
-await run.wait()
+main().catch(console.error);