Set global preferences in user-settings.json
configuration
// what it does
~/.grok/user-settings.json holds settings that apply across every project: apiKey, baseURL, defaultModel, and the models list. These are your rarely-changing defaults; anything a project needs to override goes in that project's .grok/settings.json instead.
// shell
$ ~/.grok/user-settings.json// gotcha
It lives in your home directory, not the repo, so it is not shared with teammates or CI — each machine needs its own. Keep the real apiKey here out of any dotfiles repo you sync publicly.