pp-reno-goat

name	pp-reno-goat
description	Search, compare, price-watch, model-enrich, and project-track renovation selections across 33 active sources plus 5 tracked stubs
author	H179922
license	Apache-2.0
argument-hint	<command> [args] | install cli|mcp
allowed-tools	Read Bash
metadata	{"openclaw":{"requires":{"bins":["reno-goat-pp-cli"]},"install":[{"kind":"go","bins":["reno-goat-pp-cli"],"module":"github.com/mvanhorn/printing-press-library/library/commerce/reno-goat/cmd/reno-goat-pp-cli"}]}}

Reno Goat — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the reno-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:

1. Install via the Printing Press installer:

   npx -y @mvanhorn/printing-press-library install reno-goat --cli-only
   

2. Verify: reno-goat-pp-cli --version
3. Ensure $GOPATH/bin (or $HOME/go/bin) is on $PATH.

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/commerce/reno-goat/cmd/reno-goat-pp-cli@latest

If --version reports "command not found" after install, the install step did not put the binary on $PATH. Do not proceed with skill commands until verification succeeds.

Search, compare, price-watch, model-enrich, and project-track homeowner-visible renovation selections across 33 active sources plus 5 tracked stubs. Reno Goat focuses on the middle ground between commodity builder supply and home decor: appliances, plumbing fixtures, bath showroom rows, electrical and lighting selections, HVAC equipment, flooring, hardware, materials, furniture, and decor. Standalone utilities provide Lowe's autocomplete and store locator. No API keys required.

Command Reference

brands — List brands available at a source and cross-reference brand availability across retailers. Shows which retailers carry a given brand and at what price points.

• reno-goat-pp-cli brands ferguson-brands — List brands available at Ferguson by searching with a brand filter. Returns brand facets from search results.
• reno-goat-pp-cli brands rejuvenation-brands — List brands available at Rejuvenation via Constructor.io brand facets.
• reno-goat-pp-cli brands westelm-brands — List brands available at West Elm via Constructor.io brand facets.

categories — Browse product category trees at a source. Currently supported for Rejuvenation via their catalog API.

• reno-goat-pp-cli categories — Browse the Rejuvenation product category tree. Returns subcategories, product counts, and navigation paths.

compare — Side-by-side product comparison across any sources. Fetches full details for each product URL and renders a normalized comparison table of price, specs, ratings, and availability.

• reno-goat-pp-cli compare <urls> — Compare 2+ products side-by-side.

deals — Find active promotions, sales, and eligible discounts. Queries promotion eligibility APIs for current deals.

• reno-goat-pp-cli deals — Check eligible promotions for a West Elm product or category.

delivery — Check delivery availability and options by postal code. Supported for West Elm and Rejuvenation via their delivery information APIs.

• reno-goat-pp-cli delivery rejuvenation-delivery — Check delivery availability and options from Rejuvenation by postal code.
• reno-goat-pp-cli delivery westelm-delivery — Check delivery availability and options from West Elm by postal code.

find-related — Find cross-sell and complementary products. Currently supported for Article via the CROSS_SELL APQ query.

• reno-goat-pp-cli find-related <product_url> — Find cross-sell/related products from Article via APQ CROSS_SELL query.

find-similar — Find similar products at the same retailer. Currently supported for Article via the SIMILAR_PRODUCTS APQ query.

• reno-goat-pp-cli find-similar <product_url> — Find similar products from Article via APQ SIMILAR_PRODUCTS query. Returns visually and categorically similar items.

product — Get full product details from any source. Resolves the source from the product URL and fetches complete product data including specs, images, variants, and pricing.

• reno-goat-pp-cli product article-product — Get full product details from Article via APQ PRODUCT query.
• reno-goat-pp-cli product ferguson-product — Get full product details from Ferguson via GraphQL ProductDetail query.
• reno-goat-pp-cli product rejuvenation-product — Get full product details from Rejuvenation.
• reno-goat-pp-cli product shopify-product — Get full product details from a Shopify DTC store via Storefront API. Resolves store from URL.
• reno-goat-pp-cli product westelm-product — Get full product details from West Elm.

