device-assistant

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