CLI Commands — Fleece Credit Card Research

Global Options

--json, -j	Emit machine-readable JSON — compatible with AI agents and shell pipelines.
--api-key TEXT	Override the `BRAVE_API_KEY` environment variable for this invocation.
--no-dotenv	Skip loading a `.env` file from the current directory.

Most arguments accept - in place of a value to read from stdin — useful for shell pipelines and agent tool calls.

Research Commands — require BRAVE_API_KEY

fleece card requires api key

Full card report — annual fee, welcome offer, earning rates, statement credits, benefits, and strategy tips.

fleece card <name> [OPTIONS]

Argument / Option	Required	Description
<name>	required	Card name, e.g. `"Chase Sapphire Preferred"`. Pass `-` to read from stdin.

$ fleece card "Amex Gold"

American Express Gold Card

Annual fee: $250 | Welcome offer: 60,000 MR points ...

$ fleece card "Chase Sapphire Preferred" --json

{"command": "card", "query": "...", "result": "...", "ok": true}

fleece rates requires api key

Earning rates by spend category — points, miles, or cash back per dollar. Optionally narrow to a single category.

fleece rates <name> [--category TEXT] [OPTIONS]

Argument / Option	Required	Description
<name>	required	Card name. Pass `-` to read from stdin.
--category, -c	optional	Spending category to focus on, e.g. `dining`, `travel`, `groceries`.

$ fleece rates "Amex Gold" --category dining

Dining: 4x Membership Rewards at restaurants worldwide

US supermarkets: 4x MR (up to $25,000/yr) ...

fleece partners requires api key

Transfer partners — airline and hotel programs, transfer ratios, and how long transfers take.

fleece partners <name> [OPTIONS]

Argument / Option	Required	Description
<name>	required	Card name. Pass `-` to read from stdin.

$ fleece partners "Chase Sapphire Preferred"

Transfer partners (1:1): United MileagePlus, Hyatt,

Singapore KrisFlyer, Air France/KLM Flying Blue ...

fleece credits requires api key

Statement credits and perks — amounts, cadence (monthly/annual), and any enrollment requirements.

fleece credits <name> [OPTIONS]

Argument / Option	Required	Description
<name>	required	Card name. Pass `-` to read from stdin.

$ fleece credits "Amex Platinum"

$200 airline fee credit (annually, must select airline)

$200 hotel credit (Fine Hotels + Resorts bookings) ...

fleece news requires api key

Recent changes in the past month — fee increases, benefit cuts, new perks, or limited-time offers. Results are freshness-filtered to the past 30 days.

fleece news <name> [OPTIONS]

Argument / Option	Required	Description
<name>	required	Card name. Pass `-` to read from stdin.

$ fleece news "Chase Sapphire Reserve"

May 2026: Annual fee increases to $650. New $300 travel

credit now covers more categories ...

fleece compare requires api key

Side-by-side comparison of two cards across fees, rewards, welcome offers, credits, and transfer partners.

fleece compare <card-a> <card-b> [--aspects TEXT] [OPTIONS]

Argument / Option	Required	Description
<card-a>	required	First card name.
<card-b>	required	Second card name.
--aspects	optional	Comma-separated list of aspects to compare. Default: `fees,rewards,welcome_offer,credits,transfer_partners`.

$ fleece compare "Amex Gold" "Chase Sapphire Preferred"

## Amex Gold

Annual fee: $250 | 4x dining, 4x US supermarkets ...

## Chase Sapphire Preferred

Annual fee: $95 | 3x dining, 2x travel ...

fleece roi requires api key

First-year ROI estimate — welcome bonus value + projected annual earn + credits minus the annual fee. Spend values are auto-pulled from your saved profile when not passed as flags.

fleece roi <name> [--travel FLOAT] [--dining FLOAT] [--other FLOAT] [OPTIONS]

