Settings

The /settings slash command opens an interactive menu for common options. It replaces the /config command from Auggie 0.x.

# Start Auggie in interactive mode
auggie

# Then type the slash command
/settings

Type to filter the list, use the arrow keys to move, and press Enter to change a value. Press Escape to go back. Changes made in /settings are always saved to your user settings file, ~/.augment/settings.json (C:\Users\<username>\.augment\settings.json on Windows). Auggie 1.x does not prompt you to choose a settings file. To change project or local settings, edit those files directly.

Available options

General

Option	Setting	Description
Auto-compact	`compaction.enabled`	Automatically summarize the conversation when the context window fills up
Steering mode	`steeringMode`	Send steering messages `one-at-a-time` or `all` at once
Follow-up mode	`followUpMode`	Send queued follow-up messages `one-at-a-time` or `all` at once
Double-escape action	`doubleEscapeAction`	What pressing `Escape` twice does: `tree`, `fork`, or `none`
Tree filter mode	`treeFilterMode`	Default filter for `/tree`
Auto-resize images	`images.autoResize`	Resize images to at most 2000x2000 before sending. Images fetched by the `web-fetch` tool are always resized
Block images	`images.blockImages`	Never send images to the model
Skill commands	`enableSkillCommands`	Register skills as `/skill:name` commands
MCP tool discovery	`disableToolSearch`	Turn off automatic MCP tool discovery, which hides MCP tools behind `find-tool` and `execute-tool` when their definitions take up too much context. Appears only when automatic discovery is available

Display

These options only change how the terminal UI looks.

Option	Setting	Description
Theme	`theme`	Color theme: `dark`, `light`, `ansi`, or a custom theme
Hide thinking	`hideThinkingBlock`	Hide reasoning blocks in the transcript
Quiet startup	`quietStartup`	Hide the startup header
Collapse changelog	`collapseChangelog`	Show a condensed changelog after updates
Collapse prompt commands	`collapsePromptCommands`	Show custom command invocations as a single collapsed line
Show images	`terminal.showImages`	Render images in terminals that support it
Show hardware cursor	`showHardwareCursor`	Show the terminal cursor
Editor padding	`editorPaddingX`	Horizontal padding for the input editor (0-3)
Autocomplete max items	`autocompleteMaxVisible`	Number of visible autocomplete suggestions (3-20)
Clear on shrink	`terminal.clearOnShrink`	Clear empty rows when content shrinks

Some options only appear when the related feature is available. To change the reasoning effort, use /effort or press Shift+Tab.

Themes

Auggie 1.x ships with dark, light, and ansi themes. Use ansi if your terminal does not support true color. The legacy default-dark value from 0.x is treated as dark.

{
  "theme": "ansi"
}

Settings files

Auggie reads settings from these files, from highest to lowest precedence:

Managed settings (read-only)
- /etc/augment/settings.json on macOS and Linux
- C:\ProgramData\augment\settings.json on Windows
- Set by organization admins and cannot be overridden by users
Local project settings: <workspace>/.augment/settings.local.json
- Personal, per-project overrides that should not be committed
Project settings: <workspace>/.augment/settings.json
- Shared, per-project configuration that should be committed to source control
User settings: ~/.augment/settings.json
- Personal defaults that apply across projects, and the file /settings writes to

Higher-precedence files override lower-precedence files. Tool permission rules from all files are combined. Some commands still write to project or local settings when you ask them to, for example auggie mcp add --project or auggie mcp add --local. See Integrations and MCP. The files support JSON with Comments (JSONC), so comments and trailing commas are allowed. After editing a file manually, restart Auggie for the changes to take effect.

Example settings.json

{
  "defaultModel": "sonnet",
  "theme": "dark",
  "shellPath": "zsh",
  "shellCommandPrefix": "source ~/.augment/startup.sh",
  "notificationMode": "desktop_notification",
  "autoUpdate": true
}

Common settings

Setting	Description
`defaultModel`	Default model for new sessions
`defaultThinkingLevel`	Default reasoning effort: `off`, `minimal`, `low`, `medium`, `high`, or `xhigh`
`theme`	Color theme
`shellPath`	Shell used by the `bash` tool: a full path, or `bash`, `zsh`, `fish`, `sh`, or `powershell`. `shell` (the 0.x name) still works
`shellCommandPrefix`	Shell code run before every `bash` tool command, for example `source ~/.augment/startup.sh`. It’s shell text, not a file path. `startupScript` (the 0.x name) still works
`notificationMode`	Notify when the agent finishes or asks a question: `off`, `bell`, or `desktop_notification`
`autoUpdate`	Automatically update Auggie in interactive mode. See Automatic Updates
`updateTerminalTitle`	Set the terminal title automatically
`verbose`	Expand tool output by default

See Permissions for toolPermissions and Integrations and MCP for mcpServers.

Keybindings

Customize keyboard shortcuts in ~/.augment/keybindings.json, then run /reload to apply them. Run /hotkeys to see all current shortcuts.

Getting Started

Cosmos

Auggie CLI

Other clients

Admin

Models & Pricing

Troubleshooting

The `/settings` menu

Available options

General

Display

Themes

Settings files

Example settings.json

Common settings

Keybindings

​The /settings menu

​Available options

​General

​Display

​Themes

​Settings files

​Example settings.json

​Common settings

​Keybindings

The `/settings` menu

Available options

General

Display

Themes

Settings files

Example settings.json

Common settings

Keybindings