feat(sdk): add test-generator cookbook example

Add a new SDK example that generates tests, runs framework-native test commands, and iterates on failures so users can see a practical agent + deterministic verification loop in both CLI and TUI flows.

Made-with: Cursor

Author: Deepak-png981

README.md

@@ -24,4 +24,8 @@ A kanban board for viewing Cursor Cloud Agents, grouping them by status or repos
 
 A minimal command-line interface that lets you spawn Cursor agents from your terminal.
 
+### [Test generator](sdk/test-generator)
+
+A CLI that points a Cursor agent at your source files, generates unit tests, runs them, and iterates until they pass. Supports TypeScript/JavaScript (Vitest or Jest) and Python (Pytest), with an interactive Ink TUI.
+
 Learn more in the [Cursor SDK TypeScript docs](https://cursor.com/docs/api/sdk/typescript).

sdk/test-generator/.gitignore

@@ -0,0 +1,6 @@
+dist
+node_modules
+examples/**/*.test.ts
+examples/tests/test_*.py
+tests/test_*.py
+.env

sdk/test-generator/README.md

@@ -0,0 +1,67 @@
+# Cursor SDK Test Generator
+
+A local Cursor SDK example that points an agent at source files, generates unit tests, runs them, and feeds failures back into the agent until the tests pass or the iteration limit is reached.
+
+This example demonstrates:
+
+- TypeScript/JavaScript test generation for Vitest or Jest projects,
+- Python test generation for Pytest projects,
+- deterministic test execution outside the agent loop,
+- an Ink TUI with file selection, live progress, model selection, cancellation, and diff review.
+
+## Getting Started
+
+Use Node.js 22 or newer.
+
+Install dependencies:
+
+```bash
+pnpm install
+```
+
+Set a Cursor API key:
+
+```bash
+export CURSOR_API_KEY="crsr_..."
+```
+
+Generate tests for a TypeScript file and auto-accept the result:
+
+```bash
+pnpm dev -- examples/sample.ts --yes
+```
+
+Generate tests for a Python file:
+
+```bash
+pnpm dev -- examples/sample.py --lang python --yes
+```
+
+Start the interactive TUI by omitting files:
+
+```bash
+pnpm dev
+```
+
+## CLI Options
+
+```bash
+test-gen [files...|globs...] [options]
+
+  -C, --cwd <path>          Workspace root. Defaults to cwd.
+      --lang <ts|js|python> Override language detection.
+      --framework <name>    Override framework detection: vitest, jest, pytest.
+      --max-iters <n>       Test repair iterations. Defaults to 3.
+      --allow-source-edits  Let the agent fix source bugs during repair.
+      --overwrite           Overwrite existing test files.
+  -y, --yes                 Auto-accept generated test files.
+  -m, --model <id>          Model id. Defaults to CURSOR_MODEL or composer-2.
+```
+
+## Notes
+
+The agent writes or repairs tests, but this app runs the tests itself with the detected framework. That keeps the pass/fail signal deterministic and makes it easy to stream test output into the TUI.
+
+If your package manager ignores native dependency build scripts and the SDK reports a missing `sqlite3` binding, approve or rebuild the native dependency before running the agent loop.
+
+Cloud execution, coverage-guided test generation, mutation testing, and languages beyond TypeScript/JavaScript/Python are intentionally out of scope for this example.

sdk/test-generator/examples/sample.py

@@ -0,0 +1,12 @@
+def apply_discount(price: float, percent: float) -> float:
+    if price < 0:
+        raise ValueError("price must be non-negative")
+
+    if percent < 0 or percent > 100:
+        raise ValueError("percent must be between 0 and 100")
+
+    return round(price * (1 - percent / 100), 2)
+
+
+def format_invoice_id(invoice_id: int) -> str:
+    return f"INV-{invoice_id:06d}"

sdk/test-generator/examples/sample.ts

@@ -0,0 +1,15 @@
+export function applyDiscount(price: number, percent: number) {
+  if (price < 0) {
+    throw new Error("price must be non-negative")
+  }
+
+  if (percent < 0 || percent > 100) {
+    throw new Error("percent must be between 0 and 100")
+  }
+
+  return Math.round(price * (1 - percent / 100) * 100) / 100
+}
+
+export function formatInvoiceId(id: number) {
+  return `INV-${String(id).padStart(6, "0")}`
+}

sdk/test-generator/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "test-generator",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@10.9.0",
+  "engines": {
+    "node": ">=22"
+  },
+  "bin": {
+    "test-gen": "./dist/index.js"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc -p tsconfig.json",
+    "start": "node dist/index.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@cursor/sdk": "^1.0.7",
+    "fast-glob": "^3.3.3",
+    "ink": "^7.0.1",
+    "ink-select-input": "^6.2.0",
+    "ink-text-input": "^6.0.0",
+    "react": "^19.2.5"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "@types/react": "^19.2.14",
+    "tsx": "^4.21.0",
+    "typescript": "^6.0.3",
+    "vitest": "^4.0.15"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild",
+      "sqlite3"
+    ]
+  }
+}