SuperLobster Control Plane Overview
The SuperLobster Panel is the token-gated administrative plane for ShellGuard instance operators, accessible at the dedicated route /superlobster.
🦞 Architectural Heritage
The SuperLobster design is derived from a clean-room synthesis of the Vaultwarden admin model and ClawChives SuperAdmin architecture, hardened specifically for a zero-knowledge secrets vault:
| Project | Admin Model | Hardened Properties in ShellGuard |
|---|---|---|
| Vaultwarden | /admin (Argon2id / Token) | Online Backup API snapshots, offline file-swap restoration |
| ClawChives | /admin (Volatile in-memory sessions) | Ephemeral sg_admin_session cookie (20-min sliding expiry), cascade user deletions |
| ShellGuard | /superlobster (SuperLobster Panel) | Strict metadata responses, no backup download endpoint, no HTTP restore endpoint |
🔒 Security Hardening Invariants
- Zero Password Access: Even the instance administrator cannot read user passwords, notes, or private keys.
- Strict Metadata Only: Admin user listings return only UUIDs, usernames, item counts, and timestamps. Titles like "My Swiss Bank" are never visible.
- No Web-Based Backup Download: Backups are written server-side to
DATA_DIR/backups/. No HTTP download route exists, preventing credential exfiltration. - Offline Restorations: Restorations are performed offline at the shell level.
SuperLobster Sub-Sections
Transport & Pairing Hub
TLS status, zero-downtime certificate regeneration, mobile QR pairing, and single-use share signups.
Lobster Management
User table, storage counts, and atomic cascade deletions.
Backups Engine
Automated SQLite Online Backup API snapshots and rotation.
Offline Restoration
Step-by-step procedure using the scuttle:restore validator.