charger

# charger Higher-level EV charger checker built on Google Places (New) EV charge data. This skill includes a `bin/charger` CLI (Node.js) for checking charger availability. ## Setup - Requirements: - Node.js 18+ (Clawdbot already has Node) - `GOOGLE_PLACES_API_KEY` (recommended in `~/.clawdbot/.env`) - Put the CLI on your PATH (example): - `ln -sf "$(pwd)"/bin/charger /home/claw/clawd/bin/charger` - Add a favorite: - `charger favorites add home --place-id <placeId>` ## Commands - Check a favorite / place id / query: - `charger check home` - `charger check "Wien Energie Charging Station Liniengasse 2 1060 Wien"` - Find nearby: - `charger nearby --lat 48.188472 --lng 16.348854 --radius 2000 --max 10` ## Notifications The recommended pattern is: 1) `charger` (this skill) produces a clear `Any free: YES|NO` result. 2) A scheduled job (Gateway cron) runs a small helper that only prints output when it should notify. ### Helper script (what actually decides to notify) This bundle includes `scripts/charger-notify.sh`. What it does: - Runs `charger check <target>` - If `Any free: YES` **and** the last run was not `YES`, it prints a single notification line. - Otherwise it prints **nothing**. So: **no output = no notification**. State: - Stores last state in `~/.cache/charger-notify/<target>.state` so it only notifies on the change `NO/UNKNOWN → YES`. Usage: - `bash scripts/charger-notify.sh home` Example notification output: - `EV charger available: Tanke Wien Energie Charging Station — Amtshausgasse 9, 1050 Wien, Austria — 1/2 available (OOS 0) (updated 2026-01-21T21:05:00Z)` ### Typical cron schedule (how you actually get Telegram pings) Cron is the scheduler. It runs the helper script on a timer and sends you whatever the script prints. Because the helper prints **only when it becomes available**, you only get messages when it matters. Check every 10 minutes: - `*/10 * * * *` If you want me to wire this into Clawdbot Gateway cron (so you get Telegram pings), tell me: - target (`home`) - interval (every 5/10/20 min) - quiet hours (optional)