Skip to main content

Command Palette

Search for a command to run...

CLI

CLI do Cursor

A CLI do Cursor permite interagir com agentes de IA diretamente do terminal para escrever, revisar e modificar código. Seja por meio de uma interface de terminal interativa ou da automação de saída para scripts e pipelines de CI, a CLI oferece recursos avançados de programação exatamente onde você trabalha.

Primeiros passos

# Instalar (macOS, Linux, WSL)curl https://cursor.com/install -fsS | bash# Instalar (Windows PowerShell)irm 'https://cursor.com/install?win32=true' | iex# Iniciar sessão interativaagent

Modo interativo

Inicie uma sessão com o agente para descrever seus objetivos, revisar as alterações propostas e aprovar comandos:

# Iniciar sessão interativaagent# Iniciar com prompt inicialagent "refactor the auth module to use JWT tokens"

Modos

A CLI oferece os mesmos modos do Editor. Alterne entre eles usando comandos slash, atalhos de teclado ou a flag --mode.

ModoDescriçãoAtalho
AgenteAcesso total a todas as ferramentas para tarefas de programação complexasPadrão (não é necessário informar um valor para --mode)
PlanDefina sua abordagem antes de programar com perguntas para esclarecer dúvidasShift+Tab, /plan, --plan, --mode=plan
AskExploração em modo somente leitura, sem fazer alterações/ask, --mode=ask

Modo não interativo

Use o modo de impressão em cenários não interativos, como scripts, pipelines de CI ou automação:

# Executa com um prompt e um modelo específicosagent -p "find and fix performance issues" --model "gpt-5"# Usa incluindo as alterações do git para revisãoagent -p "review these changes for security issues" --output-format text

Transferência para o Cloud Agent

Envie sua conversa para um Cloud Agent para que ela continue em execução enquanto você estiver ausente. Adicione & no início de qualquer mensagem:

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

Retome as tarefas do Cloud Agent na web ou no celular em cursor.com/agents.

Sessões

Retome conversas anteriores para manter o contexto em várias interações:

# Abra conversas anteriores e retome uma delasagent ls# Retome a conversa mais recenteagent resume# Continue a sessão anterioragent --continue# Retome uma conversa específicaagent --resume="chat-id-here"

Controles da sandbox

Configure as configurações de execução de comandos com /sandbox ou a flag --sandbox <mode> (enabled ou disabled). Ative ou desative o modo sandbox e controle o acesso à rede em um menu interativo. As configurações persistem entre sessões.

Solicitação de senha do sudo

Execute comandos que exigem privilégios elevados sem sair da CLI. Quando um comando requer sudo, o Cursor exibe um prompt de senha seguro e mascarado. Sua senha é enviada diretamente ao sudo por um canal IPC seguro; o modelo de IA nunca tem acesso a ela.