CLI Reference

Usage

grove <command> [options]

Commands

grove start

Start the Grove server. By default, runs interactively in the foreground.

grove start

On startup, Grove will:

1. Check that all dependencies are installed (tmux, ttyd, Tailscale)
2. Offer to install any missing dependencies via Homebrew
3. Start the HTTP server
4. Set up a Tailscale Funnel for external access
5. Display the server URL and a QR code for mobile access

grove run <command>

Run a command in a tmux session with a web terminal accessible over HTTPS.

grove run claude

This will:

1. Create a new tmux session running the specified command in the current directory
2. Start a ttyd process serving the tmux session over HTTPS using Tailscale certificates
3. Print the terminal URL
4. Attach to the tmux session locally

When you detach or the command exits, the session and ttyd process are cleaned up automatically.

grove stop

Stop a background Grove server and kill all active sessions.

grove stop

Options

Examples

# Start server interactively
grove start

# Start server in background on custom port
grove start -b --port 4000

# Run Claude Code with mobile access
grove run claude

# Stop background server
grove stop