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

All configuration changes made through the /config wizard are saved to: 
~/.augment/settings.json
You can also manually edit this file to configure settings. The file supports JSON5 format, allowing comments and trailing commas for better documentation.

​
Example settings.json

{
  "shell": "zsh",
  "startupScript": "~/.augment/startup.sh",
  "enableChatInputCompletions": true,
  "autoUpdate": true,
  "notifications": "desktop"
}

​
Manual Configuration

While the /config wizard provides a convenient interface, you can also manually edit ~/.augment/settings.json to configure these settings. After making manual changes, restart Auggie for the changes to take effect.