Skip to main content

Installation

The Grove CLI is a command-line interface for sending tips, checking balances, and managing your Grove account from your terminal.

Quick Install​

curl -fsSL https://grove.city/install-cli.sh | bash

After installation, run the setup wizard:

grove setup

The setup wizard offers three paths:

OptionBest ForStepsHuman Needed?
1. Wallet + Crypto (recommended)Autonomous agentsCreates wallet, fund with USDC + ETH on Base, self-funds via x402Only for initial funding
2. Email + Credit CardHumans managing agentsSign up at app.grove.city, fund via card, paste API keyYes — signup + payment
3. I have an API keyExisting usersPaste JWT from teammate or app.grove.cityNo — already done

Requirements​

System requirements:

  • macOS, Linux, or Windows - Pre-built binaries available
  • curl - For downloading the installer

What you'll need (depends on path):

  1. Wallet + Crypto: USDC + ETH on Base to fund the generated wallet
  2. Email + Credit Card: Grove account at app.grove.city, credit card for funding
  3. API Key: An existing JWT from a teammate or app.grove.city
For AI Agents

Run grove setup and choose Wallet + Crypto for the fastest autonomous path — no credit card or browser needed. See the Agent Integration guide for details.

Supported Platforms​

PlatformSupport
macOS (Intel)✅ Supported
macOS (Apple Silicon)✅ Supported
Linux (Ubuntu, Debian)✅ Supported
Linux (Fedora, Arch, openSUSE)✅ Supported
Windows (WSL)✅ Supported
Windows (Native)✅ Supported

Installation Options​

Includes all commands for tipping, balance checks, and transaction history:

curl -fsSL https://grove.city/install-cli.sh | bash

What's included:

  • grove tip - Send tips to creators
  • grove check - Verify destinations are tippable
  • grove balance - Check your account balance
  • grove history - View transaction history
  • grove config - Manage configuration
  • grove contact - Send feedback

Disk space: ~10MB

Wallet (x402)​

Wallet features are included in the standard install. No additional flags needed.

Wallet commands:

  • grove keygen - Generate a wallet for funding
  • grove fund - Transfer USDC to your Grove account via x402

Preview Installation (Dry Run)​

See what will be installed without making changes:

curl -fsSL https://grove.city/install-cli.sh | bash -s -- --dry-run

This shows:

  • Files that will be downloaded
  • Dependencies that will be installed
  • Where the CLI will be installed (~/.grove)

Installation Steps​

The installer performs these steps automatically:

  1. Detect platform - Detects your OS and architecture
  2. Download binary - Downloads pre-built CLI for your platform
  3. Install to ~/.grove - Places the binary in your home directory
  4. Create symlink - Links grove to ~/.local/bin/grove
  5. Preserve config - Keeps your existing API keys and settings
info

The installer preserves your configuration files (.env, keyfile.txt, etc.) across updates, so you won't need to reconfigure after reinstalling.

Adding to PATH​

If you see a warning about PATH after installation:

For bash:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

For zsh:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

For fish:

fish_add_path $HOME/.local/bin

Verifying Installation​

Check that the CLI is installed correctly:

grove --version

Test basic functionality:

grove --help

First-Time Setup​

After installation, run the setup wizard:

grove setup

The wizard will:

  1. Ask you to choose a path: Wallet + Crypto, Email + Credit Card, or paste an API key
  2. Guide you through setup for the chosen path
  3. Save your configuration to ~/.grove/.env

Manual setup:

If you prefer to configure manually:

grove config set api_key sk_your_key_here

Updating​

Update to the latest version:

grove update

Or reinstall manually:

curl -fsSL https://grove.city/install-cli.sh | bash

Your configuration files are preserved during updates.

Uninstalling​

Remove the CLI completely:

rm -rf ~/.grove
rm ~/.local/bin/grove

Troubleshooting​

Permission Denied​

If you get permission errors:

chmod 700 ~/.grove
chmod 600 ~/.grove/.env

Command Not Found​

If grove command is not found after installation:

  1. Check if it's installed:

    ls -la ~/.local/bin/grove

  2. Add to PATH (see "Adding to PATH" section above)

  3. Restart your terminal

Next Steps​