Pular para o conteúdo principal

Prompting

Deixar a intenção bem clara é o ideal pra ter os melhores resultados. Por exemplo, dá pra usar o prompt “do not write any code” para garantir que o agente não vai editar nenhum arquivo. Isso geralmente ajuda na hora de planejar tarefas antes de implementá-las. O agente atualmente tem ferramentas para operações em arquivos, pesquisa e execução de comandos no shell. Mais ferramentas estão sendo adicionadas, semelhante ao agente de IDE.

MCP

O Agent oferece suporte ao MCP (Model Context Protocol) para funcionalidades avançadas e integrações. A CLI detecta e respeita automaticamente teu arquivo de configuração mcp.json, ativando os mesmos servidores e ferramentas MCP que tu configurou no IDE.

Regras

O agente da CLI oferece suporte ao mesmo sistema de regras do IDE. Dá para criar regras no diretório .cursor/rules para fornecer contexto e orientação ao agente. Essas regras são carregadas e aplicadas automaticamente conforme a configuração, permitindo personalizar o comportamento do agente para diferentes partes do projeto ou tipos específicos de arquivo.
A CLI também lê AGENTS.md e CLAUDE.md na raiz do projeto (se existentes) e aplica esses arquivos como regras junto com .cursor/rules.

Trabalhando com o Agent

As mensagens anteriores podem ser acessadas com a seta para cima (Arrow-Up), e dá pra navegar por elas em sequência.

Revisão

Revê as mudanças com Ctrl+R. Pressiona I para adicionar instruções de acompanhamento. Usa Arrow-Up/Arrow-Down para rolar e Arrow-Left/Arrow-Right para alternar entre arquivos.

Selecionando contexto

Seleciona arquivos e pastas para incluir no contexto com @. Libera espaço na janela de contexto executando /compress. Vê Summarization para mais detalhes.

Histórico

Continua de uma thread existente com --resume [thread id] pra carregar o contexto anterior. Pra retomar a conversa mais recente, usa cursor-agent resume. Tu também pode rodar cursor-agent ls pra ver uma lista de conversas anteriores.

Aprovação de comandos

Antes de executar comandos no terminal, a CLI vai pedir pra tu aprovar (Y) ou rejeitar (N) a execução.

Modo não interativo

Usa -p ou --print pra rodar o Agent em modo não interativo. Isso vai imprimir a resposta no console. No modo não interativo, dá pra invocar o Agent de forma não interativa. Isso permite integrar ele em scripts, pipelines de CI, etc. Dá pra combinar isso com --output-format pra controlar como a saída é formatada. Por exemplo, usa --output-format json pra obter uma saída estruturada, mais fácil de processar em scripts, ou --output-format text pra saída em texto simples.
O Cursor tem acesso completo de escrita no modo não interativo.
I