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)