Grove

AI Development, Start to Ship.

Grove

Write a spec, let AI code it, review together, merge with confidence. Each task gets its own Git worktree and tmux/Zellij session — isolated, organized, always ready to resume.

Works with: Claude Code · CodeX · Gemini · Copilot · Trae · Kimi · Qwen · OpenCode · any agent via MCP

Quick Start

Install:

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

macOS App: Download .dmg — drag to Applications, includes GUI + Web UI + TUI.

Run:

cd your-project
grove          # Resumes last mode (TUI on first run)
grove tui      # TUI
grove web      # Web UI (http://localhost:3001)
grove gui      # Desktop GUI (macOS)
grove mobile   # Remote access (phone/tablet via LAN)

Running grove without arguments launches the last mode you used. First time? It starts the TUI. After grove web --port 8080, the next grove reopens the web UI on port 8080.

Every AI Gets Its Own World

Each task lives in a fully isolated workspace — its own git branch, its own session, its own spec. Run multiple agents in parallel without conflicts.

Own Branch — Dedicated git worktree per task. Branches never collide.
Own Session — Each task in its own tmux or Zellij session. Context stays intact.
Own Spec — Write instructions before the agent starts. Clear intent, focused output.

Work With AI, Your Way

Two modes, one workspace. Chat interactively or let agents run autonomously in the terminal.

| | | |---|---| | Chat Mode | CLI Mode | | Chat — A familiar chat interface for every agent. Different agents, same experience. | CLI — The way coding agents were designed to run. Full terminal, native experience. |

Review Together. Ship With Confidence.

Comment on any line, discuss in threads, approve or reject — every merge is a conscious decision. Then merge in one step: rebase, merge, and clean up with no manual git gymnastics.

Code Review

Merge and Ship

Skills

Browse a library of skills, install with one click, and every agent gets smarter automatically.

Browse and install in one click
Global or project-level scope
Works with all agents via MCP

Three Interfaces

TUI — `grove tui`

Keyboard-first terminal interface. Create tasks, write specs, launch agents, and ship — all without leaving your terminal.

Grove TUI

| Key | Action | |-----|--------| | n | New task | | Enter | Open task in tmux/Zellij | | Space | Action menu | | j/k | Navigate | | Tab | Switch tabs | | / | Search | | p | Toggle preview panel | | t | Change theme | | ? | Help | | q | Quit |

Web UI — `grove web`

Full-featured web interface embedded in the binary — no separate frontend deployment. Two modes: Zen (single-project focus) and Blitz (cross-project task aggregation).

Grove Web

grove web                  # Start on port 3001
grove web --port 8080      # Custom port

Binds to localhost only — designed for desktop use on the same machine, no authentication required. To access Grove from other devices, use grove mobile instead.

GUI — `grove gui` (macOS)

Native desktop app powered by Tauri 2 WebView. Same frontend as Grove Web, runs in a native window.

Grove GUI

Included by default in macOS release binaries. For cargo install, enable with cargo install grove-rs --features gui.

And There's More

| Feature | | |---------|---| | AutoLink | Automatically symlink heavy dependencies across worktrees so every task is ready to run instantly. | | Flexible Layout | Drag, split, and resize panels. Build the workspace that fits your flow. | | Blitz View | All tasks, all projects, one view. Switch between agents instantly. | | Stay Notified | Get alerts when agents finish, need review, or hit errors. | | Builtin Editor | Edit files, browse the tree, and manage code — all inside Grove's web interface. | | Statistics | Track tasks shipped, agent activity, and project health at a glance. | | 11 Themes | Dracula, Nord, Gruvbox, Tokyo Night, Catppuccin, and more. Auto dark/light detection. |

Access Grove Remotely

Use grove mobile to access Grove from your phone, tablet, or any device on the network. Authentication uses HMAC-SHA256 signatures — the secret key never travels over the wire. Run Grove on a Mac Mini at home, then manage your tasks from anywhere — your laptop, phone, or tablet.

