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

Utterly Voice Editor (Beta)

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

Beta Testing link icon

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.

Start the Editor link icon

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.

Transfer Content link icon

Play Full Screen Video Watch transfer demo

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.

Panels link icon

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

Play Full Screen Video Watch file navigator demo

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:

  • Favorites: These are your favorite local or remote SSH folders, which you can configure in the editor settings for quick access to folders you use frequently.
  • Utterly Voice application folder: This is displayed so you can easily navigate to your Utterly Voice settings files.
  • Drives: Each drive connected to your computer will be listed.
  • New Folder: Select this item to create a new folder in the current folder. When prompted, provide the folder name, then say "submit".
  • New File: Select this item to create a new file in the current folder. When prompted, provide the file name, then say "submit".
  • ../: 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".

Panel List link icon

Play Full Screen Video Watch panel list demo

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

Open a File link icon

Play Full Screen Video Watch file opening demo

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:

  • Say "open file", paste or type the full file path, then say "submit".
  • To open a folder directly by path, say "open folder", paste or type the folder path, then say "submit".

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.

Enter Versus Submit link icon

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.

Moving the Cursor link icon

Play Full Screen Video Watch cursor movement demo

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:

  • "line one fifty"
  • "column thirty five"
  • "line ten column twenty"

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:

  • "go up ten"
  • "go down three"
  • "go right seven"
  • "go left six"
  • "go home"
  • "control home"
  • "go end"
  • "control end"
  • "go left word three"
  • "go right word four"

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

Select Text link icon

Play Full Screen Video Watch text selection demo

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:

  • "pick left three"
  • "pick right five"

You can select words to the left or right of the cursor:

  • "pick left word three"
  • "pick right word five"

You can select one or more lines, starting from the line of the cursor:

  • "pick line"
  • "pick line five"

Modify and Copy Text link icon

Play Full Screen Video Watch modify and copy text demo

The following basic cut, copy, and paste commands are available:

  • "cut"
  • "copy"
  • "paste"

The following undo and redo commands are available:

  • "scratch"
  • "redo"

Basic backspace and delete commands are available:

  • "backspace"
  • "delete"
  • "backspace three"
  • "delete seven"

Forward and backward word deletion commands are available:

  • "clear left word"
  • "clear right word"
  • "clear left word six"
  • "clear right word five"

Line-level deletion, cutting, and copying commands are also available:

  • "remove line"
  • "cut line"
  • "copy line"
  • "remove left"
  • "remove right"

Additional text formatting and code editing commands are available:

  • "fill column": Wraps the selected text, or the current paragraph if nothing is selected, so lines do not exceed the configured fillColumn width.
  • "offset" and "offset left": Indents or dedents the current line or selected lines (accepts an optional number argument for the amount of indentation).
  • "toggle indentation": Toggles automatic indentation on and off for configured code languages.
  • "toggle comment": Toggles line or block comments on the current line or selected lines for configured code languages.

In addition to the commands described in this section, most of the commands in the "advanced" mode also work for the editor.

Find and Replace link icon

Play Full Screen Video Watch find and replace demo

To find text in a document:
  • "find"
  • say the text
  • "submit"
  • "next" to proceed to the next match
  • "previous" to go back to the previous match
  • "cancel command" to stop finding
  • "finish picking" to unselect the final match
To replace text in a document:
  • "replace"
  • say the text you want to replace
  • "submit"
  • say the replacement text
  • "submit"
  • "confirm" to accept a replacement and proceed to the next match
  • "skip" to skip over the current replacement
  • "confirm all" to accept all replacements
  • "cancel command" to stop replacing

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.

Save a File link icon

Play Full Screen Video Watch file saving demo

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:

  • "save navigate"
  • navigate to the desired folder for the new file
  • position the cursor at New File
  • "submit"
  • provide the file name
  • "submit"

Configure Gemini (Optional) link icon

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.

  1. Follow these steps to get an API key from Google. State that you are an individual developer (not an organization). Set up billing for improved model performance.
  2. Open the config\editor.yaml file in the Utterly Voice application directory.
  3. Scroll down and find the 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.
  4. Save the file.
  5. Close and reopen the editor.

You can manage your keys later by visiting the Google AI Studio.

Gemini Panel link icon

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.

Gemini Chats link icon

Play Full Screen Video Watch Gemini chats demo

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

Gemini File Reading and Writing link icon

Play Full Screen Video Watch Gemini file reading and writing demo

Play Full Screen Video Watch longer coding 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:

  • "gemini access": Queues an instruction for Gemini to access the current file panel, or marked file items (or the file item at the cursor) in the Panel List. This instruction is pasted into the prompt the next time you say "open gemini".
  • "gemini access all": Queues an instruction for Gemini to access all open file panels. This instruction is pasted into the prompt the next time you say "open gemini".
  • "gemini snippet": Queues an instruction for Gemini to read the current text selection. This instruction is pasted into the prompt the next time you say "open gemini".
  • Ask directly in the Gemini panel: Because Gemini can call 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:

  • "next" to jump to the next change
  • "previous" to jump to the previous change
  • "confirm" to accept a change and proceed to the next
  • "confirm three" to accept the next three changes
  • "confirm all" to accept all changes
  • "skip" to reject a change and proceed to the next
  • "skip five" to reject the next five changes
  • "reload panel" to reject all changes and reload the file from disk
  • "save file" to save the changes to disk

Gemini URL Context link icon

Play Full Screen Video Watch Gemini URL context demo

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

Gemini For Editing Utterly Voice Settings Files link icon

Play Full Screen Video Watch Gemini editing settings files demo

You can use Gemini for editing Utterly Voice settings files. To use Gemini for editing a settings file:

  • Open the settings file you want to edit in the editor.
  • Say "gemini access".
  • Say "open gemini".
  • Instruct Gemini on how to modify the file. For example, "add a file save command".
  • Say "submit".

Customize the Editor link icon

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.

Keyboard Shortcuts link icon

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