Getting Started

Grove is a server and CLI for managing Git repositories and terminal sessions from a mobile device. Run Claude Code sessions on your dev machine, access them from anywhere.

Requirements

• Bun
• Tailscale with Funnel enabled
• ttyd
• tmux

Installation

Homebrew (recommended)

brew tap henrypldev/grove
brew install grove

From source

git clone https://github.com/henrypldev/grove.git
cd grove
bun install

Install dependencies

tmux and ttyd are required for terminal sessions:

brew install tmux ttyd

Tailscale is required for secure remote access:

brew install --cask tailscale

Quick Start

Start the server

grove start

This starts the Grove server interactively. It will check that all dependencies are installed, start the HTTP server, and set up a Tailscale Funnel for external access.

Run a command with mobile access

grove run claude

This launches Claude Code in a tmux session with a ttyd web terminal, accessible over HTTPS via your Tailscale hostname. Open the printed URL on your phone to interact with the session.

How it works

1. grove CLI starts the server and sets up a Tailscale Funnel for external HTTPS access
2. grove server exposes a REST API for managing repos, worktrees, and terminal sessions
3. Terminal sessions are tmux sessions served via ttyd over HTTPS
4. Grove mobile app (separate repo) connects to the server to create and manage sessions