tesla-commander

# Tesla Commander

## What Is This?

A command-line interface for Tesla vehicle owners. Query your car's status, control climate and charging, lock/unlock doors, track location, and review trip history — all from a terminal or automation script.

Built on the **Tesla Fleet API** (the official successor to the Owner API).

## Before You Start

### Authentication

Tesla Fleet API uses OAuth 2.0. You need:

1. **Client ID & Secret** — Register an application at [developer.tesla.com](https://developer.tesla.com)
2. **Access Token** — Obtained via OAuth flow
3. **Vehicle ID** — Your car's API identifier

```bash
export TESLA_ACCESS_TOKEN="eyJ..."
export TESLA_VIN="5YJ3E1EA1NF000000"       # Optional: defaults to first vehicle
export TESLA_CLIENT_ID="your-client-id"      # For token refresh
export TESLA_CLIENT_SECRET="your-secret"     # For token refresh
```

### Token Management

The script includes built-in token refresh:

```bash
# Initial OAuth flow (opens browser for authorization)
bash scripts/tesla-cmd.sh auth login

# Refresh an expired token
bash scripts/tesla-cmd.sh auth refresh

# Check token validity
bash scripts/tesla-cmd.sh auth check
```

---

## Command Categories

### 1. Vehicle Status

Get a comprehensive snapshot of your vehicle's current state.

```bash
# Full vehicle data dump
bash scripts/tesla-cmd.sh status

# Specific subsystems
bash scripts/tesla-cmd.sh status battery      # Battery level, range, charging state
bash scripts/tesla-cmd.sh status climate      # Interior/exterior temp, HVAC settings
bash scripts/tesla-cmd.sh status drive        # Speed, heading, GPS coordinates
bash scripts/tesla-cmd.sh status vehicle      # Doors, windows, trunk, frunk status

# Quick summary (one-line output for scripting)
bash scripts/tesla-cmd.sh summary
# Output: Model3 | 78% | 241mi | Parked | 72°F | Home | Locked
```

### 2. Location & Tracking

```bash
# Current location with address
bash scripts/tesla-cmd.sh location

# Open location in default map applicatio...