Opções globais

As opções globais podem ser usadas com qualquer comando:
OpçãoDescrição
-v, --versionMostra o número da versão
-a, --api-key <key>Chave de API para autenticação (também dá pra usar a variável de ambiente CURSOR_API_KEY)
-p, --printImprime as respostas no console (para scripts ou uso não interativo). Tem acesso a todas as ferramentas, incluindo write e bash.
--output-format <format>Formato de saída (funciona só com --print): text, json ou stream-json (padrão: stream-json)
-b, --backgroundInicia em segundo plano (abre o seletor do composer ao iniciar)
--fullscreenAtiva o modo tela cheia
--resume [chatId]Retoma uma sessão de chat
-m, --model <model>Modelo a ser usado
-f, --forceForça a permissão de comandos, a menos que sejam explicitamente negados
-h, --helpMostra a ajuda do comando

Comandos

ComandoDescriçãoUso
loginAutenticar no Cursorcursor-agent login
logoutSair e limpar a autenticação armazenadacursor-agent logout
statusVerificar o status da autenticaçãocursor-agent status
mcpGerenciar servidores MCPcursor-agent mcp
update|upgradeAtualizar o Cursor Agent para a versão mais recentecursor-agent update ou cursor-agent upgrade
lsRetomar uma sessão de chatcursor-agent ls
resumeRetomar a sessão de chat mais recentecursor-agent resume
help [command]Exibir ajuda para um comandocursor-agent help [command]
Quando nenhum comando é especificado, o Cursor Agent inicia no modo de chat interativo por padrão.

MCP

Gerencia servidores MCP configurados para o Cursor Agent.
SubcommandDescriptionUsage
login <identifier>Autentica em um servidor MCP configurado em .cursor/mcp.jsoncursor-agent mcp login <identifier>
listLista os servidores MCP configurados e seus statuscursor-agent mcp list
list-tools <identifier>Lista as ferramentas disponíveis e os nomes de argumentos para um MCP específicocursor-agent mcp list-tools <identifier>
Todos os comandos MCP aceitam -h, --help para ajuda específica do comando.

Argumentos

Ao iniciar no modo chat (comportamento padrão), você pode fornecer um prompt inicial: Argumentos:
  • prompt — Prompt inicial para o agente

Obtendo ajuda

Todos os comandos oferecem suporte à opção global -h, --help para exibir a ajuda específica do comando.