pp-tesla

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/devices/tesla/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Tesla — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `tesla-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 tesla --cli-only
   ```
2. Verify: `tesla-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.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/devices/tesla/cmd/tesla-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 tesla-pp-cli when you want a JSON-first CLI for your Tesla owner account: vehicle state inspection, climate/lock/charge commands, charging cost analytics, and an MCP surface for AI agents to drive your car. Faster than the iOS app for one-off commands, more agent-friendly than TeslaPy, and ships a local SQLite that delivers TeslaMate-style analytics (drives, charges, vampire drain, cost ledger) without standing up Postgres+Grafana. Best fit for owners with pre-2021 Models S/X or 3/Y on the old REST endpoints; newer vehicles get a clear shim via `tesla reachability`.

## Unique Capabilities

These capabilities aren't available in any other tool for this API.

### Composite truth from local state
- **`ready`** — Single yes/no answer to "can I leave in 5 minutes?" with reasoned blocker list - SOC vs trip distance, plugged-in, doors closed, sentry off, cabin within 3F of target, no mid-install update

  _Most-asked Tesla owner question; the iOS app makes it a 6-tap diagnostic, agents need a one-call truth_

  ```bash
  tesla ready 5YJ3E1EA6XXXXXXXX --json
  ```

### Local analytics that beat the dashboard
- **`cost ledger`** — Per-session cost, monthly spend, home-vs-Supercharger ratio with tariff-window aware $/kWh

  _Charging cost is the #1 Tesla-owner spreadsheet exercise; this is the first pure-CLI replacement for the TeslaMate dashboard_

  ```bash
  tesla cost ledger --since 2026-04-01 --group supercharger --json
  ```
- **`cost what-if`** — "If you had only charged at home you would have saved $X over the last 90 days." Re-runs charge rows with home $/kWh substituted for Supercharger sessions

  _Most Tesla owners suspect they could save by charging at home but lack proof; this puts a dollar figure on it_

  ```bash
  tesla cost what-if --only-home --since 90d --json
  ```
- **`timeline`** — Stitched drives + charges from synced vehicle_states polls - start/end, distance, energy, efficiency, address-resolved lat/lng

  _Lets agents reason over the same data TeslaMate exposes, without standing up Docker+Postgres+Grafana_

  ```bash
  tesla timeline --since "last week" --json
  ```
- **`vampire`** — SOC delta vs idle time, flags suspicious sentry sessions or app-wake events

  _Warranty-dispute evidence and rogue-sentry detection; TeslaMate dashboard only otherwise_

  ```bash
  tesla vampire --threshold 1.5pct/24h --since 30d --json
  ```

### Charging intelligence nobody else exposes
- **`supercharger watch`** — Single-poll snapshot of free stalls at a saved Supercharger; --watch repeats every N seconds with JSON-lines transitions

  _Avoids the I-90 Issaquah queue at peak; pageable from an agent on a drive_

  ```bash
  tesla supercharger watch 1000 --free-stalls 2 --watch --json
  ```

### Security audit nobody else does
- **`keys audit`** — Lists every enrolled key with last-seen, role, form-factor; flags keys not seen >90d as stale candidates for removal

  _Security-minded owners worry about old phones and abandoned NFC cards still pairing with their car; this is the quarterly review_

  ```bash
  tesla keys audit --stale-after 90d --json
  ```

### Reachability mitigation
- **`doctor`** — Detects signed-command-required errors, classifies the vehicle as REST-friendly vs signed-command-required, prints tesla-control enrollment URL when needed

  _Tesla's 2024-2026 signed-command rollout is the #1 user-facing landmine for any Tesla CLI; this is the only one that surfaces it clearly_

  ```bash
  tesla doctor --json
  ```

## Discovery Signals

This CLI was generated with browser-observed traffic context.
- Capture coverage: 58 API entries from 60 total network entries
- Protocols: firebase (75% confidence), rest_json (75% confidence)
- Auth signals: bearer_token — headers: authorization; cookie — cookies: _abck, bm_sz; api_key — query: key
- Generation hints: browser_clearance_required, requires_browser_auth
- Candidate command ideas: create_auto_conditioning_start — Derived from observed POST /api/{id}/vehicles/5YJ3E1EA6XXXXXXXX/command/auto_conditioning_start traffic.; create_auto_conditioning_stop — Derived from observed POST /api/{id}/vehicles/5YJ3E1EA6XXXXXXXX/command/auto_conditioning_stop traffic.; create_diagnostic — Derived from observed POST /mobile-app/macgyver/diagnostic traffic.; create_door_lock — Derived from observed POST /api/{id}/vehicles/5YJ3E1EA6XXXXXXXX/command/door_lock traffic.; create_door_unlock — Derived from observed POST /api/{id}/vehicles/5YJ3E1EA6XXXXXXXX/command/door_unlock traffic.; create_fireperf:fetch — Derived from observed POST /v1/projects/tesla-prod/namespaces/fireperf:fetch traffic.; create_hermes — Derived from observed POST /api/{id}/vehicles/5YJ3E1EA6XXXXXXXX/jwt/hermes traffic.; create_keys — Derived from observed POST /api/{id}/users/keys traffic.

## Command Reference

**charging** — Supercharger queue position and charging status

- `tesla-pp-cli charging` — Current Supercharger queue position (which stall, ETA)

**diagnostics** — Vehicle diagnostic feature config

- `tesla-pp-cli diagnostics` — Vehicle diagnostic feature flags

**energy_sites** — Powerwall and solar energy site config

- `tesla-pp-cli energy_sites create-set-backup-reserve` — Set Powerwall backup reserve percent
- `tesla-pp-cli energy_sites create-set-operation` — Set Powerwall operation mode
- `tesla-pp-cli energy_sites get-calendar-history` — Historical energy data per day/month
- `tesla-pp-cli energy_sites get-live-status` — Real-time Powerwall solar/grid/battery power
- `tesla-pp-cli energy_sites get-rate-tariffs` — Utility rate plans for Powerwall scheduling
- `tesla-pp-cli energy_sites get-site-info` — Energy site config (capacity, type, address)
- `tesla-pp-cli energy_sites get-site-status` — Backup-reserve and operation mode

**logs** — Client-side telemetry sink

- `tesla-pp-cli logs` — Forward client-side log events (mostly internal use)

**notification_preferences** — Push notification settings

- `tesla-pp-cli notification_preferences` — Update push notification preferences

**products** — Vehicles, Powerwalls, and solar products owned by the user

- `tesla-pp-cli products` — List vehicles, Powerwalls, and solar products owned

**users** — Account config, feature flags, orders, and key/credential management

- `tesla-pp-cli users create-keys` — Add a virtual phone key or BLE key
- `tesla-pp-cli users get-app-config` — Mobile app feature flags and runtime config
- `tesla-pp-cli users get-feature-config` — Account-level feature gating
- `tesla-pp-cli users get-orders` — Tesla orders (new vehicle deliveries, accessory pu