daffy-cli

CLI for the Daffy Public API. Search nonprofits, make donations, check balances, send gifts, and more — straight from the terminal.

Install

npm install -g daffy-cli

Or run directly with npx daffy-cli <command>.

Authentication

Get your API key at https://www.daffy.org/settings/developers, then pick one:

# Option A: auth command (recommended)
daffy-cli auth

# Option B: pass the key directly
daffy-cli auth <your-key>

# Option C: credentials file
mkdir -p ~/.daffy && echo 'DAFFY_API_KEY=your-key' > ~/.daffy/credentials

# Option D: environment variable (overrides credentials file)
export DAFFY_API_KEY="your-key"

Commands

Authentication

daffy-cli auth                        # Interactive: prompts for API key
daffy-cli auth <key>                  # Save API key directly

Account

daffy-cli me                          # Your profile
daffy-cli user <username>             # Look up a user
daffy-cli balance                     # Your fund balance
daffy-cli causes                      # Your selected causes

Non-Profits

daffy-cli search "khan academy"       # Search by name
daffy-cli search --cause 1            # Filter by cause ID
daffy-cli search "schools" --page 2   # Paginate results
daffy-cli nonprofit 261544963         # Details by EIN

Donations

daffy-cli donations                   # List your donations
daffy-cli donations --page 2          # Page through results
daffy-cli donate --ein 261544963 --amount 25
daffy-cli donate --ein 261544963 --amount 25 --note "Keep it up"
daffy-cli cancel 12345                # Cancel a pending donation

Contributions

daffy-cli contributions               # List your contributions
daffy-cli contributions --page 3

Gifts

daffy-cli gifts                       # List your gifts
daffy-cli gift <code>                 # Gift details by code
daffy-cli gift create --name "Alex" --amount 25

Options

| Flag | Description | |---|---| | --help, -h | Show usage | | --json | Raw JSON output (works with every command) | | --yes, -y | Skip confirmation prompts (donate, cancel, gift create) | | --page N | Page number for paginated commands |

JSON output

Append --json to any command for machine-readable output:

daffy-cli balance --json
daffy-cli search "khan academy" --json | jq '.items[].name'
daffy-cli donations --json --page 2