blob: cb6b8094225ebe317674fb9498e392af7bf57800 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
|
---
name: system-maintenance
description: How to reset, troubleshoot, and maintain the WebX11 terminal
tags: [system, maintenance, reset, troubleshoot, config]
category: system
---
## Steps
1. **Factory reset (wipes everything):**
- factory-reset --confirm — clears all webx11_ localStorage keys, resets VFS, reloads
- Use only when the system is in an unrecoverable state
2. **Soft VFS reset:**
- reset-vfs --confirm — clears only the filesystem, preserves settings/profile/modules
3. **Config management:**
- config-list — show all config keys and values
- config-set <key> <value> — set a config value
- config-delete <key> — remove a config key
- config-export — dump all config as JSON
- config-reset — restore defaults (use before factory-reset if you want to save data)
4. **Health checks (run automatically after complex tasks):**
- Check module loading status: loaded vs total
- Check for pending module edits
- Check memory usage (high if >100MB)
- Check skill count (0 skills after 2+ tool calls → suggest create_skill)
5. **Font size and display:**
- font-size <8-32> — set terminal font size, persists across sessions
- setfont — alias for font-size
6. **When to use:**
- System is slow or modules fail to load → check check_updates, memory
- User says "reset everything" → factory-reset --confirm
- User says "clear my files but keep settings" → reset-vfs --confirm
|
