aboutsummaryrefslogtreecommitdiff
path: root/skills/webdav.md
diff options
context:
space:
mode:
Diffstat (limited to 'skills/webdav.md')
-rw-r--r--skills/webdav.md44
1 files changed, 44 insertions, 0 deletions
diff --git a/skills/webdav.md b/skills/webdav.md
new file mode 100644
index 0000000..c8b2dfc
--- /dev/null
+++ b/skills/webdav.md
@@ -0,0 +1,44 @@
+---
+name: webdav
+description: Configure, sync, backup, and restore VFS via WebDAV cloud storage.
+tags: [webdav, cloud, backup, sync, storage, vfs]
+category: system
+---
+
+## CRITICAL: VERIFY BEFORE EXECUTING
+**ALWAYS run `help <command>` first.** If `help <command>` returns nothing, the command does NOT exist. Never invent commands — terminal crashes.
+
+## 1. Configure & Status
+- `webdav-config` — configure WebDAV endpoint URL and credentials
+- `webdav-status` — verify connection health, last sync, space info
+
+## 2. File Operations
+
+| Command | Purpose |
+|---------|---------|
+| `webdav-ls [path]` | List remote directory contents |
+| `webdav-push <local> <remote>` | Upload file to WebDAV |
+| `webdav-pull <remote> [local]` | Download file from WebDAV |
+
+## 3. Backup & Restore
+- `webdav-backup` — push full VFS snapshot to WebDAV (`/backups/newos4-<date>.json`)
+- `webdav-backup-list` — list all remote backup snapshots
+- `webdav-restore <filename>` — restore VFS from remote backup
+
+## 4. What Does NOT Exist
+These will crash the terminal:
+- `webdav-browser` ❌
+- `webdav-explorer` ❌
+- `webdav-delete` ❌
+- `webdav-rm` ❌
+
+Since `curl` is also blocked, no automated way to delete WebDAV backups from the terminal — use the WebDAV web interface outside.
+
+## 5. When to Use
+- Before factory-reset: `webdav-backup` to store VFS remotely
+- Cross-browser: `webdav-push`/`webdav-pull` to move files
+- User says "cloud backup" or "remote save"
+
+## 6. Connection Details
+- Uses per-user token stored in `.token` file on the server
+- WebDAV runs on same server (nginx with WebDAV module) — no external dependency \ No newline at end of file