cookbook README

The project's README from github.com/cursor/cookbook. As one markdown file: README.md.

Cursor Cookbook

This repo contains small examples for building with Cursor.

Cursor Hooks

Cursor Hooks let you run custom checks and workflows around agent events such as prompt submission, shell commands, file edits, and agent completion.

Hooks examples

A guided project hook setup for audit logging, sensitive prompt guards, and follow-up checks that keep Cursor skills aligned with code changes.

Cloud Agents

Self-hosted Cloud Agents lab

Run Cursor Cloud Agent workers on customer-managed AWS infrastructure with examples for EC2 + Docker and ECS/Fargate.

Cursor SDK

The Cursor SDK is the TypeScript API for running Cursor's coding agent from your own apps, scripts, and workflows. It supports the same agent across local workspaces and cloud runtimes, streams agent events as runs progress, and lets you manage prompts, models, cancellation, artifacts, and conversation state from code.

To run the SDK examples, create a Cursor API key from the Cursor integrations dashboard, then set it as CURSOR_API_KEY.

Quickstart

A minimal Node.js example that creates a local agent, sends one prompt, and streams the response.

Prototyping tool

A web app for spinning up agents to scaffold new projects and iterate on ideas in a sandboxed cloud environment.

Kanban board

A kanban board for viewing Cursor Cloud Agents, grouping them by status or repository, previewing artifacts, and creating new cloud agents from a repository and prompt.

Coding agent CLI

A minimal command-line interface that lets you spawn Cursor agents from your terminal.

DAG task runner

Decompose a task into a JSON DAG, fan it out across local subagents, and stream live status into a Cursor Canvas that hot-reloads on every state change. Ships as both a runnable example and a copyable Cursor skill at .cursor/skills/dag-task-runner.

Perl bridge adapter

A miniature Cursor SDK in Perl on the open sdk.v1 bridge. Shows how to spawn cursor-sdk-bridge, speak Connect JSON, and run one local agent turn without a first-party SDK.

Learn more in the Cursor SDK TypeScript docs and the SDK Bridge docs.

xAI API

Grok Coding Agent CLI

An educational Python coding-agent loop that uses an xAI Console API key, defaults to grok-4.6, and provides workspace-scoped file and shell tools.

Grok Voice Patient Intake

A LiveKit voice agent that uses xAI's native realtime speech-to-speech model for a fictional family-medicine intake and appointment workflow.

cookbook (cursor/cookbook)

Searching Database…

Что это?Коллекция небольших самостоятельных примеров для разработки поверх агентной платформы Cursor, охватывающая Cursor Hooks, self-hosted Cloud Agents, Cursor SDK, CLI агента для кодинга и даже сторонние интеграции с Grok от xAI.
Это одно приложение или множество отдельных примеров?Это сборник рецептов: каждая папка — независимый самодостаточный пример (CLI, веб-приложение, скрипт SDK или конфиг хука), а не единое приложение.
Как запустить примеры Cursor SDK?Создайте API-ключ Cursor в дашборде интеграций Cursor, задайте его как CURSORAPIKEY, затем запустите пример вроде Node.js quickstart, который создаёт локального агента, отправляет промпт и стримит ответ.
Нужен ли API-ключ xAI для примеров с Grok?Да, Grok Coding Agent CLI использует API-ключ из xAI Console и по умолчанию модель grok-4.6; пример приёма голоса также опирается на realtime-модель речи xAI плюс LiveKit.
Есть ли одна настройка на весь репозиторий?Нет, единого шага установки нет: у каждого примера (hooks, SDK, CLI, Perl bridge, облачные агенты) свой рантайм и учётные данные, поэтому настраивается только та часть, которую хотите попробовать.
Для кого этот сборник?Для разработчиков, которые хотят расширить или встроить агента для кодинга Cursor в свои приложения, CLI, облачную инфраструктуру или стеки не на TypeScript.
Что показывают примеры Cursor Hooks?Они демонстрируют журналирование аудита, защиту чувствительных промптов и последующие проверки, которые выполняются вокруг событий агента вроде отправки промпта и правок файлов, поддерживая синхронизацию Cursor skills с изменениями кода.
Что делает пример DAG task runner?Он разбивает задачу на JSON DAG, распределяет её по локальным субагентам и транслирует живой статус в Cursor Canvas, который горячо перезагружается при каждом изменении состояния; поставляется также как копируемый Cursor skill.
Для чего нужен адаптер Perl bridge?Он показывает, как управлять одним локальным ходом агента Cursor из Perl, говоря по открытому JSON-протоколу sdk.v1 Connect через cursor-sdk-bridge, без необходимости в официальном Perl SDK.
Зачем в сборнике по Cursor пример с xAI Grok?Он объединяет минимальный CLI агента для кодинга grok-4.6 с голосовым агентом LiveKit на realtime-модели речь-в-речь от xAI для вымышленного сценария приёма пациентов, показывая, как те же агентные паттерны распространяются на других провайдеров моделей.
Creator
cursor
Size
3.3 MB
Stars
4.1K
Updated
CommitSep 02
Age
5mo
Commits · 90 Days