Device Assistant 🔧

Personal device manager with error code lookup, troubleshooting, and maintenance tracking.

Features

• Device Registry: Track all devices with model, serial, purchase info
• Error Lookup: Instant error code explanations
• Troubleshooting: Step-by-step solutions
• Manual Links: Quick access to documentation
• Warranty Tracking: Know when warranties expire
• Maintenance Reminders: Filter changes, updates, etc.

Commands

| Command | Action | |---------|--------| | /device | List all devices or show status | | /device add | Add a new device (interactive) | | /device list [category] | List devices by category | | /device info <name> | Show device details | | /device error <name> <code> | Lookup error code | | /device help <name> <problem> | Troubleshoot a problem | | /device manual <name> | Get manual/documentation | | /device warranty | Show warranty status | | /device maintenance | Show maintenance schedule | | /device remove <name> | Remove a device |

Natural Language

The skill understands natural queries:

• "Mein Geschirrspüler zeigt E24"
• "Waschmaschine macht komische Geräusche"
• "Wo ist die Anleitung für den Thermomix?"
• "Wann läuft die Garantie vom TV aus?"

Device Categories

| Category | Examples | |----------|----------| | kitchen | Geschirrspüler, Kühlschrank, Backofen, Thermomix | | laundry | Waschmaschine, Trockner | | electronics | TV, Router, NAS, Computer | | climate | Heizung, Klimaanlage, Luftreiniger | | smart-home | Hue, Homematic, Sensoren | | software | Apps, Betriebssysteme, Lizenzen | | other | Alles andere |

Handler Commands

handler.sh status $WORKSPACE                     # Overview
handler.sh list [category] $WORKSPACE            # List devices
handler.sh add <json> $WORKSPACE                 # Add device
handler.sh info <device-id> $WORKSPACE           # Device details
handler.sh error <device-id> <code> $WORKSPACE   # Error lookup
handler.sh troubleshoot <device-id> <problem> $WS # Get help
handler.sh manual <device-id> $WORKSPACE         # Manual link
handler.sh warranty $WORKSPACE                   # Warranty overview
handler.sh maintenance $WORKSPACE                # Maintenance due
handler.sh update <device-id> <json> $WORKSPACE  # Update device
handler.sh remove <device-id> $WORKSPACE         # Remove device
handler.sh search <query> $WORKSPACE             # Search devices
handler.sh log <device-id> <note> $WORKSPACE     # Add maintenance log

Data Structure

Device Entry

{
  "id": "dishwasher-1",
  "name": "Geschirrspüler",
  "nickname": "Spüli",
  "category": "kitchen",
  "manufacturer": "Siemens",
  "model": "SN658X06TE",
  "serialNumber": "ABC123456",
  "purchaseDate": "2022-03-15",
  "purchasePrice": 899,
  "warranty": {
    "expires": "2025-03-15",
    "type": "manufacturer",
    "notes": "3 Jahre Siemens"
  },
  "manualUrl": "https://...",
  "supportUrl": "https://...",
  "location": "Küche",
  "notes": "Salz alle 2 Monate nachfüllen",
  "maintenance": [
    {"task": "Filter reinigen", "interval": "monthly", "lastDone": "2026-01-01"}
  ],
  "errorHistory": [],
  "addedAt": "2024-01-01"
}

Error Code Lookup

The skill searches for error codes using:

1. Built-in database for common manufacturers
2. Web search for specific model + error code
3. Manual extraction if manual URL is stored

Common Error Code Patterns

| Manufacturer | Pattern | Example | |--------------|---------|---------| | Siemens/Bosch | E + number | E24, E15 | | Miele | F + number | F11, F53 | | AEG | E + number | E10, E20 | | Samsung | Letters + numbers | UE, OE, LE | | LG | Letters | OE, IE, PE |

Example Session

User: Ich habe einen neuen Geschirrspüler

Bot: 🔧 Neues Gerät hinzufügen:
     
     Welche Infos hast du?
     • Hersteller?
     • Modell?
     • Seriennummer? (optional)
     • Kaufdatum?

User: Siemens SN658X06TE, gekauft am 15.3.2022

Bot: ✅ Gespeichert!
     
     📦 Geschirrspüler (Siemens SN658X06TE)
     📅 Gekauft: 15.03.2022
     🛡️ Garantie: bis 15.03.2025 (ABGELAUFEN)
     📄 Anleitung: [Link gefunden]
     
     Spitzname vergeben? (z.B. "Spüli")

User: Mein Geschirrspüler zeigt E24

Bot: 🔧 Siemens SN658X06TE — Fehler E24
     
     ⚠️ Bedeutung: Abpumpproblem
     Das Wasser wird nicht richtig abgepumpt.
     
     🔨 Lösung:
     1. Gerät ausschalten
     2. Sieb am Boden prüfen und reinigen
     3. Abflussschlauch auf Knicke prüfen
     4. Siphon-Anschluss kontrollieren
     5. Gerät neu starten
     
     📄 Details: Anleitung S. 45
     
     [Problem gelöst] [Weitere Hilfe]

Data Files

Stored in $WORKSPACE/memory/device-assistant/:

| File | Purpose | |------|---------| | devices.json | All registered devices | | error-history.json | Past errors and solutions | | maintenance-log.json | Maintenance history | | error-codes/ | Cached error code info |

Warranty Alerts

The skill can remind you before warranties expire:

⚠️ Garantie-Warnung:

Diese Geräte laufen bald ab:
• TV Samsung (noch 30 Tage)
• Waschmaschine (noch 45 Tage)

Tipp: Jetzt prüfen ob alles funktioniert!

Requirements

• jq (JSON processing)
• curl (web lookups)
• Internet for error code search