Estamos lançando o SDK do Cursor para que você possa criar agentes com o mesmo tempo de execução, harness e modelos que impulsionam o Cursor.
Os agentes que executam no app para desktop do Cursor, na CLI e no app web agora podem ser acessados com algumas linhas de TypeScript. Execute-o na sua máquina ou na nuvem do Cursor, em uma VM dedicada, com qualquer modelo de ponta.
Execute npm install @cursor/sdk para dar os primeiros passos. Você também pode usar a skill nativa /sdk do Cursor para ajudar você a começar a desenvolver.
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);}
Desenvolvemos alguns projetos de exemplo que você pode acessar a partir de um repo público. Faça um fork deles e expanda-os para o seu caso de uso.
O SDK do Cursor agora está disponível para todos os usuários em beta pública e segue o modelo de preços padrão com base no consumo de tokens. Saiba mais em nosso anúncio e na documentação.
Reformulamos a API em torno de agentes duráveis e execuções por prompt, para que continuações, status, streaming e cancelamento agora passem a ter escopo por execução.
Adicionamos suporte nativo a streaming de execução com eventos SSE, suporte a reconexão via Last-Event-ID e estados finais mais claros.
Adicionamos controles explícitos do ciclo de vida do agente, com ações de arquivar, desarquivar e excluir permanentemente.
Padronizamos os formatos de resposta e erro da v1, incluindo códigos de erro estruturados, respostas de lista items e objetos agent / run separados.
Esta versão traz uma nova forma de trabalhar em várias tarefas ao mesmo tempo com subagentes assíncronos, uma experiência melhor com worktrees e espaços de trabalho com múltiplas pastas raiz para alterações entre repositórios.
Com /multitask, o Cursor executará subagentes assíncronos para paralelizar suas solicitações, em vez de adicioná-las à fila. Ele também dividirá tarefas maiores em partes menores, para que uma frota de subagentes assíncronos as resolva simultaneamente.
Se você já tiver mensagens na fila, poderá pedir ao Cursor para processá-las em paralelo, em vez de esperar a execução atual terminar.
Execute tarefas isoladas em segundo plano em diferentes branches. Quando estiver pronto para testar as alterações, traga qualquer branch para o ambiente local em primeiro plano com um clique.
#Espaços de trabalho com múltiplas pastas raiz na janela de agentes
Agora, uma única sessão de agente pode trabalhar em um espaço de trabalho reutilizável composto por várias pastas.
Isso permite que o Cursor faça alterações entre repositórios, abrangendo frontend, backend e bibliotecas compartilhadas, sem precisar redefinir o alvo do agente toda vez que ele alterna entre repositórios.
Essas visualizações podem incluir dashboards e interfaces personalizadas desenvolvidas com componentes próprios, como tabelas, caixas, diagramas e gráficos, além de componentes existentes do Cursor, como diffs e listas de tarefas.
Na janela de agentes, os canvases são artefatos persistentes que ficam no painel lateral, ao lado do terminal, Browser e controle de versão.
Experimente no Cursor 3.1 na janela de agentes ou no editor. Leia mais no nosso anúncio.
Use /debug para encontrar as causas raiz e corrigir bugs difíceis de reproduzir ou entender. No Modo Debug, o Cursor gera hipóteses, adiciona mensagens de log e usa informações de tempo de execução para identificar com precisão o problema antes de fazer uma correção direcionada.
Faça uma pergunta rápida à parte sem tirar o agente da tarefa principal. /btw permite que você peça esclarecimentos sobre a alteração que o Cursor está fazendo sem interromper a execução em andamento.
/config abre um painel interativo de configurações na CLI, no qual você pode visualizar e alterar comportamentos, como escolhas de modelo, valores padrão, preferências de tempo de execução e muito mais.
Você também pode pedir ao Cursor para aplicar alterações na configuração usando a skill /update-cli-config.
Personalize a barra de status usando /statusline para destacar os sinais de sessão e de tempo de execução que são importantes para você, incluindo modo atual, branch, ambiente, dicas da tarefa ativa ou outros metadados da sessão.
Acione o seletor de modelos de qualquer lugar para alternar entre modelos sem precisar limpar seu prompt antes.
Se o Cursor detectar que você ativou o auto-run três vezes seguidas, agora ele vai sugerir proativamente que você o ative para evitar loops intermináveis de aprovação.
A ferramenta AskQuestion e o modo Debug agora lidam melhor com respostas em texto simples.
Agora há suporte para colar imagens da área de transferência, incluindo Ctrl+V em alguns terminais sem suporte nativo a colagem.
O rodapé agora mostra seu diretório de trabalho, worktree e branch atual.
Agora você pode enviar a CLI para segundo plano com segurança usando Ctrl+Z.
O auto-run agora funciona em outros modos, como modo Debug e modo Debug.
Corrigimos um problema em que processos de shell em segundo plano podiam continuar em execução após sair da CLI.
Corrigimos o tratamento e a correspondência de comandos de barra.
Corrigimos o tratamento do teclado para Cmd+Delete, atalhos de teclado do Vim e combinações com o modificador Ctrl.
Divida a visualização atual em painéis para executar e gerenciar vários agentes em paralelo. O layout em mosaico facilita fazer várias tarefas ao mesmo tempo e comparar saídas entre agentes sem alternar entre abas.
Amplie os painéis para se concentrar em uma conversa, arraste agentes para os mosaicos e use atalhos de teclado para navegar e organizar tudo rapidamente. Sua configuração também é preservada entre sessões.
O ditado por voz está mais confiável e preciso. Ele grava todo o trecho da sua fala e o transcreve com STT em lote para oferecer uma conversão de fala em texto de maior qualidade.
Você pode pressionar e segurar Ctrl+M para falar, e adicionamos controles à interface durante a gravação, como uma forma de onda, cronômetro e botões para cancelar e confirmar.
Antes, ao iniciar um agente a partir do estado vazio, ele normalmente usava sua branch atual por padrão. Agora você pode primeiro buscar e selecionar uma branch e, em seguida, iniciar um agente na nuvem diretamente nela.
Isso reduz as etapas extras para alternar entre branches e diminui execuções acidentais na branch errada.
Vá do diff direto para a linha exata no arquivo. Ao chegar lá, você tem todo o poder do editor: faça alterações manualmente, use o Tab, vá para a definição e muito mais.
Use filtros de inclusão/exclusão em "Buscar em Arquivos" para restringir a busca de código a conjuntos específicos de arquivos.
Os botões de prompt agora permanecem no lugar enquanto a entrada por voz é processada.
As abas de plano agora têm os mesmos comportamentos de documento que os arquivos: suporte a carregamento confiável, rastreamento de alterações não salvas, recarregamento quando o plano muda e a capacidade de salvar, copiar e exportar em markdown.
Novas sessões de agente agora começam no destino de projeto preferido por padrão.
Os nomes das abas de arquivos agora são resolvidos com base nas abas visíveis do agente atual, em vez de tentar ser globalmente únicos em relação às abas de todos os outros agentes.
Cmd-K agora mostra menos resultados de agente, mas mais relevantes, limitados ao conjunto recente correspondente (ou seja, itens que correspondem à sua consulta e vêm de um subconjunto recente).
No macOS, o texto agora é renderizado com antisserrilhamento, produzindo contornos de caracteres mais nítidos.
O Modo Design agora permite navegar pela árvore de elementos (para cima, para baixo e para os lados) com suporte ao teclado para escolher o elemento da interface antes de comentar.
A janela de agentes agora evita atualizações e buscas custosas, a menos que sejam realmente necessárias.
Fechar abas agora tem menos chance de causar falhas na árvore de arquivos, e a recuperação é mais rápida.
As buscas locais de diff foram limitadas para reduzir picos de CPU/rede e a lentidão nas visualizações de SCM.
A árvore de arquivos agora responde às alterações com mais confiabilidade e tem menos chance de piscar, ficar desatualizada ou deixar de mostrar atualizações.
Os eventos da extensão (por exemplo, alteração de arquivo e atualização de diagnósticos) agora são limitados a cada espaço de trabalho, reduzindo a interferência entre projetos.
Pressionar Enter para enviar uma continuação em um chat longo costumava travar por mais de um segundo e agora é instantâneo.
Grandes edições agora fluem com mais suavidade após a redução de ~87% nos quadros perdidos.
Corrigido um bug em que rolar conversas longas costumava engasgar. Agora está fluido, mesmo em threads grandes.
Corrigido um bug em que uma conversa do agente cheia de diffs ou blocos de código piscava e travava.
Estamos lançando o SDK do Cursor para que você possa criar agentes com o mesmo tempo de execução, harness e modelos que impulsionam o Cursor.
Os agentes que executam no app para desktop do Cursor, na CLI e no app web agora podem ser acessados com algumas linhas de TypeScript. Execute-o na sua máquina ou na nuvem do Cursor, em uma VM dedicada, com qualquer modelo de ponta.
Execute npm install @cursor/sdk para dar os primeiros passos. Você também pode usar a skill nativa /sdk do Cursor para ajudar você a começar a desenvolver.
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);}
Desenvolvemos alguns projetos de exemplo que você pode acessar a partir de um repo público. Faça um fork deles e expanda-os para o seu caso de uso.
O SDK do Cursor agora está disponível para todos os usuários em beta pública e segue o modelo de preços padrão com base no consumo de tokens. Saiba mais em nosso anúncio e na documentação.
Reformulamos a API em torno de agentes duráveis e execuções por prompt, para que continuações, status, streaming e cancelamento agora passem a ter escopo por execução.
Adicionamos suporte nativo a streaming de execução com eventos SSE, suporte a reconexão via Last-Event-ID e estados finais mais claros.
Adicionamos controles explícitos do ciclo de vida do agente, com ações de arquivar, desarquivar e excluir permanentemente.
Padronizamos os formatos de resposta e erro da v1, incluindo códigos de erro estruturados, respostas de lista items e objetos agent / run separados.
Esta versão traz uma nova forma de trabalhar em várias tarefas ao mesmo tempo com subagentes assíncronos, uma experiência melhor com worktrees e espaços de trabalho com múltiplas pastas raiz para alterações entre repositórios.
Com /multitask, o Cursor executará subagentes assíncronos para paralelizar suas solicitações, em vez de adicioná-las à fila. Ele também dividirá tarefas maiores em partes menores, para que uma frota de subagentes assíncronos as resolva simultaneamente.
Se você já tiver mensagens na fila, poderá pedir ao Cursor para processá-las em paralelo, em vez de esperar a execução atual terminar.
Execute tarefas isoladas em segundo plano em diferentes branches. Quando estiver pronto para testar as alterações, traga qualquer branch para o ambiente local em primeiro plano com um clique.
#Espaços de trabalho com múltiplas pastas raiz na janela de agentes
Agora, uma única sessão de agente pode trabalhar em um espaço de trabalho reutilizável composto por várias pastas.
Isso permite que o Cursor faça alterações entre repositórios, abrangendo frontend, backend e bibliotecas compartilhadas, sem precisar redefinir o alvo do agente toda vez que ele alterna entre repositórios.
Essas visualizações podem incluir dashboards e interfaces personalizadas desenvolvidas com componentes próprios, como tabelas, caixas, diagramas e gráficos, além de componentes existentes do Cursor, como diffs e listas de tarefas.
Na janela de agentes, os canvases são artefatos persistentes que ficam no painel lateral, ao lado do terminal, Browser e controle de versão.
Experimente no Cursor 3.1 na janela de agentes ou no editor. Leia mais no nosso anúncio.
Use /debug para encontrar as causas raiz e corrigir bugs difíceis de reproduzir ou entender. No Modo Debug, o Cursor gera hipóteses, adiciona mensagens de log e usa informações de tempo de execução para identificar com precisão o problema antes de fazer uma correção direcionada.
Faça uma pergunta rápida à parte sem tirar o agente da tarefa principal. /btw permite que você peça esclarecimentos sobre a alteração que o Cursor está fazendo sem interromper a execução em andamento.
/config abre um painel interativo de configurações na CLI, no qual você pode visualizar e alterar comportamentos, como escolhas de modelo, valores padrão, preferências de tempo de execução e muito mais.
Você também pode pedir ao Cursor para aplicar alterações na configuração usando a skill /update-cli-config.
Personalize a barra de status usando /statusline para destacar os sinais de sessão e de tempo de execução que são importantes para você, incluindo modo atual, branch, ambiente, dicas da tarefa ativa ou outros metadados da sessão.
Acione o seletor de modelos de qualquer lugar para alternar entre modelos sem precisar limpar seu prompt antes.
Se o Cursor detectar que você ativou o auto-run três vezes seguidas, agora ele vai sugerir proativamente que você o ative para evitar loops intermináveis de aprovação.
A ferramenta AskQuestion e o modo Debug agora lidam melhor com respostas em texto simples.
Agora há suporte para colar imagens da área de transferência, incluindo Ctrl+V em alguns terminais sem suporte nativo a colagem.
O rodapé agora mostra seu diretório de trabalho, worktree e branch atual.
Agora você pode enviar a CLI para segundo plano com segurança usando Ctrl+Z.
O auto-run agora funciona em outros modos, como modo Debug e modo Debug.
Corrigimos um problema em que processos de shell em segundo plano podiam continuar em execução após sair da CLI.
Corrigimos o tratamento e a correspondência de comandos de barra.
Corrigimos o tratamento do teclado para Cmd+Delete, atalhos de teclado do Vim e combinações com o modificador Ctrl.
Divida a visualização atual em painéis para executar e gerenciar vários agentes em paralelo. O layout em mosaico facilita fazer várias tarefas ao mesmo tempo e comparar saídas entre agentes sem alternar entre abas.
Amplie os painéis para se concentrar em uma conversa, arraste agentes para os mosaicos e use atalhos de teclado para navegar e organizar tudo rapidamente. Sua configuração também é preservada entre sessões.
O ditado por voz está mais confiável e preciso. Ele grava todo o trecho da sua fala e o transcreve com STT em lote para oferecer uma conversão de fala em texto de maior qualidade.
Você pode pressionar e segurar Ctrl+M para falar, e adicionamos controles à interface durante a gravação, como uma forma de onda, cronômetro e botões para cancelar e confirmar.
Antes, ao iniciar um agente a partir do estado vazio, ele normalmente usava sua branch atual por padrão. Agora você pode primeiro buscar e selecionar uma branch e, em seguida, iniciar um agente na nuvem diretamente nela.
Isso reduz as etapas extras para alternar entre branches e diminui execuções acidentais na branch errada.
Vá do diff direto para a linha exata no arquivo. Ao chegar lá, você tem todo o poder do editor: faça alterações manualmente, use o Tab, vá para a definição e muito mais.
Use filtros de inclusão/exclusão em "Buscar em Arquivos" para restringir a busca de código a conjuntos específicos de arquivos.
Os botões de prompt agora permanecem no lugar enquanto a entrada por voz é processada.
As abas de plano agora têm os mesmos comportamentos de documento que os arquivos: suporte a carregamento confiável, rastreamento de alterações não salvas, recarregamento quando o plano muda e a capacidade de salvar, copiar e exportar em markdown.
Novas sessões de agente agora começam no destino de projeto preferido por padrão.
Os nomes das abas de arquivos agora são resolvidos com base nas abas visíveis do agente atual, em vez de tentar ser globalmente únicos em relação às abas de todos os outros agentes.
Cmd-K agora mostra menos resultados de agente, mas mais relevantes, limitados ao conjunto recente correspondente (ou seja, itens que correspondem à sua consulta e vêm de um subconjunto recente).
No macOS, o texto agora é renderizado com antisserrilhamento, produzindo contornos de caracteres mais nítidos.
O Modo Design agora permite navegar pela árvore de elementos (para cima, para baixo e para os lados) com suporte ao teclado para escolher o elemento da interface antes de comentar.
A janela de agentes agora evita atualizações e buscas custosas, a menos que sejam realmente necessárias.
Fechar abas agora tem menos chance de causar falhas na árvore de arquivos, e a recuperação é mais rápida.
As buscas locais de diff foram limitadas para reduzir picos de CPU/rede e a lentidão nas visualizações de SCM.
A árvore de arquivos agora responde às alterações com mais confiabilidade e tem menos chance de piscar, ficar desatualizada ou deixar de mostrar atualizações.
Os eventos da extensão (por exemplo, alteração de arquivo e atualização de diagnósticos) agora são limitados a cada espaço de trabalho, reduzindo a interferência entre projetos.
Pressionar Enter para enviar uma continuação em um chat longo costumava travar por mais de um segundo e agora é instantâneo.
Grandes edições agora fluem com mais suavidade após a redução de ~87% nos quadros perdidos.
Corrigido um bug em que rolar conversas longas costumava engasgar. Agora está fluido, mesmo em threads grandes.
Corrigido um bug em que uma conversa do agente cheia de diffs ou blocos de código piscava e travava.