product-search — Fan-out product search across active sources. Category-based routing sends queries to relevant sources. Returns normalized products with unified price, rating, and brand fields.

• reno-goat-pp-cli product-search all "<query>" --json — Search across all active sources with automatic category routing.
• reno-goat-pp-cli product-search all "<query>" --category plumbing --json — Search a category-specific routed source set.
• reno-goat-pp-cli product-search all "<query>" --room kitchen --json — Expand a room shortcut into relevant categories, then search those sources.
• reno-goat-pp-cli product-search article-search — Search products via Article APQ GraphQL. Uses SEARCH_PRODUCTS persisted query hash.
• reno-goat-pp-cli product-search ferguson-search — Search products via Ferguson GraphQL. Returns ProductSearchResult (count + products) or SearchRedirect.
• reno-goat-pp-cli product-search rejuvenation-search — Search products via Rejuvenation Constructor.io API. Same API shape as West Elm with different key.
• reno-goat-pp-cli product-search shopify-search — Search products across Shopify DTC stores via Storefront API GraphQL.
• reno-goat-pp-cli product-search westelm-search — Search products via West Elm Constructor.io API. Returns faceted results with product data, prices, and images.

model-intel — Compound lookup for installed-selection decisions. Use this when the user needs model/SKU candidates, current prices, spec/install documents, or predictable model-page probes.

• reno-goat-pp-cli model-intel "36 induction cooktop" --json — Discover appliance model candidates, prices, and linked spec/install documents.
• reno-goat-pp-cli model-intel "shower valve" --sources auto --search-offers=false --json — Route through active plumbing/bath sources without search-result offer fallback.
• reno-goat-pp-cli model-intel "medicine cabinet" --sources auto --json — Use auto category inference for renovation-middle selections beyond appliances.
• reno-goat-pp-cli model-intel JOESC330RM --json — Probe exact-model retailer/manufacturer routes and report blocked/readable offer evidence.

source-probe — Triage showroom and big-box routes before promoting a source.

• reno-goat-pp-cli source-probe --candidate appliance-priority-gaps --json — Probe ABW, ADU catalog, AJ Madison, Abt, Best Buy, Costco, PC Richard, Appliance Factory, Homewise Appliance, Spencer's, Grand Appliance, and Warners' Stellian.
• reno-goat-pp-cli source-probe --candidate bath-priority-gaps --json — Probe QualityBath, Vintage Tub, HomePerfect, DecorPlanet, Build.com, and Signature Hardware.
• reno-goat-pp-cli source-probe --candidate none --url <url> --json — Probe a custom route and classify readable, blocked, or unreachable responses; large bodies report body_truncated.

reviews — Get product reviews from a single source. Supports Ferguson (via GraphQL) and Article (via APQ queries for reviews and UGC media).

• reno-goat-pp-cli reviews article-reviews — Get product reviews from Article via APQ getProductReviewsByProductId query.
• reno-goat-pp-cli reviews ferguson-reviews — Get product reviews from Ferguson via the ProductDetail GraphQL query (reviews are embedded in product detail response).

stores — Find physical retail stores near a location. Supported for West Elm and Rejuvenation via their store locator APIs.

• reno-goat-pp-cli stores rejuvenation-stores — Find Rejuvenation stores near a location.
• reno-goat-pp-cli stores westelm-stores — Find West Elm stores near a location.

suggest — Autocomplete and typeahead suggestions from Constructor.io sources (West Elm and Rejuvenation). Returns search suggestions and optionally product previews.

• reno-goat-pp-cli suggest rejuvenation-suggest — Autocomplete suggestions from Rejuvenation via Constructor.io.
• reno-goat-pp-cli suggest westelm-suggest — Autocomplete suggestions from West Elm via Constructor.io.

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

reno-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.

