Files, Search & Git
Manage project files, preview media, search with ripgrep, stage, commit, branch, publish, resolve conflicts, and browse history.
The right column follows the active workspace. Its tabs are Files, Changes, Graph, and Search. Results and file tabs open in the center workspace canvas. All of them work on the project's own checkout, which every workspace of the project shares.
The workspace note has its own page: see Notes.
Files
Open Files to browse the project. The tree shows everything except .git; Git-ignored entries are dimmed, symlinks are shown, and a chain of single-child folders is joined into one row. If a very large folder is only partly listed, the tree says so.
- Toolbar: New file, New folder, Refresh files, Collapse all, and Filter files (filters by name).
- Context menu: New file, New folder, Refresh, Cut, Copy, Paste, Copy Path, Copy Relative Path, Reveal in File Manager, Rename, and Delete.
- Select several entries, drag them to move, and paste files copied in File Explorer.
- Delete asks first, then moves the entries to the Recycle Bin (Trash on macOS).
- The tree follows the active editor. Reveal active file in Files in the command palette selects the current file.
- Each row shows its Git status, and the tree keeps up while agents write many files.
Editor and previews
Select a file to open it in a workspace tab with syntax-aware editing. Cmd/Ctrl+S saves; a dirty indicator shows unsaved work. Close actions ask before discarding unsaved content. Binary or unsupported files are not treated as editable text.
Images, SVG, video, and audio open in a preview tab instead:
- images fit the pane, show at 1:1, or zoom;
- SVG renders as an image, with View source for the text;
- video and audio play with standard controls.
Press Cmd/Ctrl+F, or choose Find in file from the command palette, to open the active editor's find card. Toggle case sensitivity, whole-word matching, or regular expressions. Enter moves to the next match, Shift+Enter moves to the previous match, and Escape closes the card. Expand the replace row to replace the current match or all matches; replace is unavailable in a read-only editor. This search only scans the open file.
Right-click a file tab to close it, close other tabs, or close tabs to either side. Bulk close skips tabs with unsaved buffers. The same menu copies the absolute or workspace-relative path and reveals the file in the operating-system file manager.
Project search
Open Search and enter a query. Cordy runs the bundled ripgrep against the project and groups matches by file. Select a match to open the file at that line. For a quick search from the keyboard, type % in the command palette.
Options:
- Match case (off = smart case).
- Match whole word.
- Use regular expression.
- Files to include / exclude, entered as comma-separated glob patterns, such as
*.ts, src/**.
A search returns at most 2,000 matches. When it stops there, the summary starts with First, for example First 2,000 matches in 120 files; narrow the query or the file patterns to see the rest.
Use arrow keys to move through result rows and Enter to open the focused match.
Changes
Open Changes to see your working tree in sections: Merge Conflicts, Staged Changes, Changes, and Untracked Files. The toolbar shows the running +/− total and the number of changed files.
Per-file and bulk actions
- Select a file to open its diff. Per-file actions stage, unstage, or discard only that file; discard asks first because it rewrites the working file.
- In the diff, each hunk has its own buttons: + stages it and the revert arrow discards it in an unstaged diff, and − unstages it in a staged diff.
- A conflicted file's stage action is Mark resolved.
- Section actions: Unstage all (Staged Changes); Stage all and Discard all changes (Changes); Stage all untracked and Delete all untracked (Untracked Files). Discard and delete ask first.
- A list over 2,000 rows is truncated with a notice; stage and discard are unavailable for hidden rows, so narrow the working set or use Git in a terminal.
Diffs
- Inside a parsed diff, use the actions beside a hunk to stage, unstage, or discard that hunk.
- Long lines wrap by default. Turn wrapping off with Wrap lines in the diff header; the choice is remembered.
- Image diffs switch between Preview and Text.
- Empty, binary, or unparseable diffs show a message or the raw diff instead of hunk actions.
Commit
- Stage at least one file. The form header shows Commit · N staged.
- Enter a Commit message. Choose Add description for an optional description.
- Choose Commit, or press Cmd/Ctrl+Enter in the message field.
Commit is disabled while nothing is staged or the message is empty, and the reason is shown below the button. A half-written message stays with the workspace when you switch panels.
Branches and remotes
- The identity row shows the branch and its upstream, or no upstream.
- Switch branch opens a keyboard-driven picker (Search or create a branch…). Type a new name to create a branch. A branch that is checked out in another worktree shows where it is checked out and cannot be picked.
- Fetch, Pull, and Push use the repository's configured remotes and credentials, show how many commits you are behind or ahead, and report what happened, including why an operation failed.
- For a branch with no upstream, Publish Branch replaces Push, with a Publish to remote… picker for the remote.
- Before a Pull or a branch switch, Cordy lists any workspace on the project with unsaved files or running agents and asks you to confirm. Nothing is stashed or discarded: Git refuses to overwrite uncommitted changes, and open editors keep their unsaved text.
Commit graph
Open Graph to see the active branch history. Expand a commit to list changed files, then select a file to open that commit's diff. History loads in pages as you scroll; Refresh history reloads it. A new commit always appears.