> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snack.money/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Overview

> Command-line tool for sending USDC payments

The **Snack Money CLI** is a command-line tool for sending USDC payments to users on **X (Twitter)**, **Farcaster**, **GitHub**, **Email**, and **Web** using the x402 protocol.

## Key Features

* **No wallet addresses needed** - Send to social usernames directly
* **Multi-chain support** - Works on Base and Solana networks
* **Batch payments** - Send to multiple users at once
* **AI agent mode** - Use natural language for payments
* **Simple installation** - No setup required with npx

## Supported Platforms

Send USDC payments to users on these platforms:

| Platform        | Formats                                                        | Example                   |
| --------------- | -------------------------------------------------------------- | ------------------------- |
| **X (Twitter)** | `x/username`<br />`x.com/username`<br />`twitter.com/username` | `x/aeyakovenko`           |
| **Farcaster**   | `farcaster/username`<br />`farcaster.xyz/username`             | `farcaster/toly`          |
| **GitHub**      | `github/username`<br />`github.com/username`                   | `github/octocat`          |
| **Email**       | `email/address`                                                | `email/mesut@snack.money` |
| **Web**         | `web/domain`                                                   | `web/snack.money`         |

## Supported Networks

* **Base** - EVM-compatible chain (requires `EVM_PRIVATE_KEY`)
* **Solana** - SVM chain (requires `SVM_PRIVATE_KEY`)

The CLI automatically detects which network to use based on your configured private key.

## Available Commands

### `send` - Single Payment

Send USDC to a single user:

```bash theme={null}
npx snackmoney send x/aeyakovenko 1¢
npx snackmoney send farcaster/toly $0.5
npx snackmoney send github/octocat 0.01
npx snackmoney send email/mesut@snack.money $0.25
npx snackmoney send web/snack.money 0.5
```

[Learn more →](/cli/send)

### `batch-send` - Batch Payments

Send to multiple users at once:

```bash theme={null}
npx snackmoney batch-send x/user1:1¢,user2:2¢,user3:3¢
npx snackmoney batch-send ./payments.json
```

[Learn more →](/cli/batch-send)

### `ai-agent` - AI-Powered Payments

Use natural language to describe payments:

```bash theme={null}
npx snackmoney ai-agent --prompt "Send 1 USDC to @toly on Farcaster"
```

[Learn more →](/cli/ai-agent)

## Amount Formats

The CLI supports flexible amount formats:

* **Cents**: `1¢`, `50¢`, `99¢`
* **Dollars**: `$0.01`, `$0.5`, `$1`
* **Decimal**: `0.01`, `0.5`, `1`

All amounts are processed as USDC.

## Quick Start

Get started in 3 steps:

1. **Set your private key**:
   ```bash theme={null}
   export EVM_PRIVATE_KEY="your_private_key"  # For Base
   # OR
   export SVM_PRIVATE_KEY="your_private_key"  # For Solana
   ```

2. **Run a payment**:
   ```bash theme={null}
   npx snackmoney send x/username 0.01
   ```

3. **Check the receipt**:
   The CLI returns a receipt URL to view your payment.

[See detailed quick start guide →](/cli/quick-start)

## Installation Options

Choose your preferred installation method:

### npx (Recommended)

No installation required:

```bash theme={null}
npx snackmoney --help
```

### npm Global

Install globally:

```bash theme={null}
npm install -g snackmoney
snackmoney --help
```

### Homebrew

For macOS/Linux:

```bash theme={null}
brew tap snack-money/tap
brew install snackmoney
```

[See all installation options →](/cli/installation)

## Why Use the CLI?

* **Quick testing** - Test the API without writing code
* **Scripting** - Automate payments in shell scripts
* **Batch operations** - Process multiple payments efficiently
* **No dependencies** - Works standalone with npx
* **Developer-friendly** - Simple, intuitive commands

## Next Steps

* [Installation Guide](/cli/installation) - Install the CLI
* [Quick Start](/cli/quick-start) - Send your first payment
* [Commands Reference](/cli/send) - Detailed command documentation
* [View on GitHub](https://github.com/snack-money/snackmoney-cli) - Source code and examples