Skip to main content

​
How the Configuration Wizard Works

The /config command opens an interactive configuration wizard in Auggie CLI that allows you to customize your CLI experience. This wizard provides a user-friendly interface to manage various settings without manually editing configuration files.

​
Accessing the Configuration Wizard

In interactive mode (TUI), use the /config slash command: 
# Start Auggie in interactive mode
auggie

# Then type the slash command
/config

​
Available Configuration Options

The configuration wizard allows you to customize the following settings:

​
Shell Selection

Choose your preferred shell for command execution:
  • bash
  • zsh
  • fish
  • powershell
The selected shell will be used when Auggie needs to execute shell commands in your environment.

​
Startup Script

Configure a custom startup script that runs when Auggie starts. This is useful for:
  • Setting environment variables
  • Loading custom configurations
  • Initializing tools or services

​
Chat Input Completions

Enable or disable chat input completions in the CLI. When enabled, Auggie provides intelligent autocomplete suggestions as you type in the chat interface. This setting controls the enableChatInputCompletions option in your settings file.

​
Auto-Update

Control whether Auggie automatically updates itself when running in interactive mode.
  • Enabled (default): Auggie checks for and installs updates automatically
  • Disabled: You must manually update using auggie upgrade
See Automatic Updates for more details about how auto-updates work.

​
Notifications

Choose how Auggie notifies you about important events:
  • Off: No notifications
  • Bell: Terminal bell sound
  • Desktop Notification: System desktop notifications

​
Settings File

Configuration changes made through the /config wizard can be saved to any writable Augment settings file. If more than one writable settings file is available, Auggie prompts you to choose where to save the change. 
~/.augment/settings.json
<workspace>/.augment/settings.json
<workspace>/.augment/settings.local.json
You can also manually edit these files to configure settings. The files support JSON5 format, allowing comments and trailing commas for better documentation.

​
Example settings.json

{
  "shell": "zsh",
  "startupScript": "source ~/.augment/startup.sh",
  "enableChatInputCompletions": true,
  "autoUpdate": true,
  "notificationMode": "desktop_notification",
  "autoUpdateMarketplaces": true
}
See Plugins and Marketplaces for plugin-related settings like autoUpdateMarketplaces, recommendedMarketplaces, and dismissedMarketplaces.

​
Manual Configuration

While the /config wizard provides a convenient interface, you can also manually edit the appropriate Augment settings file directly. After making manual changes, restart Auggie for the changes to take effect.