Tools
Files and search
Browse the project in the Files panel, search and replace across files, and jump anywhere with the command palette.
Files panel
Press ⇧⌘E to open the Files panel: the project folder as a tree, next to Source Control.
- File-type icons cover 190+ languages and tools (Rust, TypeScript, Docker, Claude, …). Well-known folders such as
.github,node_modulesandsrc-tauriget a badge, and test files get a flask. - Git status colors file names and adds a letter; folders get a dot.
- Git-ignored files are dimmed, or hidden with the eye button.
files.show_ignoredsets how the panel starts. - Names in
files.exclude(by default.DS_Storeand.git) are never shown. It takes names or globs, like"*.log","build"or"src/**/*.snap". - Folders refresh on their own while the panel is open, so files your agents create show up.
To find a file by name, use the command palette (⌘P, below). Typing in the tree jumps to the next name that starts with what you typed.
Open files
Click a file to preview it, and double-click to keep it open. As in VS Code, a preview tab (in italics) is replaced by the next file you click. It becomes a regular tab once you click into it, edit it, or double-click its tab. To always keep tabs, turn off editor.preview_tabs.
Drag a file onto a terminal to type its path there.
Right-click a file or folder for:
- Open in
$EDITOR - Open changes
- Insert path in terminal
- Open terminal here
- Copy path
- Reveal in Finder
- New file, new folder
- Rename
- Move to Trash (agex asks first, unless you turn off
files.confirm_delete)
Keys
| Key | Action |
|---|---|
| ↑ ↓ | Move |
| ← → | Collapse or expand |
| ↵ | Open |
| Space | Open without leaving the tree |
| F2 | Rename |
| ⌘⌫ | Move to Trash |
| ⌥⌘C | Copy path |
| ⇧⌥⌘C | Copy relative path |
Search panel
Press ⇧⌘F to open the Search panel, modeled on VS Code's Search view. If you have text selected in an editor, it fills the search box.
agex searches every file in the project as you type, skipping Git-ignored files, as VS Code does. Results stream in grouped by file, with match counts and line numbers. Click a match to preview it, with the match selected and centered; double-click it, or press ↵, to keep the tab.
Three toggles change how text matches:
| Toggle | Key | Setting it starts with |
|---|---|---|
| Match case | ⌥⌘C | search.match_case |
| Whole word | ⌥⌘W | search.whole_word |
| Regular expression | ⌥⌘R | search.regex |
A regular expression that mentions \n matches across lines. Search stops after search.max_results matches (20,000 by default).
Include and exclude files
Click … (⇧⌘J) to show files to include and files to exclude. Each takes comma-separated globs such as *.ts, src/**, or just extensions (.ts, rs), in any case.
- A bare name matches a file or folder anywhere.
./namematches only at the project root.- Tab moves between the boxes.
search.include and search.exclude set what the boxes start with.
Replace
Press ⇧⌘H, or click the chevron, to show the replace box. Each match then shows struck out next to its replacement.
- Replace one match, or a whole file, from the hover buttons.
- Replace everything with Replace All (⌥⌘↵), after a confirmation.
- In regex mode,
$1and other groups work in the replacement. - AB keeps each match's case.
Keys and right-click
| Key | Action |
|---|---|
| ↓ | From a box, move into the results |
| ↑ ↓ | Move |
| ← → | Fold or unfold files |
| ↵ | Open |
| Space | Preview |
| ⌫ | Dismiss a result |
| ⌘C | Copy |
Right-click a result to copy its path, copy all results, or reveal it in Files or Finder.
Command palette
The command palette works like VS Code's, with three modes.
Go to file
⌘P searches the open project's files. Recently opened files come first; as you type, it fuzzy-matches every file, with matching recent files on top. It uses Git's file list, so ignored files are skipped.
- Type
name:42to open the file at line 42. - If the Files panel is open, the file is selected there too.
Open files
⌘E, or typing edt in ⌘P as in VS Code, lists the files and diffs open in the project, pane by pane in tab order. Unsaved and preview tabs are marked.
- Type to narrow the list.
- ↵ jumps to the tab.
- ⌘W, or the row's ×, closes the tab without leaving the list.
Commands
⇧⌘P, or typing > in ⌘P, runs commands from anywhere in the app, with their shortcuts shown. They cover panels and layout, new terminals, starting any detected agent, switching projects, opening the project in an editor, running the project's scripts, cloning a repository, keep awake and settings.
Recently used commands come first. Delete the > to go back to files.