Configuring Amazon Q settings

Amazon Q provides various ways to customize its behavior through settings. You can access these settings through both a graphical interface and command-line options.

Accessing settings

You can access Amazon Q settings in two ways:

• Settings GUI: Run q settings to open the graphical settings interface

• Command line: Use various commands to view and modify settings directly

Command line settings management

You can manage Amazon Q settings directly from the command line using the following commands:

Basic settings commands

Command	Description
q settings	Opens the settings GUI interface
q settings all	Lists all current settings
q settings all -f json-pretty	Lists all settings in formatted JSON
q settings open	Opens the settings file in your default editor
q settings [KEY] [VALUE]	Views or sets a specific setting
q settings -d [KEY]	Deletes a specific setting

When using q settings commands, you can specify the output format:

q settings -f [FORMAT]

Available formats:

• plain: Outputs results as markdown (default)

• json: Outputs results as JSON

• json-pretty: Outputs results as formatted JSON

Autocomplete and inline suggestions

Amazon Q provides commands to manage inline suggestions that appear as you type in your terminal:

Inline suggestion commands

Command	Description
q inline enable	Enables inline suggestions that appear as you type
q inline disable	Disables inline suggestions
q inline status	Shows whether inline suggestions are enabled or disabled
q inline set-customization	Sets which customization model to use for suggestions
q inline show-customizations	Shows available customization models

Amazon Q supports different customization models for suggestions, which may vary depending on your environment and installation.

Other Amazon Q CLI commands

Amazon Q offers several other command-line features:

Additional CLI commands

Command	Description
q profile	Lists your available settings profiles and allows you to select one
q whoami	Reveals your settings profile
q chat	Opens an interactive chat session with Amazon Q
q translate	Translates natural language to shell commands
q doctor	Diagnoses and fixes common installation issues
q update	Checks for and installs updates to Amazon Q
q theme	Gets or sets the visual theme
q integrations	Manages system integrations

For more information about any command, use the --help flag:

q [COMMAND] --help

Log files

Amazon Q Developer CLI maintains log files that can be useful for troubleshooting. These logs are stored locally on your machine and are not sent to AWS.

Log files are located at:

• macOS: $TMPDIR/qlog/

• Linux: ~/.local/share/amazonq/logs/

The log level can be controlled by setting the Q_LOG_LEVEL environment variable. Valid values are:

• error: Only error messages (default)

• warn: Warning and error messages

• info: Informational, warning, and error messages

• debug: Debug, informational, warning, and error messages

• trace: All messages including detailed trace information

Warning

Log files may contain sensitive information from your conversations and interactions with Amazon Q, including file paths, code snippets, and command outputs. While these logs are stored only on your local machine and are not sent to AWS, you should be cautious when sharing log files with others.

Example of setting the log level (for debugging purposes):

# For bash/zsh
export Q_LOG_LEVEL=debug
q chat

# For fish
set -x Q_LOG_LEVEL debug
q chat