Pp Tesla

<!-- 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:

   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.6 or newer):

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

  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

  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

  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

  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

  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

  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

  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

  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 purchases)

vehicles — Per-vehicle data, climate, locks, remote start, and Hermes telemetry token

• tesla-pp-cli vehicles create-actuate-trunk — Open/close trunk or frunk; which_trunk = front | rear
• tesla-pp-cli vehicles create-add-charge-schedule — Add a charging schedule (location + time window)
• tesla-pp-cli vehicles create-add-precondition-schedule — Add a preconditioning schedule
• tesla-pp-cli vehicles create-adjust-volume — Set volume to specific level
• tesla-pp-cli vehicles create-auto-conditioning-start — POST /api/1/vehicles/{vehicle_id}/command/auto_conditioning_start
• tesla-pp-cli vehicles create-auto-conditioning-stop — POST /api/1/vehicles/{vehicle_id}/command/auto_conditioning_stop
• tesla-pp-cli vehicles create-bioweapon-mode — Toggle bioweapon defense mode (HEPA recirculation)
• tesla-pp-cli vehicles create-cancel-software-update — Cancel pending software update
• tesla-pp-cli vehicles create-charge-max-range — Set charge limit to Max Range (100%)
• tesla-pp-cli vehicles create-charge-port-door-close — Close the charge port
• tesla-pp-cli vehicles create-charge-port-door-open — Open the charge port
• tesla-pp-cli vehicles create-charge-standard — Set charge limit to Standard (~90%)
• tesla-pp-cli vehicles create-charge-start — Start charging
• tesla-pp-cli vehicles create-charge-stop — Stop charging
• tesla-pp-cli vehicles create-climate-keeper-mode — Climate keeper mode: 0=off, 1=on, 2=dog, 3=camp
• tesla-pp-cli vehicles create-door-lock — POST /api/1/vehicles/{vehicle_id}/command/door_lock
• tesla-pp-cli vehicles create-door-unlock — POST /api/1/vehicles/{vehicle_id}/command/door_unlock
• tesla-pp-cli vehicles create-erase-user-data — Erase guest-session user data
• tesla-pp-cli vehicles create-flash-lights — Flash headlights
• tesla-pp-cli vehicles create-guest-mode — Enable/disable Guest mode
• tesla-pp-cli vehicles create-hermes — POST /api/1/vehicles/{vehicle_id}/jwt/hermes
• tesla-pp-cli vehicles create-honk-horn — Honk the horn
• tesla-pp-cli vehicles create-max-defrost — Toggle max defrost
• tesla-pp-cli vehicles create-media-next-favorite — Next favorite station
• tesla-pp-cli vehicles create-media-next-track — Next track
• tesla-pp-cli vehicles create-media-prev-favorite — Previous favorite station
• tesla-pp-cli vehicles create-media-prev-track — Previous track
• tesla-pp-cli vehicles create-media-toggle-playback — Toggle play/pause
• tesla-pp-cli vehicles create-media-volume-down — Volume down
• tesla-pp-cli vehicles create-media-volume-up — Volume up
• tesla-pp-cli vehicles create-navigation-gps-request — Send lat/lng directly to navigation
• tesla-pp-cli vehicles create-remote-start-drive — POST /api/1/vehicles/{vehicle_id}/command/remote_start_drive
• tesla-pp-cli vehicles create-remove-charge-schedule — Remove charging schedule by id
• tesla-pp-cli vehicles create-remove-precondition-schedule — Remove preconditioning schedule by id
• tesla-pp-cli vehicles create-reset-valet-pin — Reset Valet PIN
• tesla-pp-cli vehicles create-schedule-software-update — Schedule the pending software update
• tesla-pp-cli vehicles create-seat-heater-request — Set seat heater level (0-3) at a seat position (0=driver, 1=passenger, 2-5=rear)
• tesla-pp-cli vehicles create-set-charge-limit — Set charge limit percent (50-100)
• tesla-pp-cli vehicles create-set-charging-amps — Set charging amps draw
• tesla-pp-cli vehicles create-set-sentry-mode — Enable/disable Sentry mode
• tesla-pp-cli vehicles create-set-temps — Set driver and passenger climate temps (Celsius)
• tesla-pp-cli vehicles create-set-valet-mode — Enable/disable Valet mode with optional PIN
• tesla-pp-cli vehicles create-share — Send navigation destination to the car (address or coordinates)
• tesla-pp-cli vehicles create-speed-limit-activate — Activate Speed Limit mode
• tesla-pp-cli vehicles create-speed-limit-clear-pin — Clear Speed Limit PIN
• tesla-pp-cli vehicles create-speed-limit-deactivate — Deactivate Speed Limit mode
• tesla-pp-cli vehicles create-speed-limit-set-limit — Set Speed Limit value (mph)
• tesla-pp-cli vehicles create-steering-wheel-heater-request — Toggle steering wheel heater
• tesla-pp-cli vehicles create-sun-roof-control — Sun roof: state = vent | close
• tesla-pp-cli vehicles create-trigger-homelink — Trigger HomeLink garage door
• tesla-pp-cli vehicles create-wake-up — Wake the vehicle from sleep
• tesla-pp-cli vehicles create-window-control — Vent or close all windows; command = vent | close
• tesla-pp-cli vehicles get-compose-image — Compose a rendered image of the configured vehicle
• tesla-pp-cli vehicles get-data-charge-state — Charge state subset (faster than full vehicle_data)
• tesla-pp-cli vehicles get-data-climate-state — Climate state subset
• tesla-pp-cli vehicles get-data-drive-state — Drive state (location, speed, shift) subset
• tesla-pp-cli vehicles get-data-gui-settings — GUI settings (units, time format)
• tesla-pp-cli vehicles get-data-vehicle-config — Vehicle config (model, options, trim)
• tesla-pp-cli vehicles get-data-vehicle-state — Vehicle state (locks, software, sentry) subset
• tesla-pp-cli vehicles get-mobile-enabled — Is mobile control enabled in the car
• tesla-pp-cli vehicles get-nearby-chargers — Nearby Supercharger sites with stall availability subfield
• tesla-pp-cli vehicles get-release-notes — Release notes for the current/queued software update
• tesla-pp-cli vehicles get-service-data — Open service appointments and recent service history for this vehicle
• tesla-pp-cli vehicles get-vehicle-data — Full vehicle state snapshot: charge, climate, drive, GUI, vehicle config, and software

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

tesla-pp-cli which "<capability in your own words>"

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

Snap then ready

tesla snap --all --json && tesla ready 5YJ3E1EA6XXXXXXXX --json

Capture vehicle state for every car on the account, then check whether your primary vehicle is ready to drive.

Morning ready check

tesla ready 5YJ3E1EA6XXXXXXXX --json --select ready,blockers

One JSON object: is the car ready to drive, and if not, why not. Use --select to limit response size for agents.

Monthly charging-cost report

tesla cost ledger --since 30d --group supercharger,home --json --select total_usd,sessions,kwh_added,supercharger_ratio

Per-month breakdown with dotted-path --select so the agent sees only the rollup fields, not every session.