Overview & Philosophy β
Welcome to ShellGuard, a sovereign zero-knowledge secrets vault designed from the ground up for humans and autonomous AI agents.
π‘οΈ Core Philosophy β
In traditional password managers, either all credentials are kept in a single browser extension unavailable to external automated processes, or cloud services require absolute trust in third-party server infrastructure.
ShellGuard solves this with three non-negotiable architectural anchors:
- Zero-Knowledge by Construction: The server mathematically cannot decrypt your secrets. Every password, TOTP seed, note, and file payload is sealed in your browser using AES-GCM-256 before leaving your computer.
- Sovereign Multi-User Support: Multiple users (lobsters) can coexist on a single self-hosted ShellGuard instance with complete cryptographic isolation.
- First-Class AI Agent Delegation: Instead of sharing your master password or unencrypted API keys with AI coding agents, you issue granular, revocable, rate-limited LobsterKeys (
lb-).
π The Three Encryption Layers β
text
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β LAYER 1 β ShellCryptionΒ©β’ (Client-Side, Zero-Knowledge, Always Active) β
β HKDF-SHA-256(hu- key, salt = uuid) β AES-GCM-256 β
β Seals: passwords, totp_secret, notes content, ssh keys, file_data β
β Server stores only {v, alg, iv, ct, aad} blobs. β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β LAYER 2 β Per-Row Metadata EncryptionΒ©β’ (Server-Side, AES-256-GCM) β
β HKDF-SHA-256(DB_ENCRYPTION_KEY, salt = uuid) β AES-256-GCM β
β Encrypts: title, username, url, category, notes, file_name in-place β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ€
β LAYER 3 β SQLCipher Whole-Database Encryption (At-Rest Bedrock) β
β Keys SQLite pages on disk via SQLCipher using DB_ENCRYPTION_KEY β
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