Find, search, and commands

Omeruta has separate tools for finding a file, finding text inside files, and running an application action:

• Use Quick Open when you know a file name or want a recent file.
• Type > in Quick Open when you want to run an available low-risk action.
• Use Global Search when you know text inside a file.
• Use Command Lens when you want the broader command list.

File-name and content queries search the active workspace. Quick Open's empty state instead reflects recent-file history.

Open a recent file or search by file name

Open Quick Open in either of these ways:

• Select Search files in the top bar.
• Press Command-P on macOS or Ctrl-P on Windows.

With an empty search field, Quick Open shows up to ten recently opened files. Start typing to search file names in the active workspace. The search ignores letter case and matches text anywhere in the name; it does not search the file's contents. Each result also shows its path relative to the workspace so you can distinguish files with the same name.

Use the up and down arrow keys to select a result, then press Enter to open it. You can also select a result with the pointer. Hold Command on macOS or Ctrl on Windows while selecting a result to open it in a new tab. Press Escape to close Quick Open without opening anything.

Run a command from Quick Open

Quick Open changes from file mode to command mode when the query begins with >.

1. Open Quick Open.
2. Type > followed by the action you want, such as >settings.
3. Use the arrow keys to select a result.
4. Press Enter, or select the result, to run it.

The list contains up to twenty actions that Omeruta currently classifies as low risk and available in the current context. A result shows the action name, its command ID, and its category. The available results can change with the current workspace, open file, or selection.

Running an action closes Quick Open and executes the action immediately. This mode does not add a second confirmation step, so check the selected action before pressing Enter.

Search for text inside files

Press Command-Shift-F on macOS or Ctrl-Shift-F on Windows to open Global Search, then type the exact text you want to find.

Global Search reads text content in the active workspace. It is case-insensitive by default; select Aa to require matching uppercase and lowercase letters. The search uses literal text, not regular expressions or an AI similarity search. File names alone are not matched here, and files that cannot be read as text are skipped. Saved transcript text that exists in workspace files is included.

Results are grouped by file. Each match shows its line number, a line preview, and highlighted matching text. Use the arrow keys to move between matches and press Enter to open the selected file. You can also select a match with the pointer; hold Command on macOS or Ctrl on Windows while selecting it to open the file in a new tab.

Global Search returns at most ten matches from one file and one hundred matches in total. Refine the query if the result summary reaches either limit. Press Escape or select Close search to close the window.

Understand the Command Island

The top-bar Search files control is the Command Island in its idle state. Selecting it opens Quick Open.

While supported work is active, the same surface can replace Search files with the current activity and its status. Select the activity to see the details and actions that it provides. If Open Quick Open appears in those details, use it to return to file and command search. The Command Island does not perform a separate content search.

Use Command Lens

Press Command-K on macOS or Ctrl-K on Windows to open Command Lens. It searches the wider application command catalog, including navigation, editor, project, system, AI, and utility actions.

1. Type part of an action name, command ID, or keyword.
2. Use the up and down arrow keys, or select a row, to choose an action.
3. Check the selected action's name and command ID. Some actions depend on an open workspace, an editor selection, or another current item.
4. Press Enter, double-click the row, or select Execute to run it.

Selecting a row once does not run it. Enter, a double-click, and Execute do run it immediately. The Preview area is reserved for dry-run or policy output when an action provides it; it is not an extra confirmation step. Select Cancel, press Escape, or select outside the window to close Command Lens without running an action.

Quick Open command mode is the shorter choice when you want only actions that are currently available and classified as low risk. Use Command Lens when you need the broader catalog, and review the selected command carefully before running it.

Shortcut summary

• Command-P / Ctrl-P: open Quick Open.
• Command-Shift-F / Ctrl-Shift-F: search inside workspace files.
• Command-K / Ctrl-K: open Command Lens.
• Up arrow / Down arrow: change the selected result or action.
• Enter: open the selected file or run the selected action.
• Escape: close the current search or command window.