cardpointers

# CardPointers CLI

Query your CardPointers wallet — cards, offers, recommendations — from the terminal.

## Setup

- **Config:** `~/.cardpointers/config` (JWT token, auto-created on login)
- **Requires:** `curl`, `jq`, `bash`
- **Auth:** Run `cardpointers login` to authenticate (email/password or browser-based Apple/Google/passkey)

## Commands

### recommend — Best card for a purchase

```bash
cardpointers recommend groceries
cardpointers recommend "gas stations"
cardpointers recommend --merchant amazon
cardpointers recommend -m "whole foods" --amount 150
cardpointers recommend gas -p all        # best gas card across all profiles
```

### cards — List wallet cards

```bash
cardpointers cards                       # approved cards (default)
cardpointers cards --status all          # all statuses
cardpointers cards --bank chase          # filter by bank
cardpointers cards -b amex -s all -l 5  # combine filters + limit
```

### offers — List and filter offers

```bash
cardpointers offers                          # active offers
cardpointers offers -s redeemed              # redeemed offers
cardpointers offers --expiring               # expiring within 7 days
cardpointers offers -e 14                    # expiring within 14 days
cardpointers offers --bank amex              # filter by bank
cardpointers offers --card "gold"            # filter by card name
cardpointers offers --category dining        # filter by category
cardpointers offers --type personal          # personal offers only
cardpointers offers --favorite               # favorited offers only
cardpointers offers --sort value --limit 10  # top 10 by value
```

### search — Search offers by keyword

```bash
cardpointers search "whole foods"
cardpointers search "streaming" --favorite
cardpointers search "gas" --limit 5
```

### profiles — List linked profiles

```bash
cardpointers profiles
```

### Utility

```bash
cardpointers status    # account info + connection test
cardpointers ping      # test MCP conn...