Fleece — Credit Card Research & Redemption

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)

Offline (no API key needed)

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