---
title: "Agent SDK"
description: "The Agent SDK is now generally available, letting developers define an agent as a folder of code using an instructions.md file as the prompt. The project structure includes tools/ for typed functions, skills/ for loadable procedures, mcp-connections/ for MCP server tools, and channels/ for message handling. The CLI provides commands for initialization, local development with a playground, validation, and deployment to Cursor or self-managed infrastructure. When deployed, secrets and integrations are managed from a dashboard while logs, evals, and the playground remain available, and agents can receive and respond to messages through GitHub, GitLab, Bitbucket, Slack, webhooks, and cron schedules with session persistence. Evals allow asserting on tool calls and replies, and the agent-sdk github replay command converts real pull requests into signed fixtures for offline testing."
---

# Agent SDK

[Cursor](https://yomu.fyi/company/cursor) · Oct 20, 2026

**Type:** Announcement

## Summary

The Agent SDK is now generally available, letting developers define an agent as a folder of code using an instructions.md file as the prompt. The project structure includes tools/ for typed functions, skills/ for loadable procedures, mcp-connections/ for MCP server tools, and channels/ for message handling. The CLI provides commands for initialization, local development with a playground, validation, and deployment to Cursor or self-managed infrastructure. When deployed, secrets and integrations are managed from a dashboard while logs, evals, and the playground remain available, and agents can receive and respond to messages through GitHub, GitLab, Bitbucket, Slack, webhooks, and cron schedules with session persistence. Evals allow asserting on tool calls and replies, and the agent-sdk github replay command converts real pull requests into signed fixtures for offline testing.

## Takeaways

- Agents are defined as code projects with a standard structure: instructions.md for the prompt, tools/ for callable functions, skills/ for on-demand procedures, and channels/ for message routing.
- The SDK supports deployment both to Cursor’s infrastructure and to self-managed environments, with a dashboard for managing secrets and integrations.
- Evals allow testing agents by sending fixed messages and asserting on tool calls and responses; the agent-sdk github replay command enables testing GitHub-driven bots using actual pull request payloads.

## FAQ

### How do I create and run a new agent locally?

Run npx @cursor/agent-sdk init ./my-bot to scaffold the project, then agent-sdk dev to start the bot locally with a playground. You can pass --template to start from a predefined agent like a security reviewer or PR autofixer.

### How can I test a GitHub-driven bot without pushing to a repository?

Use agent-sdk github replay <pr-url> with --dry-run and --fixtures-dir to save signed webhook payloads as eval fixtures. This allows testing the bot's reactions to real pull request events offline.

### What channels do agents support for receiving messages?

Agents support GitHub, GitLab, and Bitbucket events (pull requests, comments, CI), Slack mentions and DMs, webhooks from any provider, and cron schedules. GitHub events pull through your Cursor account without needing a public webhook URL.

**Tags:** [Agents](https://yomu.fyi/topic/agents), [Agent SDK](https://yomu.fyi/topic/agent-sdk), [Cursor](https://yomu.fyi/topic/cursor)

- Source: [Cursor](https://cursor.com/changelog/agent-sdk)
- Source URL: https://cursor.com/changelog/agent-sdk
- Ingested by Yomu: 2026-10-26T21:00:16.916Z

[Read original post](https://cursor.com/changelog/agent-sdk)
