--- name: pp-peerspace description: "Tech-event venue scout for Peerspace: search, shortlist, hydrate full listing details (about/rules/parking), check calendar availability, message hosts (inquiry-send), verify guest status, and export Luma/Eventbrite packs. Trigger phrases: `find tech meetup venues`, `hydrate Peerspace shortlist`, `message Peerspace host`, `contact listing owner`, `venue availability`, `export Peerspace shortlist for Luma`, `search Peerspace venues`, `use peerspace`, `run peerspace-pp-cli`." author: "nspage" license: "Apache-2.0" argument-hint: " [args] | install cli|mcp" allowed-tools: "Read Bash" metadata: openclaw: requires: bins: - peerspace-pp-cli install: - kind: go bins: [peerspace-pp-cli] module: github.com/mvanhorn/printing-press-library/library/travel/peerspace/cmd/peerspace-pp-cli --- # Peerspace — Printing Press CLI ## Prerequisites: Install the CLI This skill drives the `peerspace-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: ```bash npx -y @mvanhorn/printing-press-library install peerspace --cli-only ``` 2. Verify: `peerspace-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). This installs into `$GOPATH/bin` (default `$HOME/go/bin`), so add that directory to `$PATH` instead: ```bash go install github.com/mvanhorn/printing-press-library/library/travel/peerspace/cmd/peerspace-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. Peerspace has no public API. peerspace-pp-cli wraps live venue search and listing detail behind Surf transport, saves favorites boards, hydrates full listing page blocks into SQLite (about, rules, parking, amenities), checks calendar availability, prices and sends host inquiries, and exports shortlists for Eventbrite/Luma/Slack. ## When to Use This CLI Use when planning tech meetups, workshops, or community events: scout venues by headcount/budget/date, build a favorites board, hydrate deep listing detail, check day/month availability, message hosts about staffing or fit, score amenity gaps, and hand off shortlists to Luma/Eventbrite workflows. ## Anti-triggers Do not use this CLI for: - Do not place or pay for bookings — checkout/payment is not supported - Do not manage host-side listings or host calendar tools beyond guest availability reads - Do not auto-hydrate every search hit — call `shortlist hydrate` only after shortlisting - Do not send host inquiries without explicit user approval (`inquiry-send` requires `--yes`) - Do not expect a stable official API contract; endpoints are reverse-engineered from site traffic ## Unique Capabilities These capabilities aren't available in any other tool for this API. ### Market intelligence - **`scout budget`** — Band market listings by hourly/day rate so you can see what a city+activity actually costs. _Use when planning a budget before deep-diving individual venues._ ```bash peerspace-pp-cli scout budget --city Paris --activity meetup --band 50 --json ``` - **`scout capacity`** — Histogram of guest capacity for a synced market so you can re-cut when headcount changes. _Use when guest count is the binding constraint, not price._ ```bash peerspace-pp-cli scout capacity --city Paris --activity meetup --band 10 --json ``` - **`markets pulse`** — Cross-city rollup of median price, listing density, instant-book share, and capacity quantiles. _Use when comparing host cities for the same event type._ ```bash peerspace-pp-cli markets pulse --city Paris --city Lyon --activity meetup --json ``` - **`markets neighborhoods`** — Per-neighborhood listing stats plus optional --vibe tech keyword signals from descriptions (WiFi, projector, transit) and a built-in tech-cluster map. _Use to pick tech-friendly neighborhoods before refining a shortlist._ ```bash peerspace-pp-cli markets neighborhoods --city Paris --activity meetup --vibe tech --json ``` ### Shortlist intelligence - **`shortlist compare`** — Join your favorites board to listing attributes for a sortable offline comparison table. _Use when deciding among saved venues without reopening browser tabs._ ```bash peerspace-pp-cli shortlist compare --sort price --json ``` - **`shortlist create-board`** — Create a Peerspace favorite board and attach a listing (cookie auth). _Use when starting a new shortlist board from a space you want to save._ ```bash peerspace-pp-cli shortlist create-board --name "Q3 meetup shortlist" --listing-id 68d468bb44492187e415d4a6 --activity Meetup --location "Paris, France" --json ``` - **`shortlist add`** — Favorite a space by attaching its listing id to an existing favorite board (cookie auth). _Use when saving a listing onto a board you already have without opening the website._ ```bash peerspace-pp-cli shortlist add --listing-id 68d468bb44492187e415d4a6 --board-id 669152994300a86e4a943da5 --json ``` - **`shortlist hydrate`** — Fetch full listing page details (about, rules, parking, amenities, format_fit) for board or listing IDs into SQLite. Pure HTTP GET `/v1/listings/{id}` — not part of search. _Use after shortlisting, before export/compare/host outreach, when you need deeper page blocks than search cards._ ```bash peerspace-pp-cli shortlist hydrate --board-id 6a590f4497e3495c4f756ee8 --collaborator-id 66915212d22cc89e3402c745 --force --json ``` - **`shortlist delta`** — Show favorites added, removed, or changed since the last sync snapshot. _Use to see what changed on your board without scrolling hearts._ ```bash peerspace-pp-cli shortlist delta --json ``` - **`shortlist similar`** — Find local listings near a favorite on capacity, price, and neighborhood. _Use when a favorite is booked or too expensive and you need substitutes._ ```bash peerspace-pp-cli shortlist similar --within-pct 20 --json ``` - **`projects scout`** — Combine project location metadata with fitting listings from the local store. _Use when a saved project needs a ready market pack._ ```bash peerspace-pp-cli projects scout --json ``` - **`shortlist export`** — Export favorites as clean JSON plus a markdown block (price, capacity, amenities, fit notes) for Eventbrite/Luma/Slack. _Use when turning a Peerspace shortlist into a Luma/Eventbrite draft or Slack approval message._ ```bash peerspace-pp-cli shortlist export --format markdown --json ``` - **`shortlist drift`** — Track price and availability-field changes on favorites over time (Luma-style watch). _Use to catch rate spikes or lost instant-book before you pitch a venue._ ```bash peerspace-pp-cli shortlist drift --since 7d --json ``` ### Local state that compounds - **`sync coverage`** — Report which market query keys are present, row counts, and last-synced times. _Use before scout/markets/sql so agents fail closed on empty markets._ ```bash peerspace-pp-cli sync coverage --json ``` ### Agent-native plumbing - **`pulse`** — One cookie-auth shot: message thread count, favorites summary, profile identity, and optional recent shortlist activity. _Use for a daily inbox + shortlist health check without opening Peerspace._ ```bash peerspace-pp-cli pulse --include-shortlist --json ``` ### Tech event planning - **`venues recommend`** — Rank synced venues for tech meetups/workshops by headcount, date window, budget, and vibe keywords. _Use when an agent or planner needs a ranked shortlist for a tech event, not a raw search scroll._ ```bash peerspace-pp-cli venues recommend --guests 40 --budget-max 180 --vibe projector,wifi --json ``` - **`venues get`** — Lookup or live-fetch one full listing detail document (GET `/v1/listings/{id}`) including rules, parking, cleaning, cancellation; writes through to SQLite. _Use when you need deep page context for one venue without hydrating a whole board._ ```bash peerspace-pp-cli venues get 68d468bb44492187e415d4a6 --json ``` - **`scout gaps`** — Surface missing tech-event must-haves (WiFi, AV/projector, late access, flexible seating, transit) on any shortlist. _Use before finalizing a venue to see what each shortlist option lacks for a tech event._ ```bash peerspace-pp-cli scout gaps --checklist tech-meetup --json ``` - **`scout multi-city`** — Cross-city comparison with top venue options per city under shared tech-event constraints. _Use for multi-city meetup tours or choosing a host city under the same constraints._ ```bash peerspace-pp-cli scout multi-city --city Paris --city Lyon --guests 30 --budget-max 200 --top 3 --json ``` ### Booking readiness & host contact - **`calendar availability-start`** / **`availability-end`** / **`availability-month`** — Guest-side availability for a space (day start slots, end slots after a start index, month overview). _Use when checking whether a shortlisted venue is free for your event day/window._ ```bash peerspace-pp-cli calendar availability-start --space-id 68d458dba45ae0878156d4b6 --listing-id 68d468bb44492187e415d4a6 --year 2026 --month 7 --day 23 --json peerspace-pp-cli calendar availability-end --space-id 68d458dba45ae0878156d4b6 --listing-id 68d468bb44492187e415d4a6 --year 2026 --month 7 --day 23 --time-index 22 --json peerspace-pp-cli calendar availability-month --space-id 68d458dba45ae0878156d4b6 --year 2026 --month 7 --json ``` - **`contracts inquiry-quote`** — Price the message-host inquiry form without submitting (POST `/v1/contracts/inquiry/guest/quote`). _Use while composing outreach to estimate cost for dates + guest count._ ```bash peerspace-pp-cli contracts inquiry-quote --listing-id 68d468bb44492187e415d4a6 --year 2026 --month 7 --day 23 --start-index 22 --end-index 32 --start-hour 17 --end-hour 22 --guests 50 --activity meetup --json ``` - **`contracts inquiry-send`** — Send a host inquiry with message (POST `/v1/contracts/inquiry/guest`). **Requires `--yes`.** Contacts the host. _Use only when the user explicitly wants to message hosts._ ```bash peerspace-pp-cli contracts inquiry-send --listing-id 68d468bb44492187e415d4a6 --year 2026 --month 7 --day 23 --start-index 22 --end-index 32 --start-hour 17 --end-hour 22 --guests 50 --activity meetup --message "Hi — interested in a 50-person meetup." --yes --json ``` - **`contracts guest-quote`** — Price a request-to-book window (POST `/v1/contracts/request/guest/quote`, often prepare-only). _Use when estimating a formal booking request (not the inquiry message form)._ ```bash peerspace-pp-cli contracts guest-quote --listing-id 68d468bb44492187e415d4a6 --year 2026 --month 7 --day 23 --start-index 22 --end-index 32 --start-hour 17 --end-hour 22 --rate 85 --prepare-only --json ``` - **`verification listing`** — Check whether the guest needs ID verification for a listing. ```bash peerspace-pp-cli verification listing --listing-id 68d468bb44492187e415d4a6 --json ``` - **`messages unread`** — Inbox unread thread count (GET `/v2/messaging/messages/inbox/unread-count`). ```bash peerspace-pp-cli messages unread --json ``` - **`spaces faqs-event`** — Event FAQs for a space. ```bash peerspace-pp-cli spaces faqs-event --space-id 68d458dba45ae0878156d4b6 --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: 122 API entries from 702 total network entries - Protocols: websocket (95% confidence), rpc_envelope (80% confidence), rest_json (75% confidence), html_scrape (55% confidence) - Auth signals: api_key — headers: statsig-api-key, x-goog-api-key; api_key — query: key, token - Generation hints: has_rpc_envelope, weak_schema_confidence, browser_http_transport - Candidate command ideas: create_GetViewportInfo — Derived from observed POST /$rpc/google.internal.maps.mapsjs.v1.MapsJsInternalService/GetViewportInfo traffic.; create_initialize — Derived from observed POST /v1/initialize traffic.; create_m — Derived from observed POST /v1/m traffic.; create_p — Derived from observed POST /v1/p traffic.; create_pageview — Derived from observed POST /v1/pageview traffic.; create_prop.json — Derived from observed POST /prop.json traffic.; create_rgstr — Derived from observed POST /v1/rgstr traffic.; create_rum — Derived from observed POST /cdn-cgi/rum traffic. - Caveats: empty_payload: API-looking request returned an empty or null payload; schema confidence is weak.; empty_payload: API-looking request returned an empty or null payload; schema confidence is weak.; empty_payload: API-looking request returned an empty or null payload; schema confidence is weak.; empty_payload: API-looking request returned an empty or null payload; schema confidence is weak.; empty_payload: API-looking request returned an empty or null payload; schema confidence is weak.; empty_payload: API-looking request returned an empty or null payload; schema confidence is weak.; empty_payload: API-looking request returned an empty or null payload; schema confidence is weak.; empty_payload: API-looking request returned an empty or null payload; schema confidence is weak.; empty_payload: API-looking request returned an empty or null payload; schema confidence is weak.; empty_payload: API-looking request returned an empty or null payload; schema confidence is weak. ## Command Reference **entitlements** — Profile entitlement attachments - `peerspace-pp-cli entitlements` — Entitlement attachments for a profile id **env** — Public client environment config and keyword dictionaries - `peerspace-pp-cli env keywords` — Localized keyword dictionary (fr-FR sample from capture) - `peerspace-pp-cli env web` — Fetch Peerspace SPA web environment config and feature flags **messages** — Messaging inbox counts - `peerspace-pp-cli messages` — Unread or total message thread count for current user (v1) - `peerspace-pp-cli messages unread` — Inbox unread thread count (v2) **profiles** — Authenticated user profile - `peerspace-pp-cli profiles experience` — Profile experience / onboarding signals for current user - `peerspace-pp-cli profiles me` — Current authenticated profile (requires browser session cookie) **projects** — Saved projects and favorites boards - `peerspace-pp-cli projects details` — Project details for a collaborator (favorites project metadata) - `peerspace-pp-cli projects fav-board` — Favorite board attachments (saved listing ids) for a collaborator **shortlist** — Offline shortlist intelligence + live favorite writes + detail hydrate - `peerspace-pp-cli shortlist add` — Favorite a space onto an existing board (POST /v1/projects/attachments; body uses `project` board id string) - `peerspace-pp-cli shortlist create-board` — Create a favorite board and attach a listing - `peerspace-pp-cli shortlist compare` — Join favorites to listing attributes - `peerspace-pp-cli shortlist delta` — Favorites added/removed since last snapshot - `peerspace-pp-cli shortlist drift` — Price/availability changes on favorites - `peerspace-pp-cli shortlist export` — Markdown/JSON handoff (About/Rules/Parking after hydrate); optional `--collaborator-id` / `--board-id` - `peerspace-pp-cli shortlist hydrate` — Fetch full listing detail for board or listing IDs into SQLite (GET /v1/listings/{id}) - `peerspace-pp-cli shortlist similar` — Find local substitutes near a favorite **venues** — Venue search, full detail, filters, and default booking times - `peerspace-pp-cli venues default-times` — Default booking time windows by day-of-week for meetup activity - `peerspace-pp-cli venues filters` — List amenity, space-type, style, and feature filters for an activity - `peerspace-pp-cli venues get` — Local or live full listing detail (GET /v1/listings/{id}); caches to SQLite - `peerspace-pp-cli venues list` — Search Peerspace listings by location, activity, space type, guests, price, and availability - `peerspace-pp-cli venues natural` — Natural-language venue search (nl_query body). Discovered from search-app JS; enrich with same query params as list. - `peerspace-pp-cli venues prices` — Batch total-price calculation for listing ids + booking windows (from search-app getTotalPrices) - `peerspace-pp-cli venues recommend` — Rank synced venues for tech events **calendar** — Guest-side booking availability - `peerspace-pp-cli calendar availability-start` — Start time slots for a space/day - `peerspace-pp-cli calendar availability-end` — End time slots after a start `time_index` - `peerspace-pp-cli calendar availability-month` — Month-level availability for a space **contracts** — Quotes and host inquiries - `peerspace-pp-cli contracts guest-quote` — Request-to-book pricing quote (prepare-only supported) - `peerspace-pp-cli contracts inquiry-quote` — Message-host form pricing (type=INQUIRY) - `peerspace-pp-cli contracts inquiry-send` — Submit host inquiry + message (requires `--yes`) **verification** — Guest checks - `peerspace-pp-cli verification listing` — Whether guest needs verification for a listing **spaces** — Space-level resources - `peerspace-pp-cli spaces faqs-event` — Event FAQs for a space ## 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 `PEERSPACE_NO_AUTO_REFRESH=1` to skip the freshness hook without changing source selection. Covered paths: - `peerspace-pp-cli venues` - `peerspace-pp-cli venues get` - `peerspace-pp-cli venues list` - `peerspace-pp-cli venues search` 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: ```bash peerspace-pp-cli which "" ``` `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 ### Scout Paris meetups under budget ```bash peerspace-pp-cli venues list --activity meetup --viewport-location paris--france --size 24 --json --select hits.hits.title,hits.hits.city,hits.hits.number_guests ``` Live search with field narrowing for agent context ### Price bands after hydrate ```bash peerspace-pp-cli scout budget --city Paris --activity meetup --band 50 --json ``` Offline price histogram from local market snapshot ### Compare favorites ```bash peerspace-pp-cli shortlist compare --sort price --agent