Review Git Changes and Create Worktrees in Hermes Desktop
Hermes Desktop adds a visual review surface for sessions inside Git repositories. It can separate uncommitted changes, branch changes, and the agent's last-turn diff, then support staging, commits, pushes, pull requests, branches, and graphical worktree lanes.
Official Desktop documentation: Open the official guide
Worktree guide: Open the official guide
Review before acting
Toggle the review pane with Cmd/Ctrl+G. Confirm the repository, branch, and ahead/behind state before touching files. Choose the right diff scope:
- Uncommitted shows current working-tree changes.
- Branch shows the broader branch delta.
- Last turn isolates what the agent changed most recently.
Stage only the files that belong together. Reverting, committing, pushing, creating a pull request, and deleting a worktree directory are side effects; inspect the exact diff and obtain required approval before using them.
Create an isolated worktree with Cmd/Ctrl+Shift+B or New worktree from a project. Each worktree receives its own directory and branch lane. Removing a lane can hide it or delete the worktree directory; a force option can discard uncommitted work, so it is not a routine cleanup button.
Review checklist
- Confirm repository, branch, and worktree path.
- Refresh the pane and inspect ahead/behind status.
- Review Last turn, then the complete Uncommitted and Branch scopes.
- Stage explicit files; do not bundle unrelated changes.
- Run tests outside the diff viewer and read their real results.
- Review generated commit text before accepting it.
- Treat Commit & Push, Create PR, revert, and removal as approval-gated actions.
Common pitfalls
- Reviewing only Last turn. Earlier dirty changes can still enter a commit.
- Creating parallel agents in one checkout. Use separate worktrees when writers may overlap.
- Deleting a worktree with uncommitted work. Hide the lane or preserve a patch first.
- Equating a clean-looking diff with passing software. Run focused and broad verification after the final change.
Verification
In a disposable repository, make one harmless edit and confirm all three diff scopes behave as expected. Create a temporary worktree, verify its branch and directory are isolated, then remove it without force after confirming it is clean. Do not test push or PR creation against a real remote unless that side effect is explicitly authorized.
