Skip to content

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:

  1. 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.
  2. Sovereign Multi-User Support: Multiple users (lobsters) can coexist on a single self-hosted ShellGuard instance with complete cryptographic isolation.
  3. 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            β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Next Steps ​

Sovereign Zero-Knowledge Secrets Vault. Released under AGPL-3.0. β€’ Privacy Policy