Pp Greatclips

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/other/greatclips/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Great Clips — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the greatclips-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. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

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

2. Verify: greatclips-pp-cli --version
3. 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.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/other/greatclips/cmd/greatclips-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 this CLI to send the exact HTTP requests the Great Clips Online Check-In SPA sends, from the command line, with dry-run and --json output. v0.1 ships every endpoint's request shape so an agent can build flows on top; real calls require manual cookie capture from a logged-in Chrome session.

HTTP Transport

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.

Discovery Signals

This CLI was generated with browser-observed traffic context.

• Capture coverage: 9 API entries from 22 total network entries
• Protocols: (0% confidence), (0% confidence), (0% confidence)
• Generation hints: Two-host single-auth: emit one bearer-token client that handles both webservices.greatclips.com and www.stylewaretouch.net., POST /api/store/waitTime takes a JSON array body of {storeNumber} objects, not a single object. Single-salon call sends an array of length 1., Auth captured live via Claude-in-Chrome MCP from a logged-in Chrome session; the printed CLI should ship a auth login --chrome helper command for the equivalent flow.

Command Reference

cancel — Cancel your active check-in

• greatclips-pp-cli cancel — Cancel the active check-in for this account

checkin — Submit a check-in for yourself plus a party (1-5 people)

• greatclips-pp-cli checkin — Add yourself and optionally other party members to a salon waitlist

customer — Read your Great Clips customer profile (name, phone, favorites, recent visits)

• greatclips-pp-cli customer — Get the authenticated customer's profile

geo — Resolve a zip code or city term to latitude/longitude

• greatclips-pp-cli geo — Resolve a zip/postal code to lat/lng/city/state

hours — Read salon hours (today plus 14-day forecast with special hours)

• greatclips-pp-cli hours — Get 14-day hours forecast for one salon

salons — Search and look up Great Clips salons

• greatclips-pp-cli salons get — Get a single salon by its salon number
• greatclips-pp-cli salons search — Search salons by zip code, city, or coordinates within a radius

status — Check your current position in line for an active check-in

• greatclips-pp-cli status — Get your active check-in status (position in line, estimated wait)

wait — Read estimated wait times from the ICS Net Check-In service

• greatclips-pp-cli wait — Get wait time for one salon (body is a single-element array of {storeNumber})

Finding the right command

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

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

Recipes

Party-of-four check-in request body

greatclips-pp-cli checkin --first-name Matt --last-name VanHorn --phone-number '(206) 555-0100' --salon-number 8991 --guests 4 --dry-run --json

Emits the exact JSON body POSTed to www.stylewaretouch.net/api/customer/checkIn for a party of four at Island Square.

Wait-time request for a salon

greatclips-pp-cli wait --store-number 8991 --dry-run --json

Request shape for the ICS Net Check-In waitTime endpoint.

Salons near a zip

greatclips-pp-cli salons search --term 98040 --radius 5 --dry-run --json

Request shape for the salon-search/term endpoint with a 5-mile radius.

14-day hours forecast

greatclips-pp-cli hours --salon 8991 --dry-run

Calls salon-hours/upcoming for one salon; the response includes special-hours and holiday closures.

Geocode a postal code

greatclips-pp-cli geo --query 98040 --dry-run --json --select results.city,results.state,results.lat,results.lng

Resolves a zip code to lat/lng/city/state via the geo-names endpoint.

Auth Setup

Great Clips uses HttpOnly session cookies from an Auth0 tenant at cid.greatclips.com. Browser-sniff confirmed all calls succeed via cookies attached by the browser, not via an Authorization header. v0.1 of this CLI ships the request shape and host routing; to make real calls, paste the cookies from a logged-in Chrome session into ~/.config/greatclips-pp-cli/config.toml. Set GREATCLIPS_TOKEN to any placeholder so doctor passes (the env var is kept for v0.2 when bearer support might land).

Run greatclips-pp-cli doctor to verify setup.