Prompting

Declarar a intenção com clareza é recomendado para obter os melhores resultados. Por exemplo, você pode usar o prompt “do not write any code” para garantir que o agente não vai editar nenhum arquivo. Isso costuma ser útil ao planejar tarefas antes de implementá-las. O agente atualmente tem ferramentas para operações em arquivos, busca e execução de comandos de shell. Mais ferramentas estão sendo adicionadas, similares às do agente de IDE.

MCP

Agent é compatível com MCP (Model Context Protocol) para funcionalidades avançadas e integrações. A CLI detecta automaticamente e respeita teu arquivo de configuração mcp.json, habilitando os mesmos servidores e ferramentas MCP que tu configuraste no IDE.

Regras

O agente da CLI oferece suporte ao mesmo sistema de regras do 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 sua configuração, permitindo personalizar o comportamento do agente para diferentes partes do seu projeto ou tipos específicos de arquivo.
A CLI também lê AGENTS.md e CLAUDE.md na raiz do projeto (se 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), permitindo navegar por elas.

Revisão

Revê as alterações com Ctrl+R. Pressiona I para adicionar instruções de continuação. 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. Veja Summarization para mais detalhes.

Histórico

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

Aprovação de comandos

Antes de executar comandos no terminal, o CLI vai pedir pra 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 em scripts, pipelines de CI, etc. Tu pode combinar isso com --output-format pra controlar como a saída é formatada. Por exemplo, usa --output-format json pra ter uma saída estruturada, mais fácil de analisar em scripts, ou --output-format text pra saída em texto simples.
O Cursor tem acesso de escrita total no modo não interativo.