roborock

# Roborock Vacuum Control

Control Roborock robot vacuums via the `roborock` CLI.

## First-Time Setup

### 1. Install CLI
```bash
pipx install python-roborock
```

### 2. Login to Roborock Account
```bash
roborock login
```
Enter your Roborock/Xiaomi Home app email and password.

### 3. Find Your Device ID
```bash
roborock list-devices
```
Note your device ID (looks like `AbCdEf123456789XyZ`).

### 4. Store Device ID (Optional)
Add to your TOOLS.md for easy reference:
```markdown
## Roborock Vacuum
- **Device ID:** your-device-id-here
- **Model:** Roborock S7 Max Ultra (or your model)
```

## Quick Commands

All commands need `--device_id "YOUR_DEVICE_ID"` — replace with your actual device ID.

### Check Status
```bash
roborock status --device_id "YOUR_DEVICE_ID"
```

### Start Cleaning
```bash
roborock command --device_id "YOUR_DEVICE_ID" start
```

### Stop/Pause
```bash
roborock command --device_id "YOUR_DEVICE_ID" stop
roborock command --device_id "YOUR_DEVICE_ID" pause
```

### Return to Dock
```bash
roborock command --device_id "YOUR_DEVICE_ID" home
```

### Clean Specific Room
First get room IDs:
```bash
roborock rooms --device_id "YOUR_DEVICE_ID"
```
Then clean specific rooms:
```bash
roborock command --device_id "YOUR_DEVICE_ID" segment_clean --rooms 16,17
```

## Maintenance Commands

### Check Consumables
```bash
roborock consumables --device_id "YOUR_DEVICE_ID"
```
Shows filter, brush, sensor lifespans.

### Reset Consumable
```bash
roborock reset-consumable filter --device_id "YOUR_DEVICE_ID"
roborock reset-consumable main_brush --device_id "YOUR_DEVICE_ID"
roborock reset-consumable side_brush --device_id "YOUR_DEVICE_ID"
```

### Last Clean Record
```bash
roborock clean-record --device_id "YOUR_DEVICE_ID"
```

### Clean Summary (All Time)
```bash
roborock clean-summary --device_id "YOUR_DEVICE_ID"
```

## Maps & Rooms

### Get Maps
```bash
roborock maps --device_id "YOUR_DEVICE_ID"
```

### Cache Home Layout
```bash
roborock home
```

### Save Map Ima...