Agent SDK

Agent SDK lets you define, test, evaluate, and deploy agents as code. It uses the Cursor SDK harness that powers Bugbot, Security Review, Approval Bot, and Rollouts.

An Agent's behavior is defined in a folder of Markdown and TypeScript that combines deterministic code with model judgment. Agent SDK makes it easy to build useful agents, with APIs to interact on Slack, pull requests, issue trackers, Cursor, and the other places where you get work done.

After you deploy an agent, open Deployed Agents to manage it.

Get Started with your Coding Agent

Paste this prompt into your coding agent. It installs the CLI, asks what your agent is for, and scaffolds a first project from the Markdown version of these docs.

Set up my first Agent SDK project.Read https://cursor.com/docs/agent-sdk.md first. Every page underhttps://cursor.com/docs/agent-sdk/ is also available as Markdown when youadd .md to its URL.1. Check that Node is 22.13 or newer, then run:   npm install --global @grok/agent-sdk2. Read the docs index that ships with the package:   "$(npm root -g)/@grok/agent-sdk/dist/docs/llms.txt"3. Run agent-sdk login, and wait while I finish the browser sign-in.4. Ask me what the agent should do and where people will reach it. Then   follow the bdk-create-agent skill at   "$(npm root -g)/@grok/agent-sdk/skills/create-agent/SKILL.md"   to scaffold the project with agent-sdk init.5. Run agent-sdk validate --dir . and one agent-sdk run turn, then show me   the reply.

Why Agent SDK

Your instructions, tools, and evals are files you review, test, and version like the rest of your code. You write the instructions and tools, and Cursor runs the model loop that calls them.

When to use Agent SDK

	Cursor Automations	Grok Bot	Agent SDK
You define	A prompt, model, and trigger in the dashboard	Instructions, skills, and connected tools in the app	A versioned Markdown and TypeScript project
Where it runs	Cursor-managed	Cursor-managed	Cursor-managed hosting or your infrastructure
Choose it when	The job fits a schedule or event trigger	You want to configure and talk to an agent without writing code	You want code around model judgment that your team can version control, review, test and hillclimb

Get started

Install @grok/agent-sdk, then scaffold and run a project. The package was @cursor/bdk before.

npm install --global @grok/agent-sdkagent-sdk init ./my-botcd my-botagent-sdk dev

Project layout explains every folder under bot/.

Next steps

Build your first PR reviewer agent step by step.
Start from a review or triage template or the owners-policy approver.
Convert a Cursor Automation into an Agent SDK project.
Build agents with agents using a coding agent.
Look up commands in the CLI reference and deployed-agent roles in Access.

Architecture

You bring the code and ideas

Agent as code

Prompts as .md or .ts

Deterministic code hooks

Cursor-managed or self-hosted

Source control + Issue tracker + Slack triggers
Model routing
Evals
MCP connections
Sessions · Model loopsSubagents · Tool calls
Secret management
Sandboxing
Deployment
Storage + Artifacts

Agent SDK

Agent SDK lets you define, test, evaluate, and deploy agents as code. It uses the Cursor SDK harness that powers Bugbot, Security Review, Approval Bot, and Rollouts.

After you deploy an agent, open Deployed Agents to manage it.

Get Started with your Coding Agent

Paste this prompt into your coding agent. It installs the CLI, asks what your agent is for, and scaffolds a first project from the Markdown version of these docs.

Set up my first Agent SDK project.Read https://cursor.com/docs/agent-sdk.md first. Every page underhttps://cursor.com/docs/agent-sdk/ is also available as Markdown when youadd .md to its URL.1. Check that Node is 22.13 or newer, then run:   npm install --global @grok/agent-sdk2. Read the docs index that ships with the package:   "$(npm root -g)/@grok/agent-sdk/dist/docs/llms.txt"3. Run agent-sdk login, and wait while I finish the browser sign-in.4. Ask me what the agent should do and where people will reach it. Then   follow the bdk-create-agent skill at   "$(npm root -g)/@grok/agent-sdk/skills/create-agent/SKILL.md"   to scaffold the project with agent-sdk init.5. Run agent-sdk validate --dir . and one agent-sdk run turn, then show me   the reply.

