Configura o Agent CLI usando o arquivo cli-config.json.

​
Localização do arquivo

TipoPlataformaCaminho
GlobalmacOS/Linux~/.cursor/cli-config.json
GlobalWindows$env:USERPROFILE\.cursor\cli-config.json
ProjetoTodas<project>/.cursor/cli.json
Somente as permissões podem ser configuradas no nível do projeto. Todas as outras configurações da CLI devem ser definidas globalmente.
Sobrescrever com variáveis de ambiente:
  • CURSOR_CONFIG_DIR: caminho de diretório personalizado
  • XDG_CONFIG_HOME (Linux/BSD): usa $XDG_CONFIG_HOME/cursor/cli-config.json

​
Esquema

​
Campos obrigatórios

CampoTipoDescrição
versionnumberVersão do esquema de configuração (atual: 1)
editor.vimModebooleanAtiva os atalhos do Vim (padrão: false)
permissions.allowstring[]Operações permitidas (consulte Permissions)
permissions.denystring[]Operações proibidas (consulte Permissions)

​
Campos opcionais

CampoTipoDescrição
modelobjectConfiguração do modelo selecionado
hasChangedDefaultModelbooleanSinalizador de substituição de modelo gerenciado pela CLI

​
Exemplos

​
Configuração mínima

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": { "allow": ["Shell(ls)"], "deny": [] }
}

​
Ativar o modo Vim

{
  "version": 1,
  "editor": { "vimMode": true },
  "permissions": { "allow": ["Shell(ls)"], "deny": [] }
}

​
Configurar permissões

{
  "version": 1,
  "editor": { "vimMode": false },
  "permissions": {
    "allow": ["Shell(ls)", "Shell(echo)"],
    "deny": ["Shell(rm)"]
  }
}
Confira permissões para ver os tipos disponíveis e exemplos.

​
Solução de problemas

Erros de configuração: Move o arquivo para outro local e reinicia: 
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad
Alterações não persistem: Garante que o JSON esteja válido e que tu tens permissão de escrita. Alguns campos são gerenciados pela CLI e podem ser sobrescritos.

​
Notas

  • Formato JSON puro (sem comentários)
  • A CLI realiza autorreparo para campos ausentes
  • Arquivos corrompidos são salvos como .bad e recriados
  • As entradas de permissão são strings literais (veja Permissions para detalhes)