agex
Docs menuFiles and search

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_modules and src-tauri get 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_ignored sets how the panel starts.
  • Names in files.exclude (by default .DS_Store and .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

KeyAction
↑ ↓Move
← →Collapse or expand
↵Open
SpaceOpen without leaving the tree
F2Rename
⌘⌫Move to Trash
⌥⌘CCopy path
⇧⌥⌘CCopy 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:

ToggleKeySetting it starts with
Match case⌥⌘Csearch.match_case
Whole word⌥⌘Wsearch.whole_word
Regular expression⌥⌘Rsearch.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.
  • ./name matches 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, $1 and other groups work in the replacement.
  • AB keeps each match's case.

Keys and right-click

KeyAction
↓From a box, move into the results
↑ ↓Move
← →Fold or unfold files
↵Open
SpacePreview
⌫Dismiss a result
⌘CCopy

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:42 to 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.