Staging & Committing
Stage files, write commit messages, and push changes from the built-in diff pane.
Stage files, write a commit message, and push changes from inside the diff pane.
Staging files
Section titled “Staging files”In commit view, each file has a checkbox. Check the files to include in the next commit. Only checked files are staged and committed.
Unchecked files stay as unstaged changes.
Batch selection
Section titled “Batch selection”Hold ⇧ Shift and click to select a range of files at once.
Each file group (Changes, Unversioned Files) has a header checkbox. Click it to select or deselect all files in that group. If some files are selected the checkbox shows an indeterminate state.
Add untracked files
Section titled “Add untracked files”Right-click any file in the diff file list and select Stage File to add it to the git staging area (git add). This works on any file, whether untracked, modified, or deleted.
To unstage a file, right-click a staged file and select Unstage File (git reset HEAD).
When multiple files are checked, right-clicking shows batch options: Stage N Files or Unstage N Files.
Writing a commit message
Section titled “Writing a commit message”The text area at the bottom of the diff pane is for the commit message.
Committing
Section titled “Committing”Two ways to commit:
- Click the Commit button
- Press
⌘ Cmd+Enter
Both commit the staged (checked) files with the current message.
Commit & Push
Section titled “Commit & Push”Click Commit & Push to commit and push to your remote in a single action.
Amend mode
Section titled “Amend mode”Toggle amend mode to modify your most recent commit. When enabled:
- The previous commit message is restored in the text area
- The files from that commit are pre-selected
Make changes, edit the message if needed, and commit again. Toggle amend mode off to return to a normal commit.
Per-worktree memory
Section titled “Per-worktree memory”Rollback changes
Section titled “Rollback changes”To discard your changes and restore a file to the last committed version:
- Right-click the file in the list
- Select Rollback Changes
A confirmation dialog appears before anything is discarded.
Delete files
Section titled “Delete files”To remove a file from disk:
- Right-click the file in the list
- Select Delete File
A confirmation dialog appears before the file is moved to the Trash.
Copy file path
Section titled “Copy file path”Right-click a file and select Copy File Path to copy its full path to the clipboard.
Keyboard shortcuts
Section titled “Keyboard shortcuts”These keyboard shortcuts work when the file list is focused:
| Action | Shortcut |
|---|---|
| Navigate files | Arrow Up / Arrow Down |
| Open selected file | Enter |
| Toggle checkbox on selected file | Space |
| Rollback selected file | ⌘ Cmd + Z |
| Delete selected file | ⌘ Cmd + Backspace |
| Add untracked file to VCS | ⇧ Shift + ⌘ Cmd + S |
This shortcut works when the commit message textarea is focused:
| Action | Shortcut |
|---|---|
| Commit staged files | ⌘ Cmd + Enter |