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. |
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. |
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.
|
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. |
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 " "). |
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).
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.
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.
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).
|