The Utterly Voice Editor is a voice optimized text and code editor with AI integration. You can use it for editing plain text, editing code, editing Utterly Voice settings files, or interacting with generative AI. Generative AI can significantly reduce the amount of typing you need to perform, so AI has been integrated into the editor. However, this AI integration is optional, so you can use the editor without AI.
Many popular AI user interfaces are not keyboard-friendly, so they are difficult to optimize by voice. In addition, most text/code editors are either too complicated for non-programmers, or they have too many actions that require using the mouse. The Utterly Voice Editor aims to fix these problems for voice-only users.
This editor is not an IDE. The user interface takes a minimalist approach, similar to a terminal-based editor with no menus or buttons. The AI integration is designed for users who prefer micromanaging AI, rather than letting AI have full project/computer control. All AI file reads/writes are only applied to your open editor files and require your explicit review and approval using a voice driven change-by-change accept/reject process.
This page covers many of the basic commands, but you can see the details of all commands by saying "open help editor".
This editor is currently in beta testing, so please report any issues you discover or feature requests via one of the channels on the help page.
You can open the editor by saying "open utterly editor",
which is a command in the "windows" mode.
This will execute utterlyeditor.exe
found in the Utterly Voice application folder.
This command also activates the "editor" mode.
You can open multiple editor windows using this command.
To close the editor, say "close window" while the editor is active.
For voice-optimized editing of text in other applications, you can use the "basic" mode commands "start transfer editing" and "finish transfer editing" to copy text from a focused text box in another application, edit it in the Utterly Voice Editor, and transfer the edited text back when finished.
The editor has fixed major panels on the left and right side of the window. These major panels are used for editing content, browsing folders, viewing command output, and interacting with AI. There is also a minor panel at the bottom of the window, which is used for simple input prompts, confirmations, and status messages. You can use the commands "left panel" and "right panel" to move focus between these panels.
You can reload the current panel from disk by saying "reload panel", or close the current panel by saying "close panel".
The editor provides a file navigator used to find and manage folders and files on your local system and remote systems via SSH. This special panel type can display either a configurable list of favorite folders (Navigator Favorites) or the contents of an individual folder (Navigator Folder). You can only have one Navigator Favorites panel open, but you can have many Navigator Folder panels open.
To open the navigator, say "open navigator". This opens the special Navigator Favorites panel, which lets you browse the drives and folders on your computer as well as configured remote SSH folders. Notice the following heading and special item types that appear when relevant:
../:
This goes up a folder in the hierarchy.
In a Navigator Folder, you can mark one or more items by saying "mark item". This command also accepts an optional utterance argument for the number of items to mark. Marking items allows you to apply changes to many items.
You can manage items in a Navigator Folder by issuing voice commands like "rename item", "delete item", "copy item", "cut item", or "paste item". If you have not marked any items, these voice commands will apply to the single item at the cursor, otherwise they will only apply to the marked items. For the full list of commands, say "open help editor".
To open a folder or file, move the cursor to the line of the desired item, then say "submit". To open many folders or files, mark the items then say "submit".
Traditional text editors use tabs when opening many files, but this is not the most efficient approach when using voice. With the Utterly Voice Editor, you can open many files and folders, but only two major panels are displayed at once. To list all of your open files, folders, and special panels, say "list panels". This opens the special panel called Panel List. To display one of the open panels, move the cursor up (example: "go up three") or down (example: "go down five") to position it anywhere on the line that contains the desired panel name, then say "submit".
You can mark one or more panel items by saying "mark item". This command also accepts an optional utterance argument for the number of items to mark (example: "mark item five"). Marking items allows you to apply changes to many items.
You can manage items in the Panel List by issuing voice commands like "rename item", "delete item", "copy item", "cut item", or "close item". If you have not marked any items, these voice commands will apply to the single item at the cursor, otherwise they will only apply to the marked items. For the full list of commands, say "open help editor".
To open an item, move the cursor to the line of the desired item, then say "submit".
The easiest way to open a file is to use the Navigator Favorites panel, navigate to the target folder, move the cursor to the target item, then say "submit".
If you prefer to paste or type the complete path for a file or folder:
To open all text files recursively in the current navigator folder (or in the current file's parent folder), say "open files recursive".
From a Navigator Folder panel, you can also mark many items, then say "submit" to open all marked items.
Both local Windows paths and remote SSH paths formatted as
ssh://<name>/<remote-path> are supported when
sshHosts is configured in
Editor Settings.
Many editors have varying behavior when you press enter, shift+enter, or control+enter. Sometimes this behavior is context dependent. The Utterly Voice Editor simplifies this by always having the same meaning for enter and control+enter. The "enter" command presses the enter key, always inserts a newline character, and does not submit any input. The "submit" command presses control+enter, does not insert a newline character, and submits user input.
The Utterly Voice Editor displays line numbers and column numbers for every 10th column with alternating background striping to aid navigation. To jump to a particular line, say "line" followed by the line number you want. To jump to a particular column, say "column" followed by the column number you want. For example:
You can also jump directly before or after the next occurrence of a word by saying "jump before" or "jump after" followed by the word. For example, saying "jump after hello" would move the cursor after the next occurrence of the word "hello".
You can also use the default commands from the "basic" and "windows" modes. For example:
To reposition the view around the current cursor line without moving the cursor itself, say "cursor top", "cursor middle", or "cursor bottom".
If the cursor is positioned on a URL or on a line containing a URL, you can open it in your default browser by saying "open link".
Most Windows editors require holding the shift key in order to make a selection. This becomes inefficient when using your voice, because you have to release the shift before switching to another window, and you may lose your selection in that process. The Utterly Voice Editor uses specific commands for starting and stopping selection that do not involve holding the shift key. In order to avoid conflicting with default commands, the editor commands use the word "pick" instead of "select". To start selection, say "start picking". To finish selection, say "finish picking", "cut" or "copy".
You can select characters to the left or right of the cursor:
You can select words to the left or right of the cursor:
You can select one or more lines, starting from the line of the cursor:
Watch modify and copy text demo
The following basic cut, copy, and paste commands are available:
The following undo and redo commands are available:
Basic backspace and delete commands are available:
Forward and backward word deletion commands are available:
Line-level deletion, cutting, and copying commands are also available:
Additional text formatting and code editing commands are available:
fillColumn width.
In addition to the commands described in this section, most of the commands in the "advanced" mode also work for the editor.
When providing text for find or replace, you can include newline or tab characters by saying "enter" or "tab". The bottom panel that accepts this input only displays a single line, but it will display special characters for this input.
If you open a file or use the navigator to create a new file, then make changes to it,
you can save the file by saying "save file".
For configured code files, saving also runs any configured
postSaveCommand (such as gofmt for Go files).
If you want to save a file as a different name in the same folder (or in a different folder which you can type the path to), say "save as" then provide the new path and file name.
If you want to save a file in a different folder, and you do not want to type the path to the new file:
If you configure Google's Gemini for the editor, you can use it to have an AI chat, read and explain files, or update files. You need to get a Gemini API key and configure the editor to use it. You can use the model for free, but if you use it often, you should sign up for a pay-as-you-go option.
Note that Google may save prompts and responses for review and model training, so you should understand Google's privacy agreement before sending confidential information to Gemini.
config\editor.yaml
file in the Utterly Voice application directory.
gemini settings,
then secretKey within the Gemini settings.
Update the string value to contain your Gemini API key.
Keep this key private and secure;
if somebody acquires your key, you will be billed for their usage.
You can manage your keys later by visiting the Google AI Studio.
The special Gemini panel is used to interact with Gemini. You can open this panel by saying "open gemini".
If the Google Chrome Gemini personal assistant opens when you say "open gemini", you will need to configure this assistant to use a different or no keyboard shortcut. The assistant may set a Windows hotkey for Alt+G, which is active even when Chrome is not active. This is the same keyboard shortcut used by the Utterly Voice Editor to open the Gemini panel. Google seems to be making frequent changes to Gemini in Chrome. Check the Google instructions for changing the keyboard shortcut. You can also try finding the Chrome Gemini keyboard shortcut setting in Chrome Settings > AI Innovations.
To open a Gemini panel, say "open gemini". This opens a panel similar to a command line terminal. You can type input asking Gemini a question.
To have a chat with Gemini, just say your question, then say "submit". Gemini will respond, and you can provide the next input. For example, type "why is the sky blue?", followed by "submit".
Gemini maintains context through the conversation, so you can follow up with a question "how about the ocean?", and Gemini will explain why the ocean is blue. To clear the conversation history and start fresh, say "gemini reset".
Watch Gemini file reading and writing demo
The Utterly Voice Editor does not provide Gemini direct access
to arbitrary files on your computer.
Gemini can only list, read, and propose edits to files that you currently
have open in the editor using its built-in editor tools
(list_open_files, read_file, and
write_file).
When Gemini edits a file, it does not write directly to disk;
instead, the editor inserts difference markers into the open panel so you
can review and accept or reject each change before saving.
You can reference open files or code snippets when prompting Gemini in several ways:
list_open_files to see what files are
currently open in the editor, you can also simply ask Gemini to read or
edit an open file by name.
If Gemini modifies a file, it typically provides an overview of what has changed. You can switch to the modified file panel to review, accept, or reject the changes. For each change, the following markers are inserted in the panel content:
<<< OLD >>>:
marks the beginning of the old content that Gemini is replacing
<<< NEW >>>:
marks the beginning of the new content that Gemini is providing
<<< END >>>:
marks the end of this change
To review, accept, or reject changes:
Gemini can search the web and read webpages to answer questions. You just need to provide the URL or topic in your question. For example: "Explain the content at utterlyvoice.com".
Watch Gemini editing settings files demo
You can use Gemini for editing Utterly Voice settings files. To use Gemini for editing a settings file:
There are many customization settings for the editor. You can change font, font size, colors of various items, Gemini configuration, code formatting, SSH hosts, etc. See Editor Settings.
The following table lists the keyboard shortcuts available in the Utterly Voice Editor for hybrid hand/voice users. These may also be useful if you are creating custom commands for the editor.
| Shortcut | Action |
|---|---|
Control+1 |
Focus the left panel |
Control+2 |
Focus the right panel |
Control+Tab |
List all open panels |
Control+Return |
Submit input or open selected item |
Escape |
Cancel current prompt or multi-step action |
Control+K |
Open the navigator panel |
Control+O |
Open a file by path |
Control+D |
Open a folder by path in the navigator |
Control+Shift+O |
Open all text files in the current folder recursively |
Control+L |
Open URL at the cursor or on the current line |
Control+S |
Save the current file |
Control+Shift+S |
Save the current file as a new path |
Control+Shift+K |
Save the current file as using the navigator |
Control+R |
Reload the current panel from disk |
Control+W |
Close the current panel |
Control+Shift+W |
Close marked items or the item at the cursor in the panel list |
Control+Shift+C |
Copy marked items or the item at the cursor in the navigator |
Control+Shift+X |
Cut marked items or the item at the cursor in the navigator |
Control+Shift+V |
Paste copied or cut items into the navigator folder |
Control+Shift+R |
Rename the file or folder item at the cursor |
Control+Shift+D |
Delete marked items or the item at the cursor |
Control+G |
Go to a specific line and column |
Control+Left |
Move the cursor one word to the left |
Control+Right |
Move the cursor one word to the right |
Home |
Move the cursor to the start of the current line |
End |
Move the cursor to the end of the current line |
Control+Home |
Move the cursor to the start of the file |
Control+End |
Move the cursor to the end of the file |
PageUp |
Move the cursor one page up |
PageDown |
Move the cursor one page down |
Alt+T |
Scroll the cursor line to the top of the view |
Alt+M |
Scroll the cursor line to the middle of the view |
Alt+B |
Scroll the cursor line to the bottom of the view |
Control+M |
Toggle mark on item in navigator or panel list, or toggle text selection |
Control+, |
Start text selection |
Control+Shift+, |
Finish text selection |
Control+A |
Select all text in the panel |
Control+C |
Copy selected text |
Control+X |
Cut selected text |
Control+V |
Paste text from the clipboard |
Control+Backspace |
Delete the word to the left of the cursor |
Control+Delete |
Delete the word to the right of the cursor |
Control+Z |
Undo last edit |
Control+Y |
Redo last undone edit |
Control+Q |
Fill column (wrap selected text or current paragraph) |
Control+] |
Indent current line or selected lines |
Control+[ |
Dedent current line or selected lines |
Control+I |
Toggle automatic indentation on or off |
Control+/ |
Toggle comment on current line or selected lines |
Control+F |
Find text in the panel |
Control+H |
Find and replace text in the panel |
Control+N |
Jump to next find match or difference block |
Control+P |
Jump to previous find match or difference block |
Alt+Y |
Confirm current replacement or difference change |
Alt+N |
Skip current replacement or reject difference change |
Alt+A |
Confirm all replacements or difference changes |
Alt+C |
Run an external command |
Alt+G |
Open the Gemini panel |
Alt+F |
Queue Gemini access for the active file or marked panel list items |
Alt+Shift+F |
Queue Gemini access for all open files |
Alt+S |
Queue the selected snippet for the Gemini prompt |
Alt+X |
Clear Gemini conversation history |