meetup-scheduler

Files (2)

• SKILL.md
• meetup.py · scripts/

SKILL.md (first lines)

## Purpose

Use this skill whenever Lukas asks for help organising a real-life meetup-"meet at a pub at 19:00", "grab drinks with friends downtown", "I want to be at the museum by 6"-especially when the request implies travel planning. The skill always: (1) clarifies missing basics (origin, destination, timing, transport preferences), (2) defaults to Lukas's home address and public transport when unspecified, (3) consults Google Directions, (4) derives the latest safe departure time (travel duration plus a buffer), and (5) schedules a reminder via cron so Lukas gets a heads-up before he needs to leave.

## Trigger cues

- "Help me plan a meetup at..."
- "I want to get to <place> by <time>."
- "Schedule a meetup / meet some friends / go to the pub / I need to be somewhere."
- Anything that references a real-world meeting, arrival time, or needing travel guidance.

## Workflow
1. **Gather the requirements.** Confirm or ask for:
   - Destination (validate it parses as an address; if it resolves to a landmark, keep user language for the reminder text).
   - Arrival time (target when Lukas wants to be there; parse into ISO or HH:MM for the current day).
   - Origin (default to home but ask if he meant somewhere else or is already "at" a place). For future flexibility, store his home address in memory.
   - Mode of transport (default to public transport unless he explicitly says drive/walk/bike).
   - Any safety buffer he wants (5 min default before the transit/drive start).

2. **Run the helper script.** Use `scripts/meetup.py` with the gathered inputs (destination, arrival time, origin, mode, buffer) to fetch the current route from the Google Directions API. The script returns:
   - Travel duration in minutes
   - The departure moment (arrival minus duration minus buffer) in Lukas's local timezone, plus the UTC equivalent for scheduling
   - Step-by-step instructions for the first leg(s), including any transit lines/stops
   - First-leg instructions suitable for the reminder message

3. **Review the suggested plan with Lukas.** Share the key facts in plain language:
   - "Leave at 19:40 (Europe/Vienna) via transit to reach Hauptplatz Linz by 20:00; travel takes ≈14 min."
   - Mention that the reminder will arrive about 5 minutes before the computed leave time.
   - *Avoid extra verbosity*-do not include the cron job ID or raw JSON output in this message.

4. **Schedule the reminder.** When Lukas approves the plan:
   - Use the `cron` tool (see documentation) to add a job firing at the computed leave time (convert the local departure time to UTC for the job schedule).
   - The reminder payload should mention: "Leave now for <destination> via <mode>; it takes ~<duration> and you should catch <next transit info>." Include the first action (e.g., "Walk to the tram stop at Linz Hauptplatz, catch tram 2 towards Leonding West").
   - Note the reminder in a short memory field if Lukas may need to cancel or adjust it soon, but do not share the job ID in conversation.

5. **Handle follow-ups.** Lukas might later ask "cancel that reminder", "I changed my mind to drive", or "update the meetup to 19:30". Re-run the script with the new parameters, cancel the old cron job if needed, and schedule a new reminder.

## Helper script

### `scripts/meetup.py`

The script lives inside this skill. It exposes a command-line interface so Codex can ask: `python skills/meetup-scheduler/scripts/meetup.py --destination "Irish Pub" --arrival "2026-02-20T19:00"`.

- **Inputs**: `--destination`, `--arrival` (ISO or HH:MM), optional `--origin`, `--mode` (`transit, driving, walking, bicycling`), `--buffer` (minutes before departure), `--json` (print machine-readable data).
- **Outputs**: JSON summarising travel duration, computed departure time, and first-leg instructions. The CLI also pretty-prints the details if `--json` is omitted.
- **Implementation notes**:
  - It reads `google_maps_api_key` and `home_address` from the provisioned config (see Configuration).
  - It defaults to transit/rides from home when the corresponding arguments aren't present.
  - It uses standard library `urllib` so no extra dependencies are needed.

## Configuration

Config is provisioned by Ansible from Vault (`vault_openclaw_meetup_scheduler_google_maps_api_key`, `vault_openclaw_meetup_scheduler_home_address` in `infra/group_vars/all/secret.yml`). The gateway sets `MEETUP_SCHEDULER_CONFIG` to the deployed config path.

## Reminder Cadence

- Reminders go out once, a fixed buffer before the computed departure time.
- If Lukas needs multiple nudges (e.g., an earlier "start packing" message), add another cron job with a different `leave_in` window but reference the same itinerary.
- When plans change, cancel outdated cron jobs via the `cron` tool before adding new ones.

## After the reminder fires

Let Lukas know the reminder text and confirm he made it. If he enjoyed the experience, summarise the travel time and whether the transit plan matched reality-these insights will help refine future suggestions.

From LukGer/lukger-home, WTFPL.

More from LukGer/lukger-home