‏Cursor SDK: ساخت ایجنت‌های برنامه‌نویسی با تایپ‌اسکریپت

Cursor یه SDK جدید منتشر کرده که می‌خواد کار ساختن ایجنت‌های کدنویسی رو به‌شدت ساده‌تر کنه. ایده اصلی اینه که همون موتور، هارنس و مدل‌هایی که پشت Cursor دسکتاپ، CLI و وب‌اپ هستن، حالا از طریق چند خط TypeScript در دسترس توسعه‌دهنده‌هاست. دیگه نیازی نیست از صفر یه استک ایجنت بسازی؛ Cursor این کار رو برات کرده.

نصب به همین سادگیه: npm install @cursor/sdk. بعدش می‌تونی یه ایجنت بسازی، یه پرامپت بفرستی و خروجی رو استریم کنی:

import { Agent } from "@cursor/sdk";

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "composer-2" },
  local: { cwd: process.cwd() },
});

const run = await agent.send("Summarize what this repository does");
for await (const event of run.stream()) {
  console.log(event);
}

یکی از مهم‌ترین ویژگی‌های SDK اینه که می‌تونی ایجنت‌ها رو روی زیرساخت ابری Cursor اجرا کنی. هر ایجنت ابری یه VM اختصاصی داره، یه کلون از ریپو، و یه محیط توسعه کاملاً آماده. ایجنت حتی اگه لپ‌تاپت خاموش بشه یا اینترنتت قطع بشه، به کارش ادامه می‌ده. بعد از اتمام هم می‌تونه PR باز کنه یا برنچ پوش بده:

const agent = await Agent.create({
  apiKey: process.env.CURSOR_API_KEY!,
  model: { id: "gpt-5.5" },
  cloud: {
    repos: [{ url: "https://github.com/cursor/cookbook", startingRef: "main" }],
    autoCreatePR: true,
  },
});

const run = await agent.send("Fix the auth token expiry bug");
const result = await (
  await Agent.getRun(run.id, { runtime: "cloud", agentId: run.agentId })
).wait();
console.log(result.git?.branches[0]?.prUrl);

ایجنت‌هایی که از طریق SDK راه‌اندازی می‌شن از همه امکانات هارنس Cursor بهره‌مند می‌شن: ایندکس‌گذاری کدبیس، جستجوی معنایی، پشتیبانی از MCP Servers، سیستم Skills از پوشه .cursor/skills/، هوک‌ها برای کنترل حلقه ایجنت، و حتی ساب‌ایجنت‌هایی که می‌تونن زیرتسک‌ها رو دلیگیت کنن.

یکی از نکات جالب دسترسی به همه مدل‌های Cursor از جمله Composer 2 هست. Composer 2 یه مدل تخصصی کدنویسیه که ادعا می‌شه عملکرد frontier-level داره ولی با هزینه‌ای به‌مراتب کمتر از مدل‌های general-purpose.

تیم‌های مختلف الان دارن از Cursor SDK برای کارهای جالبی استفاده می‌کنن: برخی ایجنت‌هایی ساختن که مستقیم از CI/CD فراخونده می‌شن تا تغییرات رو خلاصه کنن، دلایل شکست CI رو پیدا کنن و PR رو با فیکس آپدیت کنن. بعضی تیم‌ها پلتفرم‌های داخلی ساختن که بهشون اجازه می‌ده بدون نوشتن کد با داده‌های محصول کار کنن. حتی بعضی شرکت‌ها Cursor رو مستقیم توی محصولات مشتری‌محورشون جاسازی کردن.

Cursor چند پروژه نمونه هم در یه ریپوی عمومی آماده کرده: یه Quickstart ساده برای شروع، یه پروتوتایپینگ تول برای اسکفولد پروژه‌های جدید، یه کانبان بورد که ایجنت‌ها کارت‌ها رو برمی‌دارن و PR باز می‌کنن، و یه CLI سبک برای اجرای ایجنت از ترمینال.

SDK هم‌اکنون برای همه کاربران در دسترسه و بر اساس مصرف توکن قیمت‌گذاری می‌شه. Cursor قراره پشتیبانی از زبان‌های بیشتر و deployment patternهای متنوع‌تر رو هم اضافه کنه.

نکات کلیدی:

• Cursor SDK در بتای عمومی در دسترسه و با npm install @cursor/sdk نصب می‌شه
• ایجنت‌ها هم به‌صورت local و هم روی زیرساخت ابری Cursor قابل اجرا هستن
• هر ایجنت ابری یه VM اختصاصی داره و می‌تونه بدون نیاز به حضور کاربر کارش رو کامل کنه
• دسترسی به تمام مدل‌های Cursor از جمله Composer 2 با هزینه کمتر
• پشتیبانی از MCP، Skills، Hooks و Subagents
• قیمت‌گذاری بر اساس مصرف توکن