Prompting

Declarar sua intenção de forma clara é recomendado para obter os melhores resultados. Por exemplo, você pode usar o prompt “não escreva nenhum código” para garantir que o agente não vai editar nenhum arquivo. Isso é geralmente útil quando você está planejando tarefas antes de implementá-las. O Agent atualmente tem ferramentas para operações de arquivo, busca e execução de comandos shell. Mais ferramentas estão sendo adicionadas, similar ao agente da IDE.

MCP

O Agent oferece suporte ao MCP (Model Context Protocol) para funcionalidades estendidas e integrações. A CLI vai detectar automaticamente e respeitar seu arquivo de configuração mcp.json, habilitando os mesmos servidores MCP e ferramentas que você configurou para o IDE.

Regras

O agente CLI oferece suporte ao mesmo sistema de regras da IDE. Você pode criar regras no diretório .cursor/rules para fornecer contexto e orientação ao agente. Essas regras são carregadas e aplicadas automaticamente com base na configuração delas, permitindo que você customize o comportamento do agente para diferentes partes do seu projeto ou tipos específicos de arquivo.
O CLI também lê os arquivos AGENT.md e CLAUDE.md na raiz do projeto (se estiverem presentes) e os aplica como regras junto com .cursor/rules.

Trabalhando com o Agent

Mensagens anteriores podem ser acessadas com a seta para cima (Arrow-Up), e dá pra percorrer por elas.

Revisão

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

Selecionando contexto

Seleciona arquivos e pastas pra incluir no contexto com @. Libera espaço na janela de contexto executando /compress. Vê Summarization pra 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. Também dá pra rodar cursor-agent ls pra ver a lista de conversas anteriores.

Aprovação de comandos

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

Modo não interativo

Use -p ou --print para executar o Agent em modo não interativo. Isso vai exibir a resposta no console. Com o modo não interativo, você pode chamar o Agent de forma não interativa. Isso permite que você o integre em scripts, pipelines de CI, etc. Você pode combinar isso com --output-format para controlar como a saída é formatada. Por exemplo, use --output-format json para saída estruturada que é mais fácil de processar em scripts, ou --output-format text para saída em texto simples.
O Cursor tem acesso completo de escrita no modo não interativo.