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:
- Built-in database for common manufacturers
- Web search for specific model + error code
- 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
1---2name: device-assistant3description: Personal device and appliance manager with error code lookup and troubleshooting. Tracks all your devices (appliances, electronics, software) with model numbers, manuals, and warranty info. When something breaks, tell it the error code and get instant solutions. Use when: device shows error, need manual, warranty check, adding new device, maintenance reminder. Triggers: /device, /geräte, 'mein Geschirrspüler', 'Fehler E24', 'Fehlermeldung', device problems, appliance issues.4license: MIT5---6
7# Device Assistant 🔧
8
9Personal device manager with error code lookup, troubleshooting, and maintenance tracking.
10
11## Features
12
13- **Device Registry**: Track all devices with model, serial, purchase info
14- **Error Lookup**: Instant error code explanations
15- **Troubleshooting**: Step-by-step solutions
16- **Manual Links**: Quick access to documentation
17- **Warranty Tracking**: Know when warranties expire
18- **Maintenance Reminders**: Filter changes, updates, etc.
19
20## Commands
21
22| Command | Action |
23|---------|--------|
24| `/device` | List all devices or show status |
25| `/device add` | Add a new device (interactive) |
26| `/device list [category]` | List devices by category |
27| `/device info <name>` | Show device details |
28| `/device error <name> <code>` | Lookup error code |
29| `/device help <name> <problem>` | Troubleshoot a problem |
30| `/device manual <name>` | Get manual/documentation |
31| `/device warranty` | Show warranty status |
32| `/device maintenance` | Show maintenance schedule |
33| `/device remove <name>` | Remove a device |
34
35## Natural Language
36
37The skill understands natural queries:
38
39- *"Mein Geschirrspüler zeigt E24"*
40- *"Waschmaschine macht komische Geräusche"*
41- *"Wo ist die Anleitung für den Thermomix?"*
42- *"Wann läuft die Garantie vom TV aus?"*
43
44## Device Categories
45
46| Category | Examples |
47|----------|----------|
48| `kitchen` | Geschirrspüler, Kühlschrank, Backofen, Thermomix |
49| `laundry` | Waschmaschine, Trockner |
50| `electronics` | TV, Router, NAS, Computer |
51| `climate` | Heizung, Klimaanlage, Luftreiniger |
52| `smart-home` | Hue, Homematic, Sensoren |
53| `software` | Apps, Betriebssysteme, Lizenzen |
54| `other` | Alles andere |
55
56## Handler Commands
57
58```bash
59handler.sh status $WORKSPACE # Overview
60handler.sh list [category] $WORKSPACE # List devices
61handler.sh add <json> $WORKSPACE # Add device
62handler.sh info <device-id> $WORKSPACE # Device details
63handler.sh error <device-id> <code> $WORKSPACE # Error lookup
64handler.sh troubleshoot <device-id> <problem> $WS # Get help
65handler.sh manual <device-id> $WORKSPACE # Manual link
66handler.sh warranty $WORKSPACE # Warranty overview
67handler.sh maintenance $WORKSPACE # Maintenance due
68handler.sh update <device-id> <json> $WORKSPACE # Update device
69handler.sh remove <device-id> $WORKSPACE # Remove device
70handler.sh search <query> $WORKSPACE # Search devices
71handler.sh log <device-id> <note> $WORKSPACE # Add maintenance log
72```
73
74## Data Structure
75
76### Device Entry
77
78```json
79{
80 "id": "dishwasher-1",
81 "name": "Geschirrspüler",
82 "nickname": "Spüli",
83 "category": "kitchen",
84 "manufacturer": "Siemens",
85 "model": "SN658X06TE",
86 "serialNumber": "ABC123456",
87 "purchaseDate": "2022-03-15",
88 "purchasePrice": 899,
89 "warranty": {
90 "expires": "2025-03-15",
91 "type": "manufacturer",
92 "notes": "3 Jahre Siemens"
93 },
94 "manualUrl": "https://...",
95 "supportUrl": "https://...",
96 "location": "Küche",
97 "notes": "Salz alle 2 Monate nachfüllen",
98 "maintenance": [
99 {"task": "Filter reinigen", "interval": "monthly", "lastDone": "2026-01-01"}
100 ],
101 "errorHistory": [],
102 "addedAt": "2024-01-01"
103}
104```
105
106## Error Code Lookup
107
108The skill searches for error codes using:
109
1101. **Built-in database** for common manufacturers
1112. **Web search** for specific model + error code
1123. **Manual extraction** if manual URL is stored
113
114### Common Error Code Patterns
115
116| Manufacturer | Pattern | Example |
117|--------------|---------|---------|
118| Siemens/Bosch | E + number | E24, E15 |
119| Miele | F + number | F11, F53 |
120| AEG | E + number | E10, E20 |
121| Samsung | Letters + numbers | UE, OE, LE |
122| LG | Letters | OE, IE, PE |
123
124## Example Session
125
126```
127User: Ich habe einen neuen Geschirrspüler
128
129Bot: 🔧 Neues Gerät hinzufügen:
130
131 Welche Infos hast du?
132 • Hersteller?
133 • Modell?
134 • Seriennummer? (optional)
135 • Kaufdatum?
136
137User: Siemens SN658X06TE, gekauft am 15.3.2022
138
139Bot: ✅ Gespeichert!
140
141 📦 Geschirrspüler (Siemens SN658X06TE)
142 📅 Gekauft: 15.03.2022
143 🛡️ Garantie: bis 15.03.2025 (ABGELAUFEN)
144 📄 Anleitung: [Link gefunden]
145
146 Spitzname vergeben? (z.B. "Spüli")
147```
148
149```
150User: Mein Geschirrspüler zeigt E24
151
152Bot: 🔧 Siemens SN658X06TE — Fehler E24
153
154 ⚠️ Bedeutung: Abpumpproblem
155 Das Wasser wird nicht richtig abgepumpt.
156
157 🔨 Lösung:
158 1. Gerät ausschalten
159 2. Sieb am Boden prüfen und reinigen
160 3. Abflussschlauch auf Knicke prüfen
161 4. Siphon-Anschluss kontrollieren
162 5. Gerät neu starten
163
164 📄 Details: Anleitung S. 45
165
166 [Problem gelöst] [Weitere Hilfe]
167```
168
169## Data Files
170
171Stored in `$WORKSPACE/memory/device-assistant/`:
172
173| File | Purpose |
174|------|---------|
175| `devices.json` | All registered devices |
176| `error-history.json` | Past errors and solutions |
177| `maintenance-log.json` | Maintenance history |
178| `error-codes/` | Cached error code info |
179
180## Warranty Alerts
181
182The skill can remind you before warranties expire:
183
184```
185⚠️ Garantie-Warnung:
186
187Diese Geräte laufen bald ab:
188• TV Samsung (noch 30 Tage)
189• Waschmaschine (noch 45 Tage)
190
191Tipp: Jetzt prüfen ob alles funktioniert!
192```
193
194## Requirements
195
196- `jq` (JSON processing)
197- `curl` (web lookups)
198- Internet for error code search
modbender