grove-rs 0.4.1

A Kanban-style TUI for parallel AI coding. Manage Git worktrees as tasks, run multiple agents in isolated tmux sessions, get notified via hooks.
grove-rs-0.4.1 is not a library.

Grove

Run 10 AI agents. Zero context switching.

Crates.io Downloads Rust License Platform

Grove Screenshot

Manage multiple AI coding tasks in parallel. Each task gets its own Git worktree and tmux session—isolated, organized, always ready to resume.


The Problem

You're juggling Claude Code on feature A, Cursor fixing bug B, and reviewing PR C.

With traditional Git, this means:

  • Constant git stash / git stash pop gymnastics
  • Branch switching that kills your terminal state
  • "Wait, what was I working on?" moments
  • AI agents losing context mid-task

Your workflow shouldn't fight your tools.

The Solution

Grove gives each task its own isolated universe:

Task Isolation

  • Switch between tasks instantly — no stashing, no rebuilding
  • Resume exactly where you left off — terminal state preserved
  • Let AI agents run in parallel without stepping on each other

Features

Three Interfaces — TUI for keyboard warriors, Web UI for visual workflows, native GUI for macOS

Task Dashboard — See all tasks at a glance with live status

True Isolation — Each task = own branch + worktree + terminal

Session Persistence — Close Grove, reopen tomorrow, everything's still there

One-Key Actions — Create, switch, sync, merge, archive with single keystrokes

Agent Hooks — Get notified when AI finishes (sound + system notification)

MCP Server — Model Context Protocol integration for AI agents (Claude Code, etc.)

Preview Panel — Side panel with Git info, code review, and notes per task

8 Themes — Dracula, Nord, Gruvbox, Tokyo Night, Catppuccin, and more


Quick Start

Install:

curl -sSL https://raw.githubusercontent.com/GarrickZ2/grove/master/install.sh | sh
# or
cargo install grove-rs

Run TUI:

cd your-project && grove

Run Web UI:

grove web              # Open http://localhost:3001
grove web --port 8080  # Custom port

Run GUI (macOS):

grove gui              # Launch native desktop window
grove gui --port 8080  # Custom API port

Create your first task: Press n in TUI, or click "New Task" in Web/GUI.

Keyboard Shortcuts

Key Action
n New task
Enter Open task in tmux
Space Action menu
j/k Navigate
Tab Switch tabs
/ Search
t Change theme
? Help
q Quit

Grove Web

A full-featured web interface for managing Grove projects and tasks.

Dashboard — Repository overview with branch list, commit history, and quick stats

Projects — Manage multiple git repositories from one place

Tasks — Create, archive, recover, and delete tasks with visual workflows

Integrated Terminal — Full terminal access via WebSocket (xterm.js)

Git Operations — Branches, checkout, pull, push, fetch, stash — all from the browser

Code Review — View difit review status and comments inline

Activity Stats — Task activity timeline and file edit heatmap

grove web                  # Start server on port 3001
grove web --port 8080      # Custom port
grove web --host 0.0.0.0   # Expose to network

The web UI is embedded directly in the binary — no separate frontend deployment needed.

Grove GUI (macOS)

A native desktop application powered by Tauri 2 WebView. Shares the same frontend as Grove Web, but runs in a native window instead of a browser.

grove gui              # Launch desktop window
grove gui --port 8080  # Custom API port

Included by default in macOS release binaries (GitHub Releases / install.sh). For cargo install, enable with:

cargo install grove-rs --features gui

Agent Hooks

Let Grove watch your AI agents so you don't have to.

When Claude/Cursor/Copilot finishes a task, trigger notifications:

grove hooks notice    # Task completed
grove hooks warn      # Needs attention
grove hooks critical  # Something's wrong

Press h in Grove to configure sound and notification settings.

MCP Server

Grove provides a Model Context Protocol (MCP) server for AI agent integration.

Add to your Claude Code MCP config (~/.claude/config.json):

{
  "mcpServers": {
    "grove": {
      "command": "grove",
      "args": ["mcp"]
    }
  }
}

Available Tools:

Tool Description
grove_status Check if running inside a Grove task, get context
grove_read_notes Read user-provided task notes
grove_read_review Read code review comments with status
grove_reply_review Batch reply to review comments
grove_complete_task Complete task: commit → rebase → merge → archive

When inside a Grove task, the agent can read notes, respond to code review feedback, and complete the task with a single tool call.

Preview Panel

Press p to toggle the side panel showing details for the selected task:

  • Git — recent commits, diff stats, uncommitted changes
  • Review — code review comments from difit
  • Notes — user-provided context and requirements (editable with e)
  • Stats — file edit heatmap and activity timeline

Use j/k to scroll panel content, Left/Right to switch sub-tabs.


Requirements

  • Git 2.20+
  • tmux 3.0+
  • macOS 12+ or Linux

License

MIT