Skip to main content

CLI Commands

Complete reference for all available Grove CLI commands.

Setup & Configuration​

grove setup​

First-time setup wizard. Guides you through creating an account and configuring your API key.

grove setup

Choose a path:

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

Saves configuration to ~/.grove/.env.

grove config show​

Display your current configuration.

grove config show

Output:

Configuration:
  API URL:     https://api.grove.city
  API Key:     sk_*****************************abc
  Network:     base
  Token:       USDC

grove config set <key> <value>​

Update a configuration value.

grove config set api_key sk_your_new_key_here
grove config set network base-sepolia
grove config set token USDC

Available keys:

  • api_key - Your Grove API key
  • api_url - API endpoint (default: https://api.grove.city)
  • network - Blockchain network (default: base)
  • token - Token symbol (default: USDC)

Tipping​

grove tip <destination> <amount>​

Send a tip to a creator.

Tip a domain:

grove tip olshansky.info 0.01

Tip a Twitter user:

grove tip @olshansky 0.50
grove tip https://twitter.com/olshansky 0.50

Tip a Substack user:

grove tip https://olshansky.substack.com 1.00

Tip a wallet address directly:

grove tip 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb 0.25

Options:

  • --yes, -y - Skip confirmation prompt
  • --json - Output JSON for scripting

Examples:

Skip confirmation:

grove tip olshansky.info 0.01 --yes

JSON output for scripts:

grove tip olshansky.info 0.01 --json

grove check <destination>​

Check if a destination is tippable (without sending a tip).

Check a domain:

grove check olshansky.info

Check a Twitter profile:

grove check @olshansky

Check a wallet address:

grove check 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb

Output:

✓ olshansky.info is tippable
  Receiver: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
  Method: llms.txt

Balance & History​

grove balance​

Check your account balance.

grove balance

Output:

Balance: 4.99 USDC on base

JSON output:

grove balance --json

grove history​

View your recent transactions.

grove history

Output:

Recent Transactions:
  2024-01-15  TIP    olshansky.info       -0.01 USDC  (4.99 USDC)
  2024-01-14  FUND   Credit Card          +5.00 USDC  (5.00 USDC)

Options:

  • --limit <n> - Show last N transactions (default: 10)
  • --json - Output JSON for scripting

Wallet Management (Agents)​

grove keygen​

Generate a new wallet for funding via x402 protocol.

Preview only (don't save):

grove keygen

Generate and save to ~/.grove/keyfile.txt:

grove keygen --save

Output:

Address:  0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb
Key:      0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890

⚠️  Save this private key securely. You'll need it to fund your account.
danger

Never share your private key. Anyone with access to it can control your wallet.

grove fund <amount>​

Fund your account via x402 protocol (requires wallet with USDC).

grove fund 5.00

Prerequisites:

  1. Generate a wallet: grove keygen --save
  2. Send USDC to the generated address
  3. Run grove fund to transfer USDC to your Grove account

What it does:

  • Reads your private key from ~/.grove/keyfile.txt
  • Signs an x402 payment authorization
  • Transfers USDC from your wallet to Grove
  • Credits your account balance

Utility​

grove update​

Update the CLI to the latest version.

grove update

What it does:

  • Downloads the latest install script
  • Re-runs installation (preserves your config)
  • Shows what changed

grove contact​

Send feedback or get help from the Grove team.

grove contact

Opens an interactive form where you can:

  • Report bugs
  • Request features
  • Ask questions
  • Share feedback

grove --help​

Show help for all commands.

grove --help

Show help for a specific command:

grove tip --help
grove config --help

Examples​

Check balance:

grove balance

Tip multiple creators:

grove tip olshansky.info 0.01 -y
grove tip @olshansky 0.05 -y
grove tip https://example.substack.com 0.10 -y

Review history:

grove history

Agent workflow — install + setup (choose Wallet + Crypto):

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

Tip programmatically with JSON output:

grove tip olshansky.info 0.01 --json
Manual keygen alternative

If you prefer to manage the wallet yourself:

Generate wallet:

grove keygen --save

Fund the address with USDC on Base, then self-fund:

grove fund 10.00

Tip:

grove tip olshansky.info 0.01 --json