fleece-cli 0.4.0__tar.gz → 0.4.1__tar.gz

{fleece_cli-0.4.0 → fleece_cli-0.4.1}/.agents/skills/fleece/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: fleece
-description: "What credit card should I use for dining, travel, groceries, or gas?" — Fleece answers this with live data. Looks up rewards rates, annual fees, welcome bonuses, statement credits, and transfer partners for Chase, Amex, Citi, Capital One, Bilt, and all major US issuers. Compare cards side-by-side, find gaps in your wallet, estimate first-year ROI, get personalized card recommendations, and generate PointsYeah award flight and hotel search URLs. Install: `pip install fleece-cli`.
+description: Credit card research and redemption CLI. Looks up rewards rates, annual fees, welcome bonuses, statement credits, and transfer partners for Chase, Amex, Citi, Capital One, Bilt, and all major US issuers. Compare cards, analyze wallet gaps, estimate ROI, get recommendations, look up merchant category codes, and search award flights and hotels. Install with pip install fleece-cli.
+metadata:
+  author: chenyuan99
+  version: "1.5.0"
 ---
 
 # Fleece — Credit Card Research & Redemption
@@ -15,9 +18,39 @@ Use this skill when the user asks about:
 - **ROI / value**: "Is the Amex Platinum worth the $695 fee?", "First-year value of the Sapphire Preferred"
 - **Award redemptions**: "Find business class flights JFK to Tokyo", "Search hotels in Paris with points"
 - **Merchant lookup**: "What card should I use at Costco?", "Which card earns the most at gas stations?", "What MCC is a pharmacy?"
+- **Spending profile**: "Set up my profile", "Save my spending habits", "Remember I spend $600/month on dining"
 
 Live US credit card data via Brave Search. All commands output JSON for programmatic use.
 
+## Spending profile
+
+The user's spending profile is stored in `fleece.db` and automatically injected into `fleece wallet`, `fleece roi`, and `fleece recommend`. Set it up once and all research commands become personalised.
+
+```bash
+# Set profile fields (no API key needed)
+fleece profile set dining_monthly 600
+fleece profile set travel_monthly 300
+fleece profile set groceries_monthly 400
+fleece profile set annual_fee_tolerance 550
+fleece profile set home_airport JFK
+fleece profile set goal "business class to Tokyo 2027"
+fleece profile set points_programs "Amex MR, Chase UR"
+
+# View current profile
+fleece profile show --json
+
+# List all available fields
+fleece profile fields
+```
+
+Once set, spend values are pulled automatically:
+```bash
+# No need to pass --dining or --travel flags
+fleece roi "Amex Gold"
+fleece wallet
+fleece recommend "travel rewards"
+```
+
 ## MCC-enriched workflow
 
 The bundled MCC dataset (981 codes, offline) enables a precise end-to-end flow:

fleece_cli-0.4.1/.cursor/rules/fleece.mdc

@@ -0,0 +1,35 @@
+---
+description: Use Fleece CLI for any credit card, rewards, MCC, or travel redemption question
+globs: ["**/*.py", "**/*.md"]
+alwaysApply: true
+---
+
+# Fleece CLI
+
+Install: `pip install fleece-cli` · Docs: https://getfleece.io
+
+## Commands
+
+### Research (requires BRAVE_API_KEY)
+- `fleece card "<name>" --json` — fees, welcome offer, rates, credits, benefits
+- `fleece rates "<name>" --category <cat> --json` — earning rates
+- `fleece partners "<name>" --json` — transfer partners
+- `fleece credits "<name>" --json` — statement credits
+- `fleece news "<name>" --json` — recent changes
+- `fleece compare "<A>" "<B>" --json` — side-by-side comparison
+- `fleece wallet --json` — portfolio gaps (auto-loads saved cards)
+- `fleece roi "<name>" --json` — first-year ROI
+- `fleece recommend "<profile>" --json` — personalized recommendations
+
+### Offline (no API key)
+- `fleece mcc <code> --json` — merchant category lookup
+- `fleece mcc <code> --wallet --json` — best card for that merchant
+- `fleece flights <ORIGIN> <DEST> --date <YYYY-MM-DD> --json` — award flights
+- `fleece hotels "<location>" --checkin <date> --checkout <date> --json` — award hotels
+- `fleece profile show --json` — spending profile
+
+## Output format
+```json
+{ "command": "...", "result": "...", "ok": true, "error": null }
+```
+Always check `ok` before using `result`. On error, `ok` is `false` and `error` contains the message.

