Fleece — Credit Card Research & Redemption

PyPI version PyPI downloads Python License: MIT Publish to PyPI ClawHub Website

Find the best card for deal saviors.

Fleece is a free, open-source credit card research and award redemption toolkit. It provides live data via Brave Search — no stale training data. Every command outputs clean JSON, making it easy to plug into AI agent workflows.

Quick Start

pip install fleece-cli
export BRAVE_API_KEY=<your_key>   # optional — offline commands work without it

fleece card "Amex Gold"           # full card report
fleece wallet                     # portfolio analysis
fleece mcc 5812                   # MCC lookup (no API key needed)
fleece flights JFK NRT --date 2026-06-01 --cabin business --open

Install as an agent skill (55+ agents)

npx skills add chenyuan99/fleece

Works with Claude Code, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, Codex, Warp, Kiro, and more — all from one command.

CLI Commands

Research (requires BRAVE_API_KEY)

Command Description
fleece card "<name>" Fees, welcome offer, earning rates, credits, benefits
fleece rates "<name>" Earning rates by spend category
fleece partners "<name>" Transfer partners, ratios, and timing
fleece credits "<name>" Statement credits and perks
fleece news "<name>" Recent changes (past month)
fleece compare "<A>" "<B>" Side-by-side card comparison
fleece wallet Portfolio analysis — coverage, overlaps, gaps
fleece roi "<name>" First-year ROI estimate
fleece recommend "<profile>" Personalized card recommendations

Offline (no API key needed)

Command Description
fleece mcc <code> Look up a Merchant Category Code (981 codes bundled)
fleece mcc <code> --wallet Cross-reference MCC with your saved cards
fleece flights <ORIGIN> <DEST> --date <YYYY-MM-DD> PointsYeah award flight search URL
fleece hotels "<location>" --checkin <date> --checkout <date> PointsYeah award hotel search URL
fleece profile set <field> <value> Save your spending profile
fleece profile show View your profile

All commands support --json for agent-friendly output and - to read from stdin.

Spending Profile

Set your profile once — fleece wallet, fleece roi, and fleece recommend use it automatically:

fleece profile set dining_monthly 600
fleece profile set travel_monthly 300
fleece profile set home_airport JFK
fleece profile set goal "business class to Tokyo 2027"
fleece profile set annual_fee_tolerance 550

fleece roi "Amex Gold"      # spend values pulled from profile
fleece wallet               # gap analysis tailored to your spend

AI Agent Integration

Universal (55+ agents) — recommended

npx skills add chenyuan99/fleece

Installs to Claude Code, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, Codex, Warp, Kiro, Continue, and Junie in one command.

Platform-specific

bash install.sh --claude    # Claude Code slash commands
bash install.sh --agents    # OpenClaw / Codex SKILL.md
bash install.sh --gemini    # Gemini CLI (GEMINI.md)
bash install.sh --copilot   # GitHub Copilot
bash install.sh --cursor    # Cursor
bash install.sh --windsurf  # Windsurf
bash install.sh --all       # everything above

ClawHub Registry

clawhub install fleece   # fleece@1.5.0

Chatbot

A Streamlit conversational interface is also included:

pip install -r requirements.txt
OPENAI_API_KEY=<key> streamlit run fleece.py

Development

git clone https://github.com/chenyuan99/fleece.git
cd fleece
pip install -e .
export BRAVE_API_KEY=<your_key>
fleece --help

Running tests

pip install pytest
pytest -q

License

MIT — see LICENSE

Author

@chenyuan99 · getfleece.io

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for cysbc1999 from gravatar.com cysbc1999

Credits

Author: Yuan Chen

License

MIT License (MIT)

Requires

Python >=3.11

Tags

ai brave-search cli credit-cards finance

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fleece_cli-0.4.1.tar.gz (100.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fleece_cli-0.4.1-py3-none-any.whl (43.0 kB view details)

Uploaded Python 3

File details

Details for the file fleece_cli-0.4.1.tar.gz.

File metadata

  • Download URL: fleece_cli-0.4.1.tar.gz
  • Upload date:
  • Size: 100.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for fleece_cli-0.4.1.tar.gz
Algorithm Hash digest
SHA256 7291decf5caed2ef1539fd45056460fc3aeede63b17169ee8c02791f03332285
MD5 704a65ddb001f1ad36718d67aacb0626
BLAKE2b-256 84cbe1ce547ff648d1269847dd7955f0c17e4d6cd83523a5c6c03e2658e59644

See more details on using hashes here.

Provenance

The following attestation bundles were made for fleece_cli-0.4.1.tar.gz:

Publisher: publish.yml on chenyuan99/fleece

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file fleece_cli-0.4.1-py3-none-any.whl.

File metadata

  • Download URL: fleece_cli-0.4.1-py3-none-any.whl
  • Upload date:
  • Size: 43.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for fleece_cli-0.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 af978f7c15389ae1c32ce82f79937595b737d1b88e472976689b9b25b107256e
MD5 94bb8e5b53c287f751b912f2fdde1e78
BLAKE2b-256 918e7e519315ca6abef74782991f1f29a7926da195ab0f3301057bb9ca63e207

See more details on using hashes here.

Provenance

The following attestation bundles were made for fleece_cli-0.4.1-py3-none-any.whl:

Publisher: publish.yml on chenyuan99/fleece

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.4.1 This release

2 files

0.4.0

2 files

0.3.1

2 files

0.3.0

2 files

0.2.0

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page