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.