[Go to site: main page, start]
Skip to main content

Command Palette

Search for a command to run...

CLI

Usando o agente na CLI

Modos

A CLI oferece suporte aos mesmos modos do Editor. Alterne os modos usando comandos slash ou a flag --mode.

Modo Plan

Use o modo Plan para definir sua abordagem antes de programar. O agente faz perguntas para esclarecer dúvidas e aprimorar seu plano.

  • Pressione Shift+Tab para alternar para o modo Plan
  • Use /plan para alternar para o modo Plan
  • Inicie com a flag --plan ou --mode=plan

Modo Ask

Use o modo Ask para explorar o código sem fazer alterações. O agente busca na sua base de código e fornece respostas sem editar arquivos.

  • Use /ask para alternar para o modo Ask
  • Inicie com a flag --mode=ask

Criação de prompts

Para obter os melhores resultados, é recomendável deixar a intenção clara. Por exemplo, você pode usar o prompt "não escreva código" para garantir que o agente não edite arquivos. Isso geralmente é útil ao planejar tarefas antes de implementá-las.

O agente tem ferramentas para operações com arquivos, pesquisa, execução de comandos de shell e acesso à web.

MCP

O agente oferece suporte ao MCP (Model Context Protocol) para ampliar funcionalidades e integrações. A CLI detectará e usará automaticamente seu arquivo de configuração mcp.json, habilitando os mesmos servidores MCP e ferramentas configurados no Editor.

ACP

O agente também oferece suporte ao ACP (Agent Client Protocol) para integração com clientes personalizados. Use agent acp para executar a CLI do Cursor como um servidor ACP por stdio, com mensagens JSON-RPC.

Regras

O agente da CLI oferece suporte ao mesmo sistema de regras do Editor. Você pode criar regras no diretório .cursor/rules para fornecer contexto e orientações 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.

Como trabalhar com o agente

Navegação

Use a seta para cima (ArrowUpArrow Up) para acessar mensagens anteriores e alternar entre elas.

Atalhos de entrada

  • Shift+Tab — Alterne entre os modos (Agent, Plan, Ask)
  • Shift+Enter — Insira uma nova linha em vez de enviar, facilitando a escrita de prompts com várias linhas.
  • Ctrl+D — Saia da CLI. Segue o comportamento padrão do shell e exige pressionar duas vezes para sair.
  • Ctrl+J ou +Enter — Alternativas universais para inserir novas linhas que funcionam em todos os terminais.

Revisar

Revise as alterações com Ctrl+R. Pressione i para adicionar instruções de acompanhamento. Use ArrowUpArrow Up/ArrowDownArrow Down para rolar e ArrowLeftArrow Left/ArrowRightArrow Right para alternar entre arquivos.

Seleção de contexto

Selecione arquivos e pastas para incluir no contexto com @. Libere espaço na janela de contexto executando /summarize. /compress continua como um alias.

Transferência para o Cloud Agent

Envie sua conversa para um Cloud Agent e deixe-o continuar em execução enquanto você estiver ausente. Adicione & ao início de qualquer mensagem para enviá-la à nuvem. Retome a conversa na web ou no celular em cursor.com/agents.

# Envie uma tarefa ao Cloud Agent no meio da conversa& refactor the auth module and add comprehensive tests

Worktrees da CLI

Use -w ou --worktree [name] para executar o agente em uma nova worktree do Git, em vez de editar diretamente o checkout atual. O Cursor cria esses checkouts em ~/.cursor/worktrees/<reponame>/<name>, junto das worktrees criadas pelo Editor. Se você omitir name, o Cursor gerará um.

O Cursor limpa as worktrees da CLI com as mesmas regras de retenção usadas para as worktrees do Editor. Para ver as configurações e os limites de limpeza, consulte Como as worktrees antigas são limpas?.

Combine com --workspace <path> quando precisar especificar a raiz do repositório. Caso contrário, a CLI usa o diretório de trabalho atual. --worktree altera apenas onde o agente faz edições de arquivos dentro desse projeto.

# Crie um worktree temporário do repositório atual com um nome geradoagent --worktree "upgrade the test runner and fix any broken snapshots"# Crie um worktree nomeado de outro repositórioagent --workspace ~/src/my-app --worktree auth-fix "fix the flaky auth test and open a PR"

Histórico

Retome uma conversa existente com --resume [thread id] para carregar o contexto anterior.

Para retomar a conversa mais recente, use agent resume, --continue ou o comando slash /resume.

Você também pode executar agent ls para abrir chats anteriores e retomar um deles.

Aprovação de comandos

Antes de executar comandos de terminal, a CLI pedirá que você aprove (y) ou rejeite (n) a execução.

Modo não interativo

Use -p ou --print para executar o Agent em modo não interativo. A resposta será exibida no console.

No modo não interativo, você pode invocar o Agent de forma automatizada. Isso permite integrá-lo a scripts, pipelines de CI etc.

Você pode combinar essa opção com --output-format para controlar o formato da saída. Por exemplo, use --output-format json para uma saída estruturada mais fácil de processar em scripts ou --output-format text para a saída em texto simples da resposta final do agente.