| name | pp-pagliacci |
| description | Order Seattle's favorite pizza from the terminal — every endpoint, plus discount stacking, slice rotation across stores, half-and-half pies, and a small-party planner nobody else has. Trigger phrases: `order from pagliacci`, `what pagliacci slices are available`, `plan a pagliacci order for the family`, `build a half-and-half pagliacci pizza`, `pagliacci rewards balance`, `use pagliacci`, `run pagliacci`. |
| author | Trevin Chow |
| license | Apache-2.0 |
| argument-hint | <command> [args] | install cli|mcp |
| allowed-tools | Read Bash |
| metadata | {"openclaw":{"requires":{"bins":["pagliacci-pp-cli"]},"install":[{"kind":"go","bins":["pagliacci-pp-cli"],"module":"github.com/mvanhorn/printing-press-library/library/food-and-dining/pagliacci/cmd/pagliacci-pp-cli"}]}} |
Pagliacci Pizza — Printing Press CLI
Prerequisites: Install the CLI
This skill drives the pagliacci-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 pagliacci --cli-only
- Verify:
pagliacci-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/pagliacci/cmd/pagliacci-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 when an agent or user wants to interact with Pagliacci Pizza programmatically: browsing the menu, finding a store and time slot, building a half-and-half pizza, planning a small-party order, checking rewards balance, or replaying a past order. The CLI is built for households ordering for family or small parties.
Unique Capabilities
These capabilities aren't available in any other tool for this API.
Local state that compounds
-
slices today — See which Pagliacci slices are available right now at every Seattle store, sorted by proximity to your saved address.
When the family asks 'what slices can we order tonight?', this returns a single comparable list — no per-store iteration needed.
pagliacci-pp-cli slices today --agent
-
rewards stack — Compute the best application of stored coupons, reward redemption, and account credit for a given order total. Defaults to single-best-coupon + credit; multi-coupon stacking is flagged --experimental.
Family-size orders ($40+) hit reward thresholds where stacking actually saves real money — agents pick the optimal discount, not just the first valid coupon.
pagliacci-pp-cli rewards stack --order-total 55.00 --agent
-
orders summary — Aggregate orders over a time range with top items, store breakdown, and order frequency.
See the household's pizza pattern — what we order most, which store, how often — for budgeting or just fun.
pagliacci-pp-cli orders summary --since 90d --agent
Time-aware composed lookups
-
store tonight — List stores that are still open and can deliver to your saved address right now, sorted by ETA.
Last-minute family dinner: only surface stores that will actually take the order tonight.
pagliacci-pp-cli store tonight --address-label home --agent
-
address best-time — Resolve a saved address label to the next available delivery slot in one call.
Schedule delivery to land at family dinner time — no separate zone lookup or slot search.
pagliacci-pp-cli address best-time --label home --agent
Order workflows
-
orders reorder — Re-create a past order as a fresh cart, with price revalidation since prices change. Add --send to also submit.
Households have a usual order — replay it without rebuilding the cart line by line.
pagliacci-pp-cli orders reorder --last --dry-run
-
menu half-half — Build a half-and-half pizza in one command, with each side's toppings validated against the menu and priced via ProductPrice.
Families with picky kids order half-and-half pies as the default. One command produces a sendable cart entry for the most common household pizza shape.
pagliacci-pp-cli menu half-half --left pepperoni --right cheese --size large --json
-
orders plan — Given the number of people and a saved address, suggest a complete order plan: best store, delivery slot, sized cart contents, and the optimal discount stack.
Hosting 4–8 people: one command gives the agent everything it needs to confirm an order — no chained tool calls, no manual compose.
pagliacci-pp-cli orders plan --people 6 --address-label home --json
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: 26 API entries from 26 total network entries
- Protocols: rest_json (98% confidence)
- Auth signals: composed — headers: Authorization — cookies: customerId, authToken
- Generation hints: requires_browser_auth, composed_auth
- Candidate command ideas: store list — GET /Store returned full inventory of locations; menu top — GET /MenuTop/{storeId} drives the home menu UI; menu cache — GET /MenuCache/{storeId} returns the full menu; menu slices — GET /MenuSlices returns today's slices across all stores; address lookup — POST /AddressInfo validates an address and resolves a delivery store; address list — GET /AddressName returns saved addresses; orders list — GET /OrderList/{page}/{size} returns paginated history; orders get — GET /OrderListItem/{id} returns full detail
Command Reference
account — Authentication and registration (no auth required for these endpoints)
pagliacci-pp-cli account confirm_email — Confirm a new account by clicking the email-confirmation link's tokenpagliacci-pp-cli account create_token — Issue a session token (used internally by the SPA for token refresh)pagliacci-pp-cli account login — Authenticate with email/phone + password. Response sets customerId and authToken cookies.pagliacci-pp-cli account logout — Invalidate the current sessionpagliacci-pp-cli account password_forgot — Request a password reset emailpagliacci-pp-cli account password_reset — Reset a password using a token from PasswordForgot emailpagliacci-pp-cli account register — Create a new customer account
address — Address validation and saved address book
pagliacci-pp-cli address create — Create a new saved addresspagliacci-pp-cli address delete — Delete a saved addresspagliacci-pp-cli address get — Get a saved address by IDpagliacci-pp-cli address get_info — Get address info by saved IDpagliacci-pp-cli address list — List the authenticated user's saved addressespagliacci-pp-cli address lookup — Validate an address and check delivery zone (returns store ID if deliverable)
cart — Build and price an order before sending it
pagliacci-pp-cli cart get_quote_building — Get the current cart/quote-building state by building IDpagliacci-pp-cli cart price_order — Compute the total price for an order (cart contents, taxes, fees, delivery) before sendingpagliacci-pp-cli cart send_order — Submit an order. Requires payment information for guests; uses stored payment for authenticated users.pagliacci-pp-cli cart update_quote_building — Update cart contents (add/remove/modify items)
credit — Account credit balance and entries
pagliacci-pp-cli credit delete — Remove an account credit entrypagliacci-pp-cli credit get — Get a single credit entrypagliacci-pp-cli credit list — List the authenticated user's account credit entries
customer — Customer profile and devices
pagliacci-pp-cli customer access_devices_delete — Revoke a device's access to the accountpagliacci-pp-cli customer access_devices_list — List devices that have access to this accountpagliacci-pp-cli customer get — Get customer profile by IDpagliacci-pp-cli customer migrate_answer — Submit the answer to a migration questionpagliacci-pp-cli customer migrate_question — Submit a security/migration question (legacy account migration flow)
customer_feedback — Customer feedback submissions to Pagliacci
pagliacci-pp-cli customer_feedback get — Get a feedback submission by IDpagliacci-pp-cli customer_feedback submit — Submit customer feedback (guest or authenticated)
gifts — Stored gift cards, balance lookup, and transfer
pagliacci-pp-cli gifts check — Check the balance of a gift card by ID and PIN (no auth required to check)pagliacci-pp-cli gifts delete — Remove a stored gift card from the accountpagliacci-pp-cli gifts get — Get a single stored gift card by IDpagliacci-pp-cli gifts list — List the authenticated user's stored gift cardspagliacci-pp-cli gifts transfer — Transfer gift card balance to another accountpagliacci-pp-cli gifts value — Get current value/balance of a saved gift card
menu — Menus, slices, and product pricing
pagliacci-pp-cli menu cache — Get the full menu (categories, products, prices, descriptions, images) for a storepagliacci-pp-cli menu product_price — Calculate the price for a customized product (size, toppings, modifiers)pagliacci-pp-cli menu slices — Get available slices across all stores for the current day (perishable, rotates daily)pagliacci-pp-cli menu top — Get featured top-of-menu items for a store
orders — Order history and details
pagliacci-pp-cli orders clone — Get order data shaped for re-ordering (transforms a past order into a new cart)pagliacci-pp-cli orders get — Get the full detail of a single past order (items, prices, store, time)pagliacci-pp-cli orders list — List the authenticated user's order history (paginated)pagliacci-pp-cli orders list_gift_cards — List orders that purchased gift cardspagliacci-pp-cli orders list_pending — List orders that are currently in flight (placed but not yet delivered/picked up)pagliacci-pp-cli orders suggestion — Get personalized order suggestions for a customer
rewards — Loyalty card, rewards history, and stored coupons
pagliacci-pp-cli rewards card — Get the authenticated user's reward card balance, points, and available rewardspagliacci-pp-cli rewards coupon_lookup — Look up a coupon by its serial number (validate before applying)pagliacci-pp-cli rewards history — Get reward earning/redemption history (most recent N entries)pagliacci-pp-cli rewards stored_coupons — List coupons saved to the authenticated user's account
scheduling — Delivery and pickup time windows
pagliacci-pp-cli scheduling slot_list — List available time-window slots for a store and service typepagliacci-pp-cli scheduling slot_list_for_date — List allowed slot times for a specific delivery/pickup date (YYYYMMDD)pagliacci-pp-cli scheduling window_days — List available delivery or pickup days for a store. serviceType is DEL (delivery) or PICK (pickup)
store — Pagliacci store locations, hours, and quote info
pagliacci-pp-cli store compute_quote — Compute a quote for a specific store with cart contents (returns Delivery, Drone, Pickup wait values)pagliacci-pp-cli store get — Get a single store by its numeric IDpagliacci-pp-cli store get_quote — Get quote-store metadata (delivery fee, drone status, pickup wait time) for a single storepagliacci-pp-cli store list — List all Pagliacci store locations with addresses, hours, GPS, amenities, and available slicespagliacci-pp-cli store list_quotes — List quote-store metadata (delivery fee, drone status, pickup wait) for all stores
system — System information and announcements
pagliacci-pp-cli system site_wide_message — Get site-wide announcement banner text (closures, holiday hours, etc.)pagliacci-pp-cli system version — Get the current API version
Freshness Contract
This printed CLI owns bounded freshness only for registered store-backed read command paths. In --data-source auto mode, those paths check sync_state and may run a bounded refresh before reading local data. --data-source local never refreshes. --data-source live reads the API and does not mutate the local store. Set PAGLIACCI_NO_AUTO_REFRESH=1 to skip the freshness hook without changing source selection.
Covered paths:
pagliacci-pp-cli addresspagliacci-pp-cli address createpagliacci-pp-cli address deletepagliacci-pp-cli address getpagliacci-pp-cli address get_infopagliacci-pp-cli address listpagliacci-pp-cli address lookuppagliacci-pp-cli creditpagliacci-pp-cli credit deletepagliacci-pp-cli credit getpagliacci-pp-cli credit listpagliacci-pp-cli customerpagliacci-pp-cli customer access_devices_deletepagliacci-pp-cli customer access_devices_listpagliacci-pp-cli customer getpagliacci-pp-cli customer migrate_answerpagliacci-pp-cli customer migrate_questionpagliacci-pp-cli giftspagliacci-pp-cli gifts checkpagliacci-pp-cli gifts deletepagliacci-pp-cli gifts getpagliacci-pp-cli gifts listpagliacci-pp-cli gifts transferpagliacci-pp-cli gifts valuepagliacci-pp-cli orderspagliacci-pp-cli orders clonepagliacci-pp-cli orders getpagliacci-pp-cli orders listpagliacci-pp-cli orders list_gift_cardspagliacci-pp-cli orders list_pendingpagliacci-pp-cli orders suggestionpagliacci-pp-cli storepagliacci-pp-cli store compute_quotepagliacci-pp-cli store getpagliacci-pp-cli store get_quotepagliacci-pp-cli store listpagliacci-pp-cli store list_quotes
When JSON output uses the generated provenance envelope, freshness metadata appears at meta.freshness. Treat it as current-cache freshness for the covered command path, not a guarantee of complete historical backfill or API-specific enrichment.
Finding the right command
When you know what you want to do but not which command does it, ask the CLI directly:
pagliacci-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
What can we eat tonight?
pagliacci-pp-cli slices today --agent --select store,slice,price
Returns today's available slices across all stores with just the high-gravity fields for fast agent decision making.
Plan a small-party order for 6
pagliacci-pp-cli orders plan --people 6 --address-label home --json
Composes store proximity, delivery slot, sized cart, and discount stack into one recommendation.
Build a half-and-half family pizza
pagliacci-pp-cli menu half-half --left pepperoni --right cheese --size large --json
Validates both halves against the menu and returns a priced, sendable cart entry.
Replay last order
pagliacci-pp-cli orders reorder --last --dry-run --json
Pulls the most recent OrderListItem, transforms via OrderClone, re-prices, and returns a sendable cart without submitting.
Maximize discount before checkout
pagliacci-pp-cli rewards stack --order-total 55.00 --agent
Computes the best application of saved coupons, reward redemption, and account credit for a given order total.
Auth Setup
Pagliacci has no public API and uses a custom composed PagliacciAuth {customerId}|{authToken} header constructed from cookies. Run pagliacci-pp-cli auth login --chrome while logged into pagliacci.com in Chrome — the CLI reads the auth cookies and constructs the header for you. Public commands (menu, stores, slices, time-windows) work without login; authenticated commands (order history, rewards, saved addresses) require the Chrome session.
Run pagliacci-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:
pagliacci-pp-cli address list --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
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 — piped/agent consumers get pure JSON on stdout.
Agent Feedback
When you (or the agent) notice something off about this CLI, record it:
pagliacci-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
pagliacci-pp-cli feedback --stdin < notes.txt
pagliacci-pp-cli feedback list --json --limit 10
Entries are stored locally at ~/.pagliacci-pp-cli/feedback.jsonl. They are never POSTed unless PAGLIACCI_FEEDBACK_ENDPOINT is set AND either --send is passed or PAGLIACCI_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.
pagliacci-pp-cli profile save briefing --json
pagliacci-pp-cli --profile briefing address list
pagliacci-pp-cli profile list --json
pagliacci-pp-cli profile show briefing
pagliacci-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 |
| 4 | Authentication required |
| 5 | API error (upstream issue) |
| 7 | Rate limited (wait and retry) |
| 10 | Config error |
Argument Parsing
Parse $ARGUMENTS:
- Empty,
help, or --help → show pagliacci-pp-cli --help output
- Starts with
install → ends with mcp → MCP installation; otherwise → see Prerequisites above
- Anything else → Direct Use (execute as CLI command with
--agent)
MCP Server Installation
- Install the MCP server:
go install github.com/mvanhorn/printing-press-library/library/food-and-dining/pagliacci/cmd/pagliacci-pp-mcp@latest
- Register with Claude Code:
claude mcp add pagliacci-pp-mcp -- pagliacci-pp-mcp
- Verify:
claude mcp list
Direct Use
- Check if installed:
which pagliacci-pp-cli
If not found, offer to install (see Prerequisites at the top of this skill).
- Match the user query to the best command from the Unique Capabilities and Command Reference above.
- Execute with the
--agent flag:
pagliacci-pp-cli <command> [subcommand] [args] --agent
- If ambiguous, drill into subcommand help:
pagliacci-pp-cli <command> --help.
