option

programs.github-copilot-cli.settings

Configuration written to config.json inside programs.github-copilot-cli.configDir.

Known configuration keys include:

model — AI model selection
effortLevel — reasoning effort for capable models
theme — "default", "dim", "high-contrast", or "colorblind"
mouse — enable mouse support (default: true)
banner — frequency of animated banner display
renderMarkdown — markdown rendering toggle (default: true)
screenReader — accessibility optimizations (default: false)
autoUpdate — automatic CLI updates (default: true)
stream — token-by-token response streaming (default: true)
includeCoAuthoredBy — agent commit attribution (default: true)
respectGitignore — exclude gitignored files from file picker
trusted_folders — list of pre-approved directory paths
allowed_urls, denied_urls — URL allowlists/blocklists
logLevel — log verbosity
disableAllHooks — global hook disable toggle
hooks — inline hook definitions
enabledFeatureFlags — enable or disable specific feature flags

See https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-config-dir-reference for the documentation.

Declarations

Type

attribute set of (JSON value)

Default

{ }

Example

{
  model = "claude-sonnet-4-5";
  theme = "default";
  trusted_folders = [ "/home/user/projects" ];
  renderMarkdown = true;
  autoUpdate = false;
}