Grove

Agents make branches faster than your Git client can show them.

Hand a few agents their own worktrees and your Git client fills up with folders that look like strangers — each one a separate repository, each one opened by hand. Meanwhile the big repo you actually work in takes seconds to switch branches. Grove treats worktrees as part of the repository they belong to, and stays quick on long histories.

1. 1

   Bring your repositories

   Drop a folder in, or clone one from your hosting account. Clones run in the background while you keep working.

2. 2

   See what changed

   History with a lane graph, unpulled and unpushed commits side by side, and diffs with syntax coloring.

3. 3

   Shape it before it ships

   Stage hunks or single lines, squash a run of commits, or rebase interactively — every step undoable.

4. 4

   Send it for review

   Push, open a pull request with the description filled in from your commits, and follow the review in the same window.

Windows and tabs

Any number of windows, native tabs, and mouse back and forward across repositories and views.

Background fetch

Open repositories keep fetching while you work elsewhere — and after you close the window — so the unpulled count is already there when you look.

Git LFS, git-flow and SVN

LFS files are marked and pulled with every sync, git-flow runs natively, and git-svn clones fetch from and commit to Subversion.

Identities and signing

Named commit identities per repository, a signing setup you can test, and 1Password's SSH agent and signer when you use them.

Patches, snapshots and exports

Create and apply patches, save a snapshot of your changes without touching them, and export any commit, branch or tag as a ZIP.

A command line tool

Install `grove` from the app, then `grove .` opens the repository you're standing in, in a new tab.

1. v0.6.0

   Highlights

   • The commit message box now has corners that fit inside its card.
   • GroveKit, for apps that use it: - `ShellResult` has a public initializer, and `GitRunner`'s defaults are nonisolated, so runners outside GroveKit build without spelling them out. - `DiffParser.parse(_:)` and `DiffParser.fileDiffs(patch:nameStatus:)` are public, as are `DiffResult` and `FileDiff` initializers. - `diff(from:to:)` diffs two revisions. Breaking: it is a new `GitRepositoryProtocol` requirement, so other conformers add it. - `BlameViewModel.open(file:revision:)` blames a file at any ref. - `CommitGraphBuilder.append(_:)` adds a page of commits to the graph without rebuilding it. - Public `ListSelection.init()` and `focus`, `WorkingCopyViewModel.selectedPath`, `PendingHunkDiscard.action` and `RestackPlan.steps`; `PullRequestHost.headRef(number:)`'s default is nonisolated. - `RefName.isValid(_:)` validates ref names and `BranchTreeNode.build(_:)` nests branches into folders. Breaking: `ReflogViewModel.isValidBranchName(_:)` is now `RefName.isValid(_:)`. - `RefActionsViewModel` runs branch, tag, remote, submodule and worktree actions (checkout, rename, delete, merge, rebase, tracking, worktree removal) with undo records, so apps no longer rebuild them. - `GitRepository(path:runner:hosting:naming:)` takes a `GitNaming` for its scratch files, the restack plan's folder and the branch-parent config key; it defaults to `grovekit` names. Pass `GitNaming(name: "grove")` to share restacks and branch parents with Grove. - `ViewModelPreferences.store` and `keyPrefix` (default `grovekit.`) keep the view models' settings apart from an app's own. `HostingError` messages no longer mention Grove or its Settings. - Worktree files, renames and the Trash go through the runner: `WorktreeResolver.mainRepositoryPath(forWorktreeAt:runner:)` and `linkedWorktrees(ofRepositoryAt:runner:)`, `GitRunner.trashItem(at:)` and `watch(_:latency:isRelevant:onChange:)` (both with defaults), and `trashFiles(_:)`. Breaking: `trashFiles(_:)` is a new `GitRepositoryProtocol` requirement, and `moveFile(from:to:)` refuses to overwrite. - `RepositoryWatcher(path:runner:latency:onChange:)` watches a repository through its runner; a linked worktree watches its own git state and the shared refs, ignoring sibling worktrees. - An `onAction: GroveKitActionHandler?` hook on the view models reports each git action they run as a `GroveKitAction`, with whether it succeeded and no user data, for telemetry.
   • A window on a worktree now refreshes when its branches change outside Grove, and no longer refreshes for activity in the repository's other worktrees.
2. v0.5.1

   Highlights

   • Exporting a file from its history now saves the real content of Git LFS files instead of the LFS pointer.
3. v0.5.0

   Highlights

   • Get a notification when a workflow run finishes: turn on "Notify me when it finishes" when running a workflow, or pick "Notify When Finished" on a running run. Clicking the notification opens the run.
   • Run Workflow leaves an input empty when its default is `null` instead of filling in the text "null".
   • Click a stack in the sidebar to open it in the Stack tab; the stack on screen stays selected in the sidebar.
   • The Stack tab's title now opens a searchable stack switcher, like the repository switcher.