Estamos lançando o SDK do Cursor para que você possa desenvolver agentes com o mesmo tempo de execução, harness e modelos que alimentam o Cursor.

Os agentes que rodam no app para desktop, na CLI e no web app do Cursor agora podem ser acessados com algumas linhas de TypeScript. Execute-os na sua máquina ou na nuvem do Cursor em uma VM dedicada, com qualquer modelo de ponta.

Os agentes de programação estão evoluindo de ferramentas interativas para desenvolvedores individuais para infraestrutura programável para organizações. O SDK do Cursor permite implementar agentes sem a sobrecarga de desenvolver e manter toda a stack de agentes. Muitas equipes estão invocando agentes diretamente de pipelines de CI/CD, criando automações para fluxos de trabalho de ponta a ponta e incorporando agentes a seus produtos centrais.

O SDK do Cursor agora está disponível em beta pública para todos os usuários. Basta executar npm install @cursor/sdk para começar.

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);
}

#Implemente agentes em produção rapidamente

Desenvolver agentes de programação rápidos, confiáveis e capazes, que executem com segurança com seus dados, exige um esforço de engenharia significativo: sandboxing seguro, gerenciamento persistente de estado e sessão, configuração de ambiente e gerenciamento de contexto. E, quando um novo modelo é lançado, as equipes muitas vezes precisam refazer os loops de seus agentes para aproveitá-lo.

O SDK do Cursor elimina essa complexidade para que você possa se concentrar em desenvolver agentes úteis.

Use infraestrutura de nuvem pronta para produção

As sessões na nuvem iniciadas pelo SDK são executadas no mesmo tempo de execução otimizado que usamos para Agentes na nuvem. Cada agente recebe sua própria VM dedicada, com sandboxing robusto, um clone do repositório e um ambiente de desenvolvimento totalmente configurado.

Os agentes continuam executando quando seu laptop entra em suspensão ou a rede cai. Você pode acompanhar a conversa e se reconectar depois. Quando o agente termina, ele pode abrir uma PR, fazer push de uma branch ou anexar demonstrações e capturas de tela.

// Iniciar agente na nuvem para iniciar uma tarefa...:
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");
console.log(`Started ${run.id}`);

// ...verifique o andamento depois, de qualquer lugar:
const result = await (
  await Agent.getRun(run.id, { runtime: "cloud", agentId: run.agentId })
).wait();
console.log(result.git?.branches[0]?.prUrl);

O SDK usa nossa API de Agente na nuvem atualizada, que permite que execuções de agentes na nuvem apareçam na janela de agentes e no app web do Cursor. Você pode iniciar uma tarefa por código e depois ir para o Cursor para acompanhar o progresso ou assumir o trabalho.

Quando você precisar de um tempo de execução diferente, o mesmo SDK pode executar agentes em workers auto-hospedados, mantendo o código e a execução de ferramentas dentro da sua rede, ou localmente na sua máquina para iterar rapidamente.

Use todo o harness do Cursor

Agentes iniciados por meio do SDK se beneficiam do mesmo harness que impulsiona o Cursor em nosso app para desktop, CLI e app web:

• Gerenciamento inteligente de contexto: Indexação da base de código, busca semântica e grep instantâneo ajudam os agentes a chegar ao resultado certo com mais rapidez e eficiência.
• Servidores MCP: Os agentes podem se conectar a ferramentas externas e fontes de dados via stdio ou HTTP, seja por meio de um arquivo de configuração .cursor/mcp.json ou enviados inline na chamada.
• Habilidades: Os agentes carregam habilidades automaticamente do diretório .cursor/skills/ do seu repositório.
• Hooks: Observe, controle e estenda o loop do agente na nuvem, em ambientes auto-hospedados e locais, com um arquivo .cursor/hooks.json.
• Subagentes: Delegue subtarefas a subagentes nomeados com seus próprios prompts e modelos, que o agente principal cria por meio da ferramenta Agent.

Desenvolva com qualquer modelo

O SDK do Cursor dá a você acesso a todos os modelos compatíveis no Cursor. Direcione agentes para o melhor modelo para a tarefa em questão, com o equilíbrio desejado entre custo e capacidade, alterando um único campo.

E com o Composer 2, um modelo especializado em programação que alcança performance de ponta por uma fração do custo dos modelos de uso geral, você obtém a melhor combinação de inteligência e eficiência para a maioria das tarefas de agentes de programação.

#O que os desenvolvedores estão criando

As equipes estão usando o SDK do Cursor para entregar agentes personalizados com mais rapidez. Por exemplo, agentes programáveis acionados diretamente pelo CI/CD para resumir mudanças, identificar a causa raiz de falhas de CI e atualizar PRs com correções. Outras estão desenvolvendo plataformas personalizadas de agentes, como aplicações internas que permitem que equipes de GTM consultem dados de produto sem escrever código.

Alguns clientes estão até incorporando o Cursor diretamente a produtos voltados ao cliente, nos quais os usuários finais agora têm uma experiência com agente sem sair da aplicação principal.

Ouça alguns dos nossos clientes que estão desenvolvendo com o SDK do Cursor:

#Comece com um projeto de exemplo

Adicionamos alguns projetos iniciais a um repositório público no GitHub que você pode fazer fork e expandir para seus próprios casos de uso:

• Início rápido: Um exemplo mínimo em Node.js que cria um agente local, envia um prompt e transmite a resposta em streaming.
• Ferramenta de prototipagem: Um app web para iniciar agentes, estruturar novos projetos e iterar em ideias em um ambiente de nuvem isolado.
• Quadro kanban: Uma ferramenta kanban com agentes, em que engenheiros podem arrastar um cartão e fazer com que agentes assumam o trabalho programaticamente, abram uma PR e publiquem o resultado de volta como anexo.
• CLI de agente de programação: Uma interface de linha de comando leve que permite iniciar agentes do Cursor a partir do terminal.

#Próximos passos

O SDK do Cursor está disponível para todos os usuários e segue o preço padrão, com cobrança por consumo de tokens.

Continuamos investindo no SDK do Cursor, com foco em torná-lo ainda mais fácil para as equipes criarem agente programável em mais linguagens, fluxos de trabalho e padrões de implantação.

Saiba mais na nossa documentação. Você também pode usar o Cursor com nosso plugin do SDK do Cursor para começar a desenvolver.