Configura o Agent CLI usando o arquivo cli-config.json.
| Tipo | Plataforma | Caminho |
|---|
| Global | macOS/Linux | ~/.cursor/cli-config.json |
| Global | Windows | $env:USERPROFILE\.cursor\cli-config.json |
| Projeto | Todas | <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.
CURSOR_CONFIG_DIR: caminho de diretório personalizadoXDG_CONFIG_HOME (Linux/BSD): usa $XDG_CONFIG_HOME/cursor/cli-config.json
| Campo | Tipo | Descrição |
|---|
version | number | Versão do esquema de configuração (atual: 1) |
editor.vimMode | boolean | Ativa os atalhos de teclado do Vim (padrão: false) |
permissions.allow | string[] | Operações permitidas (veja Permissions) |
permissions.deny | string[] | Operações proibidas (veja Permissions) |
| Campo | Tipo | Descrição |
|---|
model | object | Configuração do modelo selecionado |
hasChangedDefaultModel | boolean | Sinalizador de substituição de modelo gerenciado pela CLI |
{
"version": 1,
"editor": { "vimMode": false },
"permissions": { "allow": ["Shell(ls)"], "deny": [] }
}
{
"version": 1,
"editor": { "vimMode": true },
"permissions": { "allow": ["Shell(ls)"], "deny": [] }
}
{
"version": 1,
"editor": { "vimMode": false },
"permissions": {
"allow": ["Shell(ls)", "Shell(echo)"],
"deny": ["Shell(rm)"]
}
}
mv ~/.cursor/cli-config.json ~/.cursor/cli-config.json.bad
- Formato JSON puro (sem comentários)
- A CLI faz autorreparo para campos ausentes
- Arquivos corrompidos são salvos como
.bad e recriados
- Entradas de permissão devem ser strings exatas (confere Permissions para detalhes)
