Tesla Control via Tessie

Control and monitor Tesla vehicles via the Tessie API. Use when you need to check Tesla status (battery, location, charging), control climate (heat/cool), lock/unlock doors, start/stop charging, honk/flash lights, open charge port or trunks, or any other Tesla vehicle command. Requires TESSIE_API_KEY environment variable.

Security Scan

The skill's code and README consistently require a TESSIE_API_KEY and offer direct vehicle control (which matches the stated purpose), but the registry metadata omits the required credential and primaryEnv information — an incoherence you should resolve before trusting installation.

Purpose & Capability

The skill name, SKILL.md, reference docs, and included Python scripts all match the stated purpose (controlling a Tesla via the Tessie API). The actions implemented (lock/unlock, climate, charge, software updates, location, etc.) are coherent with the description.

Instruction Scope

Runtime instructions and scripts are limited to calling the Tessie API and using the TESSIE_API_KEY environment variable. The SKILL.md does not instruct reading unrelated system files or exfiltrating data to unexpected endpoints; all network calls target api.tessie.com per the reference doc.

Install Mechanism

There is no install spec (instruction-only), which is low risk; scripts require Python 'requests' (SKILL.md tells user to pip install requests). One minor inconsistency: code files are bundled but no install/packaging step is provided — acceptable but worth noting.

Credentials

The skill requires a TESSIE_API_KEY (declared in SKILL.md and used directly by both scripts) but the registry metadata lists 'Required env vars: none' and 'Primary credential: none'. That mismatch is significant: the skill will need a bearer token with control permissions for vehicles, and the registry should declare this explicitly. No other unrelated credentials are requested.

Persistence & Privilege

The skill does not request permanent/always-on inclusion (always:false) and does not attempt to modify other skills or system-wide settings. It can be invoked autonomously by the agent (default platform behavior) — because this skill can issue remote vehicle commands, allow autonomous invocation only with explicit user consent.

What to consider before installing

This skill implements exactly what it claims (remote Tesla control via Tessie) but the registry metadata incorrectly omits the required TESSIE_API_KEY. Before installing: (1) confirm the registry entry is updated to declare TESSIE_API_KEY as the primary credential; (2) review the included scripts to ensure no modifications are needed for your environment (they call https://api.tessie.com and read TESSIE_API_KEY from the environment); (3) ensure the API key you provide has the minimum scope needed and be prepared to rotate/revoke it if needed; (4) consider limiting the agent's autonomous use of this skill (so it cannot issue remote lock/unlock/fart/honk commands without your explicit approval); and (5) if you don't trust the skill owner, run the scripts in an isolated environment (or inspect and run locally) rather than granting platform-level access. If the registry maintainer cannot explain/fix the missing env metadata, treat the omission as a red flag and do not install.

Control Tesla vehicles using the Tessie API through Python scripts.

Prerequisites

Python 3 with requests library:

pip install requests

Set the TESSIE_API_KEY environment variable with your Tessie API key from https://my.tessie.com/settings/api

# Linux/macOS
export TESSIE_API_KEY="your-api-key-here"

# Windows (PowerShell)
$env:TESSIE_API_KEY = "your-api-key-here"

# Windows (cmd)
set TESSIE_API_KEY=your-api-key-here

For persistent storage, add to your shell profile (.bashrc, .zshrc, PowerShell profile, etc.).

Common Commands

All commands use the scripts/tessie.py script. Most commands require a VIN (Vehicle Identification Number).

Get Vehicle List

python scripts/tessie.py vehicles

Returns all vehicles associated with your Tessie account with their VINs.

Check Status

python scripts/tessie.py status --vin <VIN>

Returns comprehensive vehicle status including battery, location, climate, charging state, and more.

Battery Info

python scripts/tessie.py battery --vin <VIN>

Returns battery level, range, and charging information.

Location

python scripts/tessie.py location --vin <VIN>

Returns current vehicle location (latitude, longitude, heading).

Lock & Unlock

python scripts/tessie.py lock --vin <VIN>
python scripts/tessie.py unlock --vin <VIN>

Climate Control

# Start climate
python scripts/tessie.py start_climate --vin <VIN>

# Stop climate
python scripts/tessie.py stop_climate --vin <VIN>

# Set temperature (Celsius)
python scripts/tessie.py set_temperature --vin <VIN> --value 22

Charging

# Start charging
python scripts/tessie.py start_charging --vin <VIN>

# Stop charging
python scripts/tessie.py stop_charging --vin <VIN>

# Set charge limit (0-100)
python scripts/tessie.py set_charge_limit --vin <VIN> --value 80

# Open/close charge port
python scripts/tessie.py open_charge_port --vin <VIN>
python scripts/tessie.py close_charge_port --vin <VIN>

Honk, Flash & Fart

python scripts/tessie.py honk --vin <VIN>
python scripts/tessie.py flash --vin <VIN>
python scripts/tessie.py fart --vin <VIN>

Note: Fart requires firmware 2022.40.25 or newer.

Trunks

python scripts/tessie.py open_frunk --vin <VIN>
python scripts/tessie.py open_trunk --vin <VIN>

Software Updates

# Schedule update immediately
python scripts/tessie.py schedule_update --vin <VIN>

# Schedule update in 2 hours (7200 seconds)
python scripts/tessie.py schedule_update --vin <VIN> --value 7200

# Cancel scheduled update
python scripts/tessie.py cancel_update --vin <VIN>

# Check for available updates
python scripts/check-updates.py --vin <VIN>

The check-updates script returns one of:

• UPDATE_AVAILABLE: Software update X.X.X is ready to install!
• UPDATE_DOWNLOADING: Downloading update X.X.X (XX%)
• UPDATE_INSTALLING: Installing update X.X.X (XX%)
• UPDATE_SCHEDULED: Update X.X.X is scheduled
• NO_UPDATE

Wake Vehicle

If the vehicle is asleep, wake it first:

python scripts/tessie.py wake --vin <VIN>

Automatic Update Notifications

To get notified when software updates are available, set up a cron job:

# Check for updates every 6 hours and notify if available
cron add \
  --schedule "0 */6 * * *" \
  --text "Check my Tesla for software updates and notify me if one is available" \
  --description "Tesla software update check"

When an update is available, you'll get a notification with the version number.

Workflow

1. First time: Get VIN with vehicles action
2. For most commands: Use the VIN to target specific vehicle
3. If vehicle is asleep: Use wake first, then retry command
4. Check status with status, battery, or location as needed

Reference

For complete API documentation, see references/api.md.