| name | setup |
| description | Set up tesla-cli — install, authenticate with Tesla, discover your VIN, and configure your backend. Use for first-time setup or reconfiguration.
|
| disable-model-invocation | true |
| allowed-tools | Bash(uv *) Bash(tesla *) Bash(which *) Bash(pip *) |
| level | 2 |
Tesla CLI Setup
Guide the user through installing and configuring tesla-cli.
Step 1: Check Prerequisites
python3 --version
which uv
If uv is not installed:
curl -LsSf https://astral.sh/uv/install.sh | sh
Step 2: Install tesla-cli
uv tool install tesla-cli
With optional features:
uv tool install "tesla-cli[serve]"
uv tool install "tesla-cli[teslaMate]"
uv tool install "tesla-cli[fleet]"
uv tool install "tesla-cli[pdf]"
uv tool install "tesla-cli[serve,teslaMate,fleet,pdf]"
Step 3: Interactive Setup
tesla setup
The setup wizard handles:
- Tesla OAuth2 authentication — opens browser, user logs in, pastes redirect URL
- VIN auto-discovery — finds your Tesla(s) automatically
- Order number detection — finds active orders if any
- Backend selection — Owner API (free), Tessie ($13/mo), or Fleet API (free)
- First data build — queries all 15 data sources
Step 4: Verify
tesla config show
tesla vehicle list
tesla charge status --oneline
Step 5 (Optional): Additional Setup
Notifications
tesla notify add tgram://BOT_TOKEN/CHAT_ID
tesla notify add discord://webhook_id/token
tesla notify test
TeslaMate Analytics
tesla teslaMate install
tesla teslaMate connect postgresql://user:pass@host:5432/teslamate
Multi-Vehicle
tesla config alias modely VIN1
tesla config alias model3 VIN2
Response Guidelines
- Check what's already installed/configured before suggesting steps
- Run
which tesla and tesla config show --json first to assess current state
- Skip steps that are already done
- Celebrate when setup is complete — the user is about to control their Tesla from the terminal!