Utterly Voice icon image
Utterly Voice title image
Utterly Voice site map image

Editor Settings

Utterly Voice Editor settings are found in the config\editor.yaml file found in the application directory. This file has the following settings:

Setting Type Description
navigatorFavorites List Collection List of strings which provide favorite folders shown when you say "open navigator". Add any folders that you frequently access when opening files. Both local Windows paths and remote SSH paths (formatted as ssh://<name>/<remote-path>, where <name> matches an entry in sshHosts) are supported.
tabSize Number The displayed width of a tab character (maximum value of 8).
fillColumn Number Maximum line width in characters for the "fill column" command. Value should be between 10 and 120.
fontSize Number Text font size (try values between 10 and 20).
fonts List Collection Ordered list of font path strings. The first font to correctly load in this list is used. Relative paths are from the application folder.
colors Map Collection Editor user interface colors. See Colors below.
gemini Map Collection Settings specific to Gemini. See Gemini below.
codeColors Map Collection Syntax highlighting colors for Tree-sitter captures. See Code Colors below.
code List Collection Settings specific to code languages. See Code below.
sshHosts List Collection Remote SSH host configurations. See SSH Hosts below.

Colors link icon

Settings for customizing the colors of the editor user interface.

Setting Type Description
backgroundColorHex String The hex color of the panel text background.
backgroundAlternateColorHex String The alternate hex color of the panel background alternating striping.
foregroundColorHex String The hex color of the panel text foreground.
cursorColorHex String The hex color of the text cursor.
selectionColorHex String The hex color of selected text background.
highlightColorHex String The hex color of the highlighted text background (find, replace, etc.).
metaHBackgroundColorHex String The hex color of the metadata horizontal top and bottom bars background.
metaHFocusBackgroundColorHex String The hex color of the metadata horizontal top bar background when the panel has focus.
metaHForegroundColorHex String The hex color of the metadata horizontal top and bottom bars foreground.
metaVBackgroundColorHex String The hex color of the metadata vertical left and right gutters background (line numbers and line wrapping markers).
metaVForegroundColorHex String The hex color of the metadata vertical left and right gutters foreground (line numbers and line wrapping markers).
commandPromptColorHex String The hex color of the command prompts (example "Gemini>").
filePermissionsColorHex String The hex color of the file permissions in the navigator.
fileEditedIndicatorColorHex String The hex color of the file edited indicator in the panel list.
folderNameColorHex String The hex color of folder names in the navigator.
fileNameColorHex String The hex color of file names in the navigator.
specialPanelNameColorHex String The hex color of special panel names in the panel list.

Gemini link icon

Settings for the recommended but optional integration with Gemini API Generative AI.

Setting Type Description
secretKey String API key you acquired from Google. Keep this key private and secure. More info.
model String Gemini model you want to use. Settings below depend on Gemini 4 or greater. More info.
thinkingLevel String Thinking level for the model. Supported values: "unspecified", "minimal", "low", "medium", "high". Higher thinking levels allow the model to generate more internal reasoning tokens, which are billed at the model's output token rate.
timeoutSeconds Number Timeout for Gemini requests in seconds.
maximumHistory Number Each conversational turn with the model results in at least two history messages: a query from you and a response from the model. There may be more messages during a turn when tools are called for file reading, file writing, or web page fetches. These messages are saved in history and provided as context to the model in each new query. If this history is unbounded, you can exceed token limits for the model, or significantly increase cost for the session. Set this value to the maximum number of messages that should be saved in history. We recommend values in the range 20-40. Lower values reduce cost but limit conversation context. Higher values increase cost but enhance conversation context.
maximumToolHistory Number The maximum number of conversational turns to preserve tool payloads. Instead of deleting older tool responses (which breaks conversation structure), the bulky content of tool responses is replaced with a placeholder once they age past this limit in the history array. This drastically reduces token consumption for large payloads, like reading a file. Set to 0 to clear all tool payloads on every new turn. Set to a negative number to disable this feature.
systemInstructions String System instructions provided as a preamble to every prompt. The model has access to the editor tools list_open_files, read_file, and write_file for open files in the editor. This uses free-form XML, which is not required, but does improve reliability slightly. All user queries are wrapped in <user_input>...</user_input> by the application.

Code Colors link icon

Syntax highlighting hex colors for Tree-sitter captures.

Setting Type Description
keyword String Hex color for language keywords.
function String Hex color for function and method names.
type String Hex color for data types and classes.
string String Hex color for string and character literals.
number String Hex color for numeric literals.
comment String Hex color for line and block comments.
operator String Hex color for operators.
variable String Hex color for variables and parameters.
constant String Hex color for constants and built-in values.
property String Hex color for struct fields and object properties.
punctuation String Hex color for brackets, delimiters, and punctuation.
tag String Hex color for HTML/XML tags.
attribute String Hex color for HTML/XML attributes.

Code link icon

Advanced language-specific settings for code editing. These settings are only applied when a file suffix matches one of the listed suffixes. Syntax highlighting and automatic indentation use the Tree-sitter queries in config\treesitter\<name>\highlights.scm and indents.scm.

Setting Type Description
name String The name of the language (e.g., "go"), matching the folder name under config\treesitter\.
suffixes List Collection List of string suffixes that identify files for this language.
postSaveCommand String After a file is successfully saved, the optional postSaveCommand is executed with {file} replaced with the absolute path to the saved file.
lineComment String The syntax used for line comments (e.g., "// ").
blockCommentStart String The syntax used to start block comments (e.g., "/* ").
blockCommentFinish String The syntax used to finish block comments (e.g., " */").
indentationUnit String The string representing one unit of indentation (e.g., "\t" or " ").

SSH Hosts link icon

Advanced remote SSH host configurations. The editor uses the system's native OpenSSH client (ssh.exe) to maintain a persistent connection for reading and writing files and executing remote commands (such as git or p4).

  1. Verify ssh.exe in a Windows terminal first: Before configuring the editor, verify that you can connect to your remote machine from PowerShell or Command Prompt using ssh <username>@<hostname>. Connecting once in a terminal records the server's host fingerprint in C:\Users\<you>\.ssh\known_hosts and confirms the exact connection parameters to use.
  2. Configure the host under sshHosts: Add an entry under sshHosts matching the connection parameters you verified. If everything is already defined in C:\Users\<you>\.ssh\config, you only need to set name and hostname and leave the other fields empty.
  3. Open remote files and folders in the editor: Add ssh://<name>/<remote-path> to navigatorFavorites and select it from the navigator, or enter ssh://<name>/<remote-path> directly when opening a file or folder.
Setting Type Description
name String Required. A unique short identifier for this connection profile. This is the host name used in editor paths like ssh://work/home/jdoe/project.
hostname String Required. The remote machine's domain name, IP address, or a Host alias defined in your local OpenSSH config file (C:\Users\<you>\.ssh\config).
username String Optional. The remote login username (passed as -l <username> to ssh.exe). Leave empty to use the username from .ssh\config or your current Windows username.
port Number Optional. The remote SSH port number (passed as -p <port> to ssh.exe). Set to 0 or omit to use the default port (22) or the port from .ssh\config.
identityFile String Optional. Path to a private key file or hardware security key stub file (passed as -i <path> to ssh.exe). Leave empty to let ssh.exe use keys from ssh-agent, .ssh\config, or default key locations.
sshPath String Optional. Path to a custom ssh.exe executable. Leave empty to use the default ssh executable on your system PATH.
sshArguments String Optional. Extra command-line flags passed directly to ssh.exe (for example, jump hosts, agent forwarding, keep-alive options, or -v for verbose diagnostic logs).
showConsole Boolean Optional (default false). Controls whether the persistent ssh.exe process opens a visible Windows console window (true) or runs hidden in the background (false). Leave set to false when using SSH keys without a passphrase, keys unlocked in ssh-agent, or hardware security keys (FIDO2/U2F). Set to true when ssh.exe must prompt for interactive text input in a console window (such as password login, passphrase-protected keys without ssh-agent, interactive 2FA/OTP prompts, or first-time host key confirmation).