{
  "name": "system-maintenance",
  "description": "How to reset, troubleshoot, and maintain the WebX11 terminal",
  "tags": [
    "system",
    "maintenance",
    "reset",
    "troubleshoot",
    "config"
  ],
  "category": "system",
  "created": "2026-07-06T00:13:29.403Z",
  "updated": "2026-07-06T00:13:29.403Z",
  "content": "---\nname: system-maintenance\ndescription: How to reset, troubleshoot, and maintain the WebX11 terminal\ntags: [system, maintenance, reset, troubleshoot, config]\ncategory: system\n---\n## Steps\n1. **Factory reset (wipes everything):**\n   - factory-reset --confirm — clears all webx11_ localStorage keys, resets VFS, reloads\n   - Use only when the system is in an unrecoverable state\n\n2. **Soft VFS reset:**\n   - reset-vfs --confirm — clears only the filesystem, preserves settings/profile/modules\n\n3. **Config management:**\n   - config-list — show all config keys and values\n   - config-set <key> <value> — set a config value\n   - config-delete <key> — remove a config key\n   - config-export — dump all config as JSON\n   - config-reset — restore defaults (use before factory-reset if you want to save data)\n\n4. **Security level:**\n   - security-level <0-3> — set security level (0=Permissive, 1=Standard, 2=Paranoid, 3=Audit)\n   - security — show current security level, blocked count, and stats\n   - cmd-allow <cmd> — whitelist a command from security checks\n   - cmd-deny <cmd> — blacklist a command\n\n5. **Health checks (run automatically after complex tasks):**\n   - Check module loading status: loaded vs total\n   - Check for pending module edits\n   - Check memory usage (high if >100MB)\n   - Check skill count (0 skills after 2+ tool calls → suggest create_skill)\n   - health-check — full audit: VFS size, modules, logs, trash, skills, tool failures\n\n6. **Font size and display:**\n   - font-size <8-32> — set terminal font size, persists across sessions\n   - setfont — alias for font-size\n\n7. **Checkpoints:**\n   - checkpoint [name] — snapshot current VFS state\n   - checkpoint-list — list all checkpoints\n   - rollback <name> — restore from checkpoint\n\n8. **When to use:**\n   - System is slow or modules fail to load → check check_updates, mem\n   - User says \"reset everything\" → factory-reset --confirm\n   - User says \"clear my files but keep settings\" → reset-vfs --confirm\n   - User reports security concerns → security-level or cmd-allow/cmd-deny"
}