fleece_cli-0.4.1/.github/copilot-instructions.md

@@ -0,0 +1,28 @@
+# Fleece — Copilot Instructions
+
+This project includes the Fleece credit card research CLI (`pip install fleece-cli`). Use it for any credit card, rewards, or travel redemption question.
+
+## When to use Fleece CLI
+
+| User question | Command |
+|---|---|
+| Card details, fees, benefits | `fleece card "<name>" --json` |
+| Earning rates by category | `fleece rates "<name>" --category <cat> --json` |
+| Transfer partners | `fleece partners "<name>" --json` |
+| Statement credits | `fleece credits "<name>" --json` |
+| Recent card changes | `fleece news "<name>" --json` |
+| Compare two cards | `fleece compare "<A>" "<B>" --json` |
+| Portfolio / wallet gaps | `fleece wallet --json` |
+| First-year ROI | `fleece roi "<name>" --json` |
+| Card recommendations | `fleece recommend "<profile>" --json` |
+| Merchant category lookup | `fleece mcc <code> --wallet --json` |
+| Award flights | `fleece flights <ORIGIN> <DEST> --date <YYYY-MM-DD> --json` |
+| Award hotels | `fleece hotels "<location>" --checkin <date> --checkout <date> --json` |
+| User spending profile | `fleece profile show --json` |
+
+## Notes
+
+- `BRAVE_API_KEY` env var required for research commands; `mcc`, `flights`, `hotels`, `profile` work without it
+- All `--json` output: check `ok` field before using `result`
+- `fleece wallet` auto-loads saved cards from `fleece.db`
+- Full docs: https://getfleece.io

fleece_cli-0.4.1/.windsurfrules

@@ -0,0 +1,31 @@
+# Fleece CLI — Windsurf Rules
+
+Use the Fleece CLI (`pip install fleece-cli`) for any credit card research, rewards optimization, MCC lookup, or award travel question.
+
+## Install & setup
+```bash
+pip install fleece-cli
+export BRAVE_API_KEY=<key>   # for live research
+```
+
+## Command reference
+
+**Research** (BRAVE_API_KEY required):
+- `fleece card "<name>" --json` — full card report
+- `fleece rates "<name>" --json` — earning rates by category
+- `fleece partners "<name>" --json` — transfer partners
+- `fleece credits "<name>" --json` — statement credits
+- `fleece news "<name>" --json` — recent changes
+- `fleece compare "<A>" "<B>" --json` — side-by-side comparison
+- `fleece wallet --json` — portfolio analysis, gaps, next-card suggestions
+- `fleece roi "<name>" --json` — first-year ROI estimate
+- `fleece recommend "<profile>" --json` — personalized recommendations
+
+**Offline** (no API key needed):
+- `fleece mcc <code> --json` — merchant category lookup (981 codes)
+- `fleece mcc <code> --wallet --json` — best card in wallet for that MCC
+- `fleece flights <ORIGIN> <DEST> --date <YYYY-MM-DD> --json` — award flight URL
+- `fleece hotels "<location>" --checkin <date> --checkout <date> --json` — award hotel URL
+- `fleece profile show --json` — spending profile
+
+All commands return `{ "ok": true/false, "result": "...", "error": null }`. Check `ok` before using `result`.

{fleece_cli-0.4.0 → fleece_cli-0.4.1}/CLAUDE.md

@@ -6,9 +6,9 @@
 
 It has two surfaces:
 1. **Streamlit chatbot** (`fleece.py`) — conversational AI assistant backed by OpenAI
-2. **CLI** (`cli.py`) — 12 commands for card research, wallet analysis, MCC lookup, and award redemption
+2. **CLI** (`cli.py`) — 13 commands for card research, wallet analysis, MCC lookup, spending profile, and award redemption
 