When to use Agent SDK

	Cursor Automations	Grok Bot	Agent SDK
You define	A prompt, model, and trigger in the dashboard	Instructions, skills, and connected tools in the app	A versioned Markdown and TypeScript project
Where it runs	Cursor-managed	Cursor-managed	Cursor-managed hosting or your infrastructure
Choose it when	The job fits a schedule or event trigger	You want to configure and talk to an agent without writing code	You want code around model judgment that your team can version control, review, test and hillclimb

Agent SDK

Agent SDK lets you define, test, evaluate, and deploy agents as code. It uses the Cursor SDK harness that powers Bugbot, Security Review, Approval Bot, and Rollouts.

After you deploy an agent, open Deployed Agents to manage it.

Get Started with your Coding Agent

Paste this prompt into your coding agent. It installs the CLI, asks what your agent is for, and scaffolds a first project from the Markdown version of these docs.

Set up my first Agent SDK project.Read https://cursor.com/docs/agent-sdk.md first. Every page underhttps://cursor.com/docs/agent-sdk/ is also available as Markdown when youadd .md to its URL.1. Check that Node is 22.13 or newer, then run:   npm install --global @grok/agent-sdk2. Read the docs index that ships with the package:   "$(npm root -g)/@grok/agent-sdk/dist/docs/llms.txt"3. Run agent-sdk login, and wait while I finish the browser sign-in.4. Ask me what the agent should do and where people will reach it. Then   follow the bdk-create-agent skill at   "$(npm root -g)/@grok/agent-sdk/skills/create-agent/SKILL.md"   to scaffold the project with agent-sdk init.5. Run agent-sdk validate --dir . and one agent-sdk run turn, then show me   the reply.

Why Agent SDK

Your instructions, tools, and evals are files you review, test, and version like the rest of your code. You write the instructions and tools, and Cursor runs the model loop that calls them.

When to use Agent SDK

	Cursor Automations	Grok Bot	Agent SDK
You define	A prompt, model, and trigger in the dashboard	Instructions, skills, and connected tools in the app	A versioned Markdown and TypeScript project
Where it runs	Cursor-managed	Cursor-managed	Cursor-managed hosting or your infrastructure
Choose it when	The job fits a schedule or event trigger	You want to configure and talk to an agent without writing code	You want code around model judgment that your team can version control, review, test and hillclimb

Get started

Install @grok/agent-sdk, then scaffold and run a project. The package was @cursor/bdk before.

npm install --global @grok/agent-sdkagent-sdk init ./my-botcd my-botagent-sdk dev

Project layout explains every folder under bot/.

Next steps

Build your first PR reviewer agent step by step.
Start from a review or triage template or the owners-policy approver.
Convert a Cursor Automation into an Agent SDK project.
Build agents with agents using a coding agent.
Look up commands in the CLI reference and deployed-agent roles in Access.

Architecture

You bring the code and ideas

Agent as code

Prompts as .md or .ts

Deterministic code hooks

Cursor-managed or self-hosted

Source control + Issue tracker + Slack triggers
Model routing
Evals
MCP connections
Sessions · Model loopsSubagents · Tool calls
Secret management
Sandboxing
Deployment
Storage + Artifacts

Command Palette

Get Started

Agent

Grok Bot

Customize

Cloud Agents

Origin

Integrations

SDK

Agent SDK

CLI

Teams & Enterprise

Agent SDK

Command Palette

Get Started

Agent

Grok Bot

Customize

Cloud Agents

Origin

Integrations

SDK

Agent SDK

CLI

Teams & Enterprise

Agent SDK

Command Palette

Get Started

Agent

Grok Bot

Customize

Cloud Agents

Origin

Integrations

SDK

Agent SDK

CLI

Teams & Enterprise

Agent SDK