• reno-goat-pp-cli watch <product-url> [--threshold <percent>] — Price watch system.
• reno-goat-pp-cli project <subcommand> [args] — Project tracker for grouping saved products into named renovation/design projects with running budget totals.
• reno-goat-pp-cli saved [--check-stale] — Manage saved/bookmarked products. saved lists all saved products.
• reno-goat-pp-cli config — View and edit CLI configuration (default category routing, preferred sources, output format, SQLite database path).
• reno-goat-pp-cli sources — List all upstream API sources, their status (active/stub/deferred), categories served, rate limits
• reno-goat-pp-cli history — Show past search queries with timestamps, result counts, and sources queried.
• reno-goat-pp-cli save <product-url> — Bookmark a product URL for later. Stores the product snapshot (title, price, source, URL) in local SQLite.
• reno-goat-pp-cli version — Print CLI version, build info, configured sources, and SQLite database path.

Auth Setup

No authentication required.

Run reno-goat-pp-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

• Pipeable — JSON on stdout, errors on stderr

• Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:

  reno-goat-pp-cli brands ferguson-brands --agent --select id,name,status
  

• Previewable — --dry-run shows the request without sending

• Offline-friendly — sync/search commands can use the local SQLite store when available

• Non-interactive — never prompts, every input is a flag

• Explicit retries — use --idempotent only when an already-existing create should count as success

Response envelope

Commands that read from the local store or the API wrap output in a provenance envelope:

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse .results for data and .meta.source to know whether it's live or local. A human-readable N results (live) summary is printed to stderr only when stdout is a terminal AND no machine-format flag (--json, --csv, --compact, --quiet, --plain, --select) is set — piped/agent consumers and explicit-format runs get pure JSON on stdout.

Agent Feedback

When you (or the agent) notice something off about this CLI, record it:

reno-goat-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
reno-goat-pp-cli feedback --stdin < notes.txt
reno-goat-pp-cli feedback list --json --limit 10

Entries are stored locally at ~/.local/share/reno-goat-pp-cli/feedback.jsonl. They are never POSTed unless RENO_GOAT_FEEDBACK_ENDPOINT is set AND either --send is passed or RENO_GOAT_FEEDBACK_AUTO_SEND=true. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

Output Delivery

Every command accepts --deliver <sink>. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Sink	Effect
stdout	Default; write to stdout only
file:<path>	Atomically write output to <path> (tmp + rename)
webhook:<url>	POST the output body to the URL (application/json or application/x-ndjson when --compact)

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

Named Profiles

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

reno-goat-pp-cli profile save briefing --json
reno-goat-pp-cli --profile briefing brands ferguson-brands
reno-goat-pp-cli profile list --json
reno-goat-pp-cli profile show briefing
reno-goat-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults. agent-context lists all available profiles under available_profiles so introspecting agents discover them at runtime.

Exit Codes

Code	Meaning
0	Success
2	Usage error (wrong arguments)
3	Resource not found
5	API error (upstream issue)
7	Rate limited (wait and retry)
10	Config error

Argument Parsing

Parse $ARGUMENTS:

1. Empty, help, or --help → show reno-goat-pp-cli --help output
2. Starts with install → ends with mcp → MCP installation; otherwise → see Prerequisites above
3. Anything else → Direct Use (execute as CLI command with --agent)

MCP Server Installation

1. Install the MCP server:

   go install github.com/mvanhorn/printing-press-library/library/commerce/reno-goat/cmd/reno-goat-pp-mcp@latest
   

2. Register with Claude Code:

   claude mcp add reno-goat-pp-mcp -- reno-goat-pp-mcp
   

3. Verify: claude mcp list

Direct Use

1. Check if installed: which reno-goat-pp-cli If not found, offer to install (see Prerequisites at the top of this skill).
2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
3. Execute with the --agent flag:

   reno-goat-pp-cli <command> [subcommand] [args] --agent
   

4. If ambiguous, drill into subcommand help: reno-goat-pp-cli <command> --help.