grove

Workspace rail

The left-most column of the Grove window is the vault tree: your notes, folders, and web links, with each workspace as an expandable folder among them — plus your projects and a collapsible Archived section.

What a workspace row shows

  • The workspace name, with its color stripe. Color is yours to assign from a color wheel — use it to group related work at a glance; it's also the tint the diff view paints that workspace's changes in.
  • Expand the row and you're looking at the workspace's notes — plan, design docs, the setup log — because a workspace is a folder.
  • Workspaces have exactly two states: active and archived. The live "what's happening" signal lives on the chat pills, which tint when a turn finishes while you're elsewhere and badge open-comment counts. See Chats and terminals.

Notifications

When an agent needs you — a question, a finished turn — Grove fires an OS-level notification rather than accumulating badge counts in the rail. Focus follows you, not the other way around.

Hover card

Hovering a workspace opens a card with at-a-glance state and the most-used actions:

  • Branch name and a live +adds / −removes diff stat.
  • Icon actions: open terminal, show files, show changes, sync (rebase onto base).
  • A Create PR control — see GitHub.
  • A start a chat button per agent — Claude Code, Codex, or opencode.

Interactions

  • Click activates the workspace — the diff overlay in the editor follows the active workspace. A plain click doesn't auto-open a chat.
  • Right-click for the context menu: Rename, Change color…, Archive / Unarchive, Demote (delete worktree, keep the notes as a plain folder), Delete (remove worktree, branch, and folder).
  • Keyboard, on the focused row: Cmd+Backspace archives an active workspace (or deletes an archived one); Enter starts a rename.
  • Multi-select rows for bulk move, archive, or delete.
  • Drag moves notes and folders around the vault tree — and you can drag files in from Finder to import them.

Filtering

The rail's filter box searches workspaces and notes recursively, and understands #tags — type # to filter by tag.

Create and auto-rename

A new workspace starts life with a placeholder name and an unmaterialized worktree. The first time its agent finishes a turn, Grove derives a real title from your first prompt and renames the workspace — unless you've already named it yourself. Loose vault files and folders can be promoted to workspaces, and workspaces demoted back to plain folders, from the same menu.

Current limitations

  • No manual workspace reordering; rows follow vault order.
  • Rebase conflicts surface when you sync, not as a persistent row status.