Argument / Option	Required	Description
<name>	required	Card name. Pass `-` to read from stdin.
--travel	optional	Monthly travel spend in dollars. Falls back to `travel_monthly` from your profile.
--dining	optional	Monthly dining spend in dollars. Falls back to `dining_monthly` from your profile.
--other	optional	Monthly other spend in dollars. Falls back to `other_monthly` from your profile.

$ fleece profile set dining_monthly 500

$ fleece roi "Amex Gold"

Annual spend — Dining: $6,000 | Travel: $0 | Other: $0

First-year value: ~$1,060 (after $250 annual fee)

$ fleece roi "Chase Sapphire Preferred" --travel 300 --dining 400

fleece recommend requires api key

Card recommendations matched to a free-text spending profile description. Automatically enriched with your saved profile and current wallet cards.

fleece recommend <profile> [--preferences TEXT] [OPTIONS]

Argument / Option	Required	Description
<profile>	required	Free-text spending description. Pass `-` to read from stdin.
--preferences, -p	optional	Extra constraints, e.g. `"no annual fee"` or `"prefer cash back"`.

$ fleece recommend "heavy diner, occasional traveler"

1. Amex Gold — 4x dining, $120 dining credit

2. Capital One Savor — 3x dining, no foreign tx fee ...

$ fleece recommend "groceries and gas" --preferences "no annual fee"

Wallet Commands — no API key required

fleece wallet requires api key

Portfolio analysis — fetches live earning-rate data for every card in your wallet and returns structured research for computing a category coverage map, overlaps, gaps, and next-card suggestions. Cards are read from the local database; add them first with fleece cards add.

fleece wallet [OPTIONS]

Argument / Option	Required	Description
--json, -j	optional	Returns structured JSON with per-card research, profile context, and an `analysis_prompt` field ready for an agent to synthesize.

$ fleece wallet

### Amex Gold

4x dining, 4x US supermarkets, 3x flights ...

### Chase Sapphire Preferred

3x dining, 2x travel, 1x other ...

Using the research above, compute a wallet analysis:

1. Category coverage map ...

$ fleece wallet --json

{"command": "wallet", "cards": [...], "research": {...}, "analysis_prompt": "...", "ok": true}

fleece cards list offline

List all cards saved in your profile with their annual fees.

fleece cards list [OPTIONS]

$ fleece cards list

1. Chase Sapphire Preferred (fee: $95)

2. Amex Gold (fee: $250)

fleece cards add offline

Add a card to your saved wallet. The card name is used by wallet, mcc --wallet, recommend, and roi.

fleece cards add <name> [--fee TEXT] [OPTIONS]

Argument / Option	Required	Description
<name>	required	Card name to add, e.g. `"Amex Gold"`.
--fee	optional	Annual fee string, e.g. `$95`. Defaults to `$0`.

$ fleece cards add "Chase Sapphire Preferred" --fee "$95"

Added "Chase Sapphire Preferred" to your profile. (1 card(s) total)

$ fleece cards add "Amex Gold" --fee "$250"

Added "Amex Gold" to your profile. (2 card(s) total)

fleece cards remove offline

Remove a card from your wallet. Partial name matching is supported — the command errors if the match is ambiguous.

fleece cards remove <name> [OPTIONS]

Argument / Option	Required	Description
<name>	required	Card name or partial name to remove.

$ fleece cards remove "Amex Gold"

Removed "Amex Gold" from your profile. (1 card(s) remaining)

$ fleece cards remove "sapphire"

Removed "Chase Sapphire Preferred" from your profile. (0 card(s) remaining)

Redemption Commands — no API key required

fleece mcc offline

Look up any of the 981 bundled Merchant Category Codes to find the spend category for a merchant. Add --wallet to cross-reference earning rates across your saved cards and pick the best one (requires API key in wallet mode).

fleece mcc <code> [--wallet] [OPTIONS]

Argument / Option	Required	Description
<code>	required	4-digit MCC code, e.g. `5812`.
--wallet, -w	optional	Cross-reference with saved wallet cards to find the best card to use. Requires `BRAVE_API_KEY`.