grove mobile                    # LAN IP, HMAC auth
grove mobile --tls              # + self-signed TLS
grove mobile --cert a.pem --key a.key  # + your own certificate
grove mobile --public           # bind 0.0.0.0 (all interfaces)
grove mobile --host 10.0.0.5    # bind specific IP

A QR code is printed in the terminal — scan it to connect instantly with the secret key embedded.

grove mobile (default) — Every request is signed with HMAC-SHA256. The secret key stays on your devices and is never sent over the network, so captured traffic cannot be used to forge new requests. On a trusted home or office network this is secure and frictionless. However, traffic content is unencrypted (HTTP), meaning someone on the same network could see the data in transit. For most private LANs this is a non-issue.

grove mobile --tls — Adds HTTPS encryption via a self-signed certificate. All traffic is encrypted — no one on the network can read or tamper with it, even on untrusted networks (coffee shops, shared Wi-Fi). The trade-off: your browser will show a certificate warning on first visit, and you'll need to manually trust it (especially painful on iOS). Use this when you don't fully trust the network.

grove mobile --cert cert.pem --key key.pem — Bring your own domain and CA-signed certificate for the best experience: full HTTPS encryption with no browser warnings. If you have a domain pointing to your machine (e.g. via Tailscale, Cloudflare Tunnel, or local DNS), this is the smoothest and most secure way to access Grove remotely.

Agent Hooks

Get notified when AI agents finish, need attention, or hit errors.

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

Built-in MCP server. AI agents can manage projects and tasks, read notes, reply to reviews, and complete tasks autonomously.

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

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

Management tools (only available when NOT in a Grove task):

| Tool | Description | |------|-------------| | grove_add_project_by_path | Register a Git project by local path (idempotent) | | grove_list_projects | List all registered projects | | grove_create_task | Create a new task/worktree under a project | | grove_list_tasks | List active tasks under a project |

Execution tools (only available inside a Grove task):

| 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 | Reply to review comments (supports batch) | | grove_add_comment | Create review comments on specific code locations | | grove_complete_task | Complete task: commit → rebase → merge → archive |

Install

Single binary with embedded web frontend. No runtime dependencies beyond Git and a terminal multiplexer.

Homebrew:

brew tap GarrickZ2/grove && brew install grove

Shell (auto-detect platform):

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

# Custom install path (default: /usr/local/bin)
INSTALL_DIR=~/.local/bin curl -sSL https://raw.githubusercontent.com/GarrickZ2/grove/master/install.sh | sh

macOS App:

Download the .dmg from GitHub Releases, open it, and drag Grove to Applications. Universal binary — runs natively on Apple Silicon and Intel Macs.

Cargo:

cargo install grove-rs                   # TUI + Web UI
cargo install grove-rs --features gui    # + native macOS GUI

From Source:

git clone https://github.com/GarrickZ2/grove.git
cd grove && cargo build --release
cp target/release/grove /usr/local/bin/

Requirements

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

License

MIT

Grove

Install / Use

README

Grove

Quick Start

Every AI Gets Its Own World

Work With AI, Your Way

Review Together. Ship With Confidence.

Skills

Three Interfaces

TUI — `grove tui`

Web UI — `grove web`

GUI — `grove gui` (macOS)

And There's More

Access Grove Remotely

Agent Hooks

MCP Server

Install

Requirements

License

Grove

Install / Use

README

Grove

Quick Start

Every AI Gets Its Own World

Work With AI, Your Way

Review Together. Ship With Confidence.

Skills

Three Interfaces

TUI — grove tui

Web UI — grove web

GUI — grove gui (macOS)

And There's More

Access Grove Remotely

Agent Hooks

MCP Server

Install

Requirements

License

TUI — `grove tui`

Web UI — `grove web`

GUI — `grove gui` (macOS)