pp-coffee-goat

name pp-coffee-goat description The third-wave coffee terminal — every elite roaster, every YouTube creator review, your brews, and the God cup. Trigger phrases: `did hoffmann review this bag`, `any new ethiopian naturals`, `the god cup`, `find a bean like the one I loved`, `show me my flavor wheel`, `what flavors do I actually like`, `recommend a bag for my friend`, `use coffee-goat`, `run coffee-goat`. author Justin Fu license Apache-2.0 argument-hint <command> [args] | install cli|mcp allowed-tools Read Bash metadata {"openclaw":{"requires":{"bins":"[Truncated]"},"install":["[Truncated]"]}} Coffee GOAT — Printing Press CLI Prerequisites: Install the CLI This skill drives the coffee-goat-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first: Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows: npx -y @mvanhorn/printing-press-library install coffee-goat --cli-only Verify: coffee-goat-pp-cli --version Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill. If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.5 or newer): go install github.com/mvanhorn/printing-press-library/library/food-and-dining/coffee-goat/cmd/coffee-goat-pp-cli@latest If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH . Do not proceed with skill commands until verification succeeds. When to Use This CLI Use coffee-goat when an agent needs to compare or recommend specialty coffee across many roasters at once, when answering 'what should I drink next' or 'what should I buy next' from a user's logged cellar, when finding YouTube creator coverage of a specific bag in seconds instead of rewatching a 20-minute video, when matching champion recipes to currently-buyable beans, when mapping a user's palate onto the SCA flavor wheel, when picking a gift bag for a friend whose palate profile is imported, when finding cafes near a location, or when diagnosing whether a user's recent low ratings are bean quality or equipment drift. Do NOT use it for ordering — coffee-goat is read-only across upstream sources. Do NOT use it to find which beans a cafe serves — no public no-auth source links cafes to beans. When Not to Use This CLI Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis. Unique Capabilities These capabilities aren't available in any other tool for this API. The God cup god-cup — Integrates your shelf, brew history, Coffee Review scores, Hoffmann/Hedrick coverage, and champion recipes to produce one brew-now pick and one buy-next pick. Pick this as the headline 'what should I do next' question; integrates every signal source into one answer. coffee-goat god-cup --method espresso --agent Cross-source corpus search — Search every elite specialty roaster's catalog at once — Ethiopian naturals across the curated shelf in one query. Pick this when an agent needs a cross-source, structured product query rather than visiting many storefronts. coffee-goat search "ethiopia natural" --in-stock --price-lt 2500 --agent watch — Saved search emits only new matches on each sync — silent when nothing changed, cron-safe. Pick this when a user wants to be alerted the moment a specific producer or origin appears anywhere. coffee-goat watch save bermudez "diego bermudez gesha" --agent twin — Given a bean you loved, find the closest current match across the curated shelf via origin/varietal/process/altitude/descriptor similarity. Pick this to replace a sold-out favorite without manually scanning every other roaster. coffee-goat twin sey-banko-gotiti --top 5 --agent compare — Side-by-side bean table with origin/process/altitude/$/oz/score deltas; works across roasters. Pick this when choosing between candidates from different roasters with structured deltas. coffee-goat compare sey-banko-gotiti glitch-yirgacheffe --agent producer — Track a producer or farm (Diego Bermudez, Wush Wush, El Paraiso) across every roaster sync — multi-year lineage view. Pick this to compare different roasters' interpretations of one producer or to track lot evolution. coffee-goat producer "Diego Bermudez" --min-roasters 3 --agent fx — Live ECB FX rates normalize $/oz across continents; curated shipping table adds ship-to landed cost. Pick this before ordering from JP/DK/UK/DE roasters to compare true landed cost. coffee-goat fx tim-wendelboe-finca-el-paraiso --target USD --to us-domestic --agent Personal-history analytics dial-in — Suggest grind/dose/yield/time for a new bean using your brew history of similar beans (origin/process/varietal/altitude clusters). Pick this to start with a confidence-banded recipe instead of burning beans on cold-start dial-ins. coffee-goat dial-in sey-banko-gotiti --method espresso --agent shelf — What's on your shelf today, sorted by freshness with per-method peak windows (espresso 8–21d, filter 5–28d). Pick this to answer 'what should I open next' with hard freshness rules. coffee-goat shelf --method v60 --agent whats-next — Joins shelf freshness × dial-in confidence × user palate signature to pick one bag from your shelf for tomorrow morning. Pick this when the household agent needs one deterministic 'brew this' answer at dawn. coffee-goat whats-next --method v60 --agent drift — Detect grinder/water/technique drift via fixed-effects OLS on rating-vs-day across multiple beans; partitions variance by method. Pick this when ratings slide across unrelated beans — the CLI tells you it's your hardware, not the coffee. coffee-goat drift --method espresso --agent refill-plan — Combines consumption rate from your brews + shelf depletion + cross-roaster twin similarity to recommend 3 replacement picks. Pick this to never run out of coffee and always restock toward your taste profile. coffee-goat refill-plan --agent blind-cup — Blind cupping session with hashed cup IDs; reveal at end and report Spearman correlation against Coffee Review's scores. Pick this to quantify how your palate maps to published scores over time. coffee-goat blind-cup --agent palate-map — Aggregate your 8+ rated brews into an origin/process/varietal weight signature, then rank current shelf and restock candidates by signature match. Pick this to see what flavor profile you actually prefer (vs what you claim), and rank everything by it. coffee-goat palate-map --agent bag-life — For one bag, plot daily ratings vs days-since-roast and call peak / decline / dead. Pick this to decide whether a struggling shot is the bag dying or your technique slipping. coffee-goat bag-life onyx-geometry --agent friend-pick — Recommend a bag for a friend whose palate profile you've imported — pick from your shelf or current market, ranked against their descriptor signature instead of yours. Pick this when an agent needs to recommend a gift bag or birthday-coffee pick that fits someone else's documented palate. coffee-goat friend-pick pick maya --from market --top 3 --agent flavor-wheel — Maps your brew ratings onto the official SCA Coffee Tasters' Flavor Wheel hierarchy (fruity → berry → blackberry, floral → tea-like → black tea, etc.) and shows which sections you actually prefer. Pick this when the user wants to get clearer on what flavor families they actually like vs claim to like, against the canonical specialty-coffee taxonomy. coffee-goat flavor-wheel --agent -- select preferred,avoided,sparse_coverage brews — Brew log (log/list/show/delete) and local cellar (cellar add/list/show/update/remove) — the input feed for every personal-history command. Pick this to start building the personal-history signal that powers dial-in, drift, palate-map, predict-rating, and whats-next. coffee-goat brews log --bean 3 --method v60 --dose-g 18 --yield-g 300 --time-s 180 --rating 8 budget — Dose-grams attribution (dose_g / bag_size_g × bag_price). YTD + projection range (linear + trailing-3-mo × 12). Pivot --by month|roaster|bag|method. --include-shipping uses fx's curated table. Pick this to answer 'am I overspending vs last quarter?' or 'which bag was actually expensive per-cup?' — money axis nothing else touches. coffee-goat budget --by bag --agent coffee-map — Country-primary coverage with tiered depth labels (unexplored/tasted/explored/deep). Synced corpus default; --world adds curated specialty origins. --fill suggests bags inline; coffee-map fill ranks across all gaps by CR score + process tiebreak. Pick this to discover gaps in your origin coverage ('you've never had a Burundi') and get a concrete bag to close each gap. coffee-goat coffee-map --fill --agent predict-rating — Predicts YOUR rating for a (bean, method) pair via K=5 nearest twins from your brew log. Subcommand split: predict-rating [bean] and predict-rating cellar write to predicted_ratings; predict-rating calibration is mcp:read-only and reports MAE+bias sliced by method/origin/process. Pick this before buying a new bag to estimate how you'll rate it, and run calibration periodically to see if the model over-predicts naturals or under-predicts darks. coffee-goat predict-rating sey/banko-gotiti --method v60 --agent cupping — Full 10-attribute SCA form, multi-cupper sessions (auto-creates palate_profiles), open default + --blind slot labels. 7 verbs: start/score/finalize/abandon/show/list/log. Finalize bridges cupper=self scores to the brews table as method='cupping'. Pick this to run a structured tasting (solo or multi-cupper, open or blind) and have the scores flow into drift/palate-map/predict-rating automatically. coffee-goat cupping start --name "Sat AM" --bean sey/banko-gotiti --bean april/ethiopia-natural Editorial signal creator-review — Find every Hoffmann or Hedrick clip that mentions a bean or roaster, with transcript excerpt and timestamp. Pick this when the user remembers Hoffmann or Hedrick talking about a bag and wants the exact clip in 30 seconds, not a 20-minute rewatch. coffee-goat creator-review sey-banko-gotiti --agent transcript-search — Local FTS5 search across all synced Hoffmann + Hedrick transcripts with timestamp + video link. Pick this when an agent needs the exact clip where a creator said X. coffee-goat transcript-search "flow profiling" --agent -- select results.video_title,results.timestamp,results.excerpt recipe-replay — Hardcoded library of 10 canonical V60 recipes (Hoffmann 2018/2023, Tetsu 4:6 light/dark, Lance Pulse, WBrC 2020-2024 champions) with structured 5-tuple + technique markdown. Pick this to bridge from theoretical champion routines to your specific bean — match scores by bean features, apply scales dose+water, --log pre-fills a brews row. coffee-goat recipe-replay apply hoffmann-ultimate-2023 sey/banko-gotiti --dose 18 -- log Command Reference products — Unified roaster product corpus synced from 24 specialty coffee roasters coffee-goat-pp-cli products — List synced roaster products with structured filters Finding the right command When you know what you want to do but not which command does it, ask the CLI directly: coffee-goat-pp-cli which "<capability in your own words>" which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query. Hand-written Extensions These commands are declared by the spec author and require separate hand-written wiring; the generator does not emit Cobra registration for them. They are listed here for discoverability and are intentionally outside ## Command Reference so the verify-skill unknown-command check does not treat them as generator-owned paths. coffee-goat-pp-cli search [query] [--in-stock] [--origin <s>] [--process <s>] [--price-lt <cents>] [--limit <N>] — Cross-roaster FTS5 search over the synced roaster_products corpus coffee-goat-pp-cli watch save <name> <query> — Save a cross-roaster query that emits only new matches on subsequent runs coffee-goat-pp-cli watch list — List saved watch queries with last-sync-anchor coffee-goat-pp-cli watch run [<name>] — Run a saved (or all) watch queries; emits only newly-arrived matching products coffee-goat-pp-cli twin <roaster-or-product-slug> [--top <N>] — Find the closest match to a bean across all roasters via attribute + descriptor similarity coffee-goat-pp-cli creator-review <bean-or-roaster-slug> — Lookup Hoffmann/Hedrick YouTube clips mentioning a bean or roaster (with transcript excerpts) coffee-goat-pp-cli flavor-wheel — Map your rated brews onto the official SCA Coffee Tasters' Flavor Wheel hierarchy coffee-goat-pp-cli friend-pick palate-export <name> --out <file> — Export a portable JSON palate profile derived from your brews + ratings + descriptors coffee-goat-pp-cli friend-pick palate-import <file> — Import a friend's palate profile into the local store coffee-goat-pp-cli friend-pick pick <name> [--from market|shelf] [--top <N>] — Recommend bags ranked against an imported friend's palate signature (not yours) coffee-goat-pp-cli god-cup [--method espresso|v60|aeropress|...] — Headline meta-recommendation: one brew pick from your shelf + one buy pick across the market, integrating shelf... coffee-goat-pp-cli brews log [--bean <id>] [--method <s>] [--dose-g <f>] [--yield-g <f>] [--time-s <i>] [--rating <0..10>] [--descriptors <csv>] — Record a brew. Required input for every personal-history command. coffee-goat-pp-cli brews list [--bean <id>] [--method <s>] [--limit <N>] [--since <rfc3339>] — List recent brews ordered by brewed_at descending coffee-goat-pp-cli brews show <id> / coffee-goat-pp-cli brews delete <id> — Per-brew detail and removal coffee-goat-pp-cli brews cellar add --roaster <s> --product <s> [--roast-date <date>] [--mass-g <g>] — Add a bag to the local cellar so brews can link to it coffee-goat-pp-cli brews cellar list/show/update/remove — Cellar inventory CRUD coffee-goat-pp-cli compare <bean> [<bean>...] — Side-by-side compare of two or more beans on origin/process/varietal/altitude/price + Coffee Review + your own brew rating coffee-goat-pp-cli producer [name] [--min-roasters <N>] [--in-stock] [--limit <N>] — Cross-roaster producer index over roaster_products.producer coffee-goat-pp-cli transcript-search <query> [--creator hoffmann|hedrick] [--limit <N>] — FTS5 over Hoffmann + Hedrick transcripts with approximate-timestamp video URLs coffee-goat-pp-cli shelf [--method <s>] — Per-method peak-freshness status (resting / peak / past-peak / stale) for every bag in the cellar coffee-goat-pp-cli dial-in <bean-id-or-roaster/product> --method <s> — Bayesian dial-in suggestion blending user brews with origin+process cluster averages coffee-goat-pp-cli whats-next --method <s> [--limit <N>] — Score every bag in the cellar; return top picks by freshness + dial-in confidence + palate fit coffee-goat-pp-cli drift [--method <s>] — OLS slope of rating vs days-since-roast per method coffee-goat-pp-cli bag-life <bean-id-or-roaster/product> — Per-bag rating curve over days-since-roast coffee-goat-pp-cli refill-plan [--lookback-days <N>] [--horizon-days <N>] [--twins-per-bag <N>] — Project depletion across the cellar and suggest twin replacements coffee-goat-pp-cli blind-cup — Spearman rank correlation of user brew ratings vs Coffee Review scores coffee-goat-pp-cli palate-map [--top <N>] — Top loved / avoided descriptor tokens + per-origin mean rating