$ fleece mcc 5812

MCC 5812: Eating Places, Restaurants

$ fleece mcc 5812 --wallet

MCC 5812: Eating Places, Restaurants

Best card: Amex Gold (4x) › Chase Sapphire Preferred (3x)

$ fleece mcc 7832 --json

{"mcc": "7832", "category": "Motion Picture Theaters", "ok": true}

fleece flights offline

Generate a PointsYeah award flight search URL for a given route, date, and cabin class. Use --open to launch the URL directly in your browser.

fleece flights <origin> <destination> --date YYYY-MM-DD [OPTIONS]

Argument / Option	Required	Description
<origin>	required	Origin airport IATA code, e.g. `JFK`.
<destination>	required	Destination airport IATA code, e.g. `NRT`.
--date	required	Departure date in `YYYY-MM-DD` format.
--return	optional	Return date in `YYYY-MM-DD` format for round trips.
--adults	optional	Number of adult passengers. Default: `1`.
--cabin	optional	Cabin class: `economy`, `premium-economy`, `business`, `first`. Default: `economy`.
--open	optional	Open the generated URL in the default browser.

$ fleece flights JFK NRT --date 2026-06-01 --cabin business

https://pointsyeah.com/flights?...

$ fleece flights LAX LHR --date 2026-09-10 --return 2026-09-20 --cabin first --open

https://pointsyeah.com/flights?... (opening in browser)

fleece hotels offline

Generate a PointsYeah award hotel search URL for a given location and date range.

fleece hotels <location> --checkin YYYY-MM-DD --checkout YYYY-MM-DD [OPTIONS]

Argument / Option	Required	Description
<location>	required	City, area, or hotel keyword, e.g. `"Tokyo"`.
--checkin	required	Check-in date in `YYYY-MM-DD` format.
--checkout	required	Check-out date in `YYYY-MM-DD` format.
--guests	optional	Number of guests. Default: `1`.
--rooms	optional	Number of rooms. Default: `1`.
--open	optional	Open the generated URL in the default browser.

$ fleece hotels "Tokyo" --checkin 2026-06-01 --checkout 2026-06-07

https://pointsyeah.com/hotels?...

$ fleece hotels "Paris" --checkin 2026-08-10 --checkout 2026-08-15 --guests 2 --open

Profile Commands — no API key required

Your spending profile is stored locally in fleece.db. Once set, profile values are automatically injected into roi, recommend, and wallet to personalise results without repeating flags each time.

fleece profile show offline

Display your current spending profile.

fleece profile show [OPTIONS]

$ fleece profile show

Monthly dining spend 500

Monthly travel spend 300

Home airport JFK

Points programs Amex MR, Chase UR

fleece profile set offline

Set a single profile field. Run fleece profile fields to see all available field names.

fleece profile set <field> <value> [OPTIONS]

Argument / Option	Required	Description
<field>	required	Field name, e.g. `dining_monthly`.
<value>	required	Value to store.

$ fleece profile set dining_monthly 500

Profile updated: dining_monthly = 500

$ fleece profile set home_airport JFK

Profile updated: home_airport = JFK

$ fleece profile set goal "maximize dining and travel rewards"

fleece profile unset offline

Clear a single profile field.

fleece profile unset <field> [OPTIONS]

Argument / Option	Required	Description
<field>	required	Field name to clear.

$ fleece profile unset annual_fee_tolerance

Cleared: annual_fee_tolerance

fleece profile fields offline

List all 10 available profile fields and their descriptions.

fleece profile fields

$ fleece profile fields

dining_monthly Monthly dining spend ($)

groceries_monthly Monthly groceries spend ($)

travel_monthly Monthly travel spend ($)

gas_monthly Monthly gas spend ($)

other_monthly Monthly other spend ($)

annual_fee_tolerance Max annual fee you'll pay ($)

points_programs Preferred points programs

home_airport Home airport (IATA code)

goal Rewards goal (free-text)

preferences Other preferences (free-text)