-Published on PyPI as [`fleece-cli`](https://pypi.org/project/fleece-cli/) · current version **0.3.1**
+Published on PyPI as [`fleece-cli`](https://pypi.org/project/fleece-cli/) · current version **0.4.0**
 
 ---
 
@@ -43,17 +43,29 @@ Published on PyPI as [`fleece-cli`](https://pypi.org/project/fleece-cli/) · cur
 | `fleece roi "<name>"` | First-year ROI estimate by spend profile |
 | `fleece recommend "<profile>"` | Card recommendations for a spending profile |
 
-### Redemption (no API key needed — work fully offline)
+### Redemption & Profile (no API key needed — work fully offline)
 | Command | Description |
 |---|---|
 | `fleece mcc <code>` | Offline MCC code lookup (981 codes bundled). Add `--wallet` to cross-reference 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 show` | Display spending profile |
+| `fleece profile set <field> <value>` | Set a profile field |
+| `fleece profile unset <field>` | Clear a profile field |
+| `fleece profile fields` | List all 10 profile fields |
 
 All commands support `--json` for agent-friendly output and `-` to read arguments from stdin.
 
 ### BRAVE_API_KEY
-Optional at startup — checked only when a research command actually runs. `mcc`, `flights`, and `hotels` work with no key set.
+Optional at startup — checked only when a research command actually runs. `mcc`, `flights`, `hotels`, and `profile` work with no key set.
+
+### Spending Profile
+Stored in `fleece.db` (table: `profile`). Fields: `dining_monthly`, `groceries_monthly`, `travel_monthly`, `gas_monthly`, `other_monthly`, `annual_fee_tolerance`, `points_programs`, `home_airport`, `goal`, `preferences`.
+
+Once set, profile context is automatically injected into:
+- `fleece roi` — pulls spend values when flags not passed
+- `fleece wallet` — tailors gap analysis to the user's actual spend
+- `fleece recommend` — prepends profile context to the search query
 
 ---
 
@@ -63,27 +75,57 @@ Optional at startup — checked only when a research command actually runs. `mcc
 |---|---|
 | `cli.py` | Main CLI entry point (Typer app) |
 | `fleece.py` | Streamlit chatbot app |
-| `db.py` | SQLite helpers for card portfolio (`fleece.db`) |
+| `db.py` | SQLite helpers for card portfolio and spending profile (`fleece.db`) |
 | `pointsyeah.py` | PointsYeah URL generation (pure stdlib, merged from archived `pointsyeah-cli`) |
 | `mcc_codes.jsonl` | Bundled MCC dataset (981 codes, source: greggles/mcc-codes) |
 | `tools/brave_client.py` | Brave Search API client |
 | `tools/credit_card_tools.py` | LangChain tools for the chatbot |
 | `pyproject.toml` | Package config — hatchling build, `fleece` entry point |
-| `install.sh` | Installs Claude Code skills and/or agent skill |
+| `install.sh` | Installs skills for Claude Code, OpenClaw, Gemini CLI, Copilot, Cursor, Windsurf |
+| `SKILL.md` | Root-level skill file for `npx skills add chenyuan99/fleece` (skills.sh registry) |
+| `skills/fleece/SKILL.md` | skills.sh directory structure copy |
+| `GEMINI.md` | Gemini CLI project context |
+| `.github/copilot-instructions.md` | GitHub Copilot instructions |
+| `.cursor/rules/fleece.mdc` | Cursor IDE rule |
+| `.windsurfrules` | Windsurf rules |
 
 ---
 
 ## Agent Skills
 
+### Universal install (55+ agents) — recommended
+```bash
+npx skills add chenyuan99/fleece
+```
+Installs to Claude Code, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, Codex, Warp, Kiro, Continue, Junie, and more in one command. Requires a valid `SKILL.md` at `skills/fleece/SKILL.md` in the repo root (already present).
+
 ### Claude Code (`/.claude/skills/`)
-12 slash commands installed via `bash install.sh --claude`:
+13 slash commands installed via `bash install.sh --claude`:
 
 **Research:** `/fleece-card` `/fleece-rates` `/fleece-partners` `/fleece-credits` `/fleece-news` `/fleece-compare` `/fleece-wallet` `/fleece-roi` `/fleece-recommend`
 
 **Redemption:** `/fleece-mcc` `/fleece-flights` `/fleece-hotels`
 
+**Profile:** `/fleece-profile`
+
+### Platform-specific install flags
+| Flag | Platform | File installed |
+|---|---|---|
+| `--claude` | Claude Code | `.claude/skills/fleece-*.md` |
+| `--agents` | OpenClaw / Codex | `.agents/skills/fleece/SKILL.md` |
+| `--gemini` | Gemini CLI | `GEMINI.md` |
+| `--copilot` | GitHub Copilot | `.github/copilot-instructions.md` |
+| `--cursor` | Cursor | `.cursor/rules/fleece.mdc` |
+| `--windsurf` | Windsurf | `.windsurfrules` |
+| `--all` | All of the above | — |
+
 ### ClawHub / OpenClaw (`/.agents/skills/fleece/SKILL.md`)
-Published on ClawHub as `fleece@1.3.0`. Install via `clawhub install fleece` or `bash install.sh --agents`.
+Published on ClawHub as `fleece@1.6.0`. Install via `clawhub install fleece` or `bash install.sh --agents`.
+
+### skills.sh / Vercel Agent Skills Registry
+`SKILL.md` at repo root and `skills/fleece/SKILL.md` enable `npx skills add chenyuan99/fleece`. Installs to 55+ agents in one command.
+
+> **IMPORTANT:** The frontmatter `description` field must never contain embedded quotes — they silently break YAML parsing in both ClawHub's vector indexer and the skills.sh CLI. Always use plain unquoted text.
 
 ---
 

fleece_cli-0.4.1/GEMINI.md

@@ -0,0 +1,44 @@
+# Fleece — Credit Card Research CLI
+
+Fleece is a CLI for live US credit card research and award redemption. Use it whenever the user asks about credit cards, rewards, transfer partners, MCC codes, or award flights/hotels.
+
+## Install
+
+```bash
+pip install fleece-cli
+export BRAVE_API_KEY=<key>   # required for research commands
+```
+
+## When to invoke Fleece
+
+- "What are the benefits of [card]?" → `fleece card "<name>" --json`
+- "Which card earns most on [category]?" → `fleece rates "<name>" --category <cat> --json`
+- "What cards can I transfer Chase points to?" → `fleece partners "<name>" --json`
+- "What credits does [card] have?" → `fleece credits "<name>" --json`
+- "Compare [card A] vs [card B]" → `fleece compare "<A>" "<B>" --json`
+- "Analyze my wallet" → `fleece wallet --json`
+- "Is [card] worth it for me?" → `fleece roi "<name>" --json`
+- "What's the best card for my spending?" → `fleece recommend "<profile>" --json`
+- "What card should I use at [merchant]?" → `fleece mcc <code> --wallet --json`
+- "Find business class flights JFK to NRT" → `fleece flights JFK NRT --date <YYYY-MM-DD> --cabin business --open`
+- "Search hotels in Tokyo" → `fleece hotels "Tokyo" --checkin <date> --checkout <date> --open`
+- "What is my spending profile?" → `fleece profile show --json`
+
+## Key facts
+
+- All commands output JSON with `--json` — parse `result` field, check `ok` before using
+- `mcc`, `flights`, `hotels`, and `profile` work **offline** — no API key needed
+- `fleece wallet` auto-loads saved cards from `fleece.db` with no arguments
+- Spending profile auto-enriches `wallet`, `roi`, and `recommend` once set
+
+## Common MCCs
+
+| MCC | Category |
+|---|---|
+| 5411 | Grocery Stores |
+| 5812 | Restaurants |
+| 5541 | Gas Stations |
+| 4511 | Airlines |
+| 7011 | Hotels |
+| 4111 | Transit |
+| 5912 | Drugstores |

fleece_cli-0.4.1/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: fleece-cli
+Version: 0.4.1
+Summary: Credit card research and redemption CLI — live data via Brave Search, PointsYeah URL generation, designed for humans and AI agents.
+Author-email: Yuan Chen <cysbc1999@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai,brave-search,cli,credit-cards,finance
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.11
+Requires-Dist: langchain-core>=0.3.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: typer[all]>=0.12.0
+Description-Content-Type: text/markdown
+
+# Fleece — Credit Card Research & Redemption
+
+[![PyPI version](https://img.shields.io/pypi/v/fleece-cli?color=FFD100&label=fleece-cli)](https://pypi.org/project/fleece-cli/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/fleece-cli?color=FFD100)](https://pypi.org/project/fleece-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/fleece-cli?color=FFD100)](https://pypi.org/project/fleece-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-FFD100.svg)](https://github.com/chenyuan99/fleece/blob/main/LICENSE)
+[![Publish to PyPI](https://github.com/chenyuan99/fleece/actions/workflows/publish.yml/badge.svg)](https://github.com/chenyuan99/fleece/actions/workflows/publish.yml)
+[![ClawHub](https://img.shields.io/badge/ClawHub-fleece%401.5.0-FFD100)](https://clawhub.ai)
+[![Website](https://img.shields.io/website?url=https%3A%2F%2Fgetfleece.io&color=FFD100&label=getfleece.io)](https://getfleece.io/)
+
+> 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
+
+```bash
+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)
+
+```bash
+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:
+
+```bash
+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
+```bash
+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
+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
+```bash
+clawhub install fleece   # fleece@1.5.0
+```
+
+## Chatbot
+
+A Streamlit conversational interface is also included:
+
+```bash
+pip install -r requirements.txt
+OPENAI_API_KEY=<key> streamlit run fleece.py
+```
+
+## Development
+
+```bash
+git clone https://github.com/chenyuan99/fleece.git
+cd fleece
+pip install -e .
+export BRAVE_API_KEY=<your_key>
+fleece --help
+```
+
+### Running tests
+```bash
+pip install pytest
+pytest -q
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE)
+
+## Author
+
+[@chenyuan99](https://github.com/chenyuan99) · [getfleece.io](https://getfleece.io/)

fleece_cli-0.4.1/README.md

@@ -0,0 +1,136 @@
+# Fleece — Credit Card Research & Redemption
+
+[![PyPI version](https://img.shields.io/pypi/v/fleece-cli?color=FFD100&label=fleece-cli)](https://pypi.org/project/fleece-cli/)
+[![PyPI downloads](https://img.shields.io/pypi/dm/fleece-cli?color=FFD100)](https://pypi.org/project/fleece-cli/)
+[![Python](https://img.shields.io/pypi/pyversions/fleece-cli?color=FFD100)](https://pypi.org/project/fleece-cli/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-FFD100.svg)](https://github.com/chenyuan99/fleece/blob/main/LICENSE)
+[![Publish to PyPI](https://github.com/chenyuan99/fleece/actions/workflows/publish.yml/badge.svg)](https://github.com/chenyuan99/fleece/actions/workflows/publish.yml)
+[![ClawHub](https://img.shields.io/badge/ClawHub-fleece%401.5.0-FFD100)](https://clawhub.ai)
+[![Website](https://img.shields.io/website?url=https%3A%2F%2Fgetfleece.io&color=FFD100&label=getfleece.io)](https://getfleece.io/)
+
+> 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
+
+```bash
+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)
+
+```bash
+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:
+
+```bash
+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
+```bash
+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
+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
+```bash
+clawhub install fleece   # fleece@1.5.0
+```
+
+## Chatbot
+
+A Streamlit conversational interface is also included:
+
+```bash
+pip install -r requirements.txt
+OPENAI_API_KEY=<key> streamlit run fleece.py
+```
+
+## Development
+
+```bash
+git clone https://github.com/chenyuan99/fleece.git
+cd fleece
+pip install -e .
+export BRAVE_API_KEY=<your_key>
+fleece --help
+```
+
+### Running tests
+```bash
+pip install pytest
+pytest -q
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE)
+
+## Author
+
+[@chenyuan99](https://github.com/chenyuan99) · [getfleece.io](https://getfleece.io/)