SP Vault
Self-hosted, end-to-end encrypted password manager and secrets platform — https://vault.spboucher.ai — with a web app, native macOS and iOS apps (Swift/SwiftUI) and a separate, clearly labelled managed-secrets subsystem for services and AI agents.
Status: built and tested, not independently audited. Read SECURITY.md before trusting it with anything.
| Read | For |
|---|---|
SECURITY.md |
Guarantees, explicit limits, verification status, launch gates |
THREAT_MODEL.md |
Adversaries and residual risks |
docs/crypto-spec/SPV1.md |
The protocol: key hierarchy, envelopes, pairing, recovery, rollback limits |
docs/architecture/ADR.md, openapi.yaml |
Decisions and the API |
docs/recovery/RECOVERY.md |
Recovery kit, rotation, rekey, restore drill |
docs/operations/OPERATIONS.md |
MacLustr deployment, backups, RPO/RTO, incidents |
services/managed-secrets/THREAT_MODEL.md |
Connect / Agents (not zero-knowledge) |
Layout
packages/protocol/ SPV1 in TypeScript (WebCrypto + @hpke/core), items, generator, TOTP, URL matching, import/export
packages/crypto-test-vectors/ vectors produced by TypeScript and by Swift, verified by both
packages/agent-client/ signed-request client for workloads and agents
services/api/ Fastify + PostgreSQL: auth (passkeys), devices, sync, attachments, relay, audit, Connect
services/managed-secrets/ isolated process holding the managed-secret key; brokered HTTP / HMAC operations
apps/web/ React web vault (engine in src/core, UI in src/ui)
apple/SharedVaultKit/ SPV1 in Swift (CryptoKit, Secure Enclave), models, client engine
apple/App, apple/AutoFill macOS + iOS apps and credential-provider extensions (xcodegen)
tests/integration, security, e2e real server + real PostgreSQL; nothing is mocked
infrastructure/ mld manifestDevelop
pnpm install # exact pins, install scripts disabled
createdb -h 127.0.0.1 sp_vault_test
pnpm test:unit && pnpm test:int && pnpm test:security
(cd apple/SharedVaultKit && swift test)
pnpm build # dist/server.mjs, dist/cli.mjs, dist/managed.mjs, dist/webLocal run: DATABASE_URL=postgres://127.0.0.1/sp_vault_dev SPV_ORIGIN=http://localhost:8740 SPV_RP_ID=localhost SPV_DATA_DIR=.data SPV_WEB_DIR=dist/web node dist/server.mjs,
then node dist/cli.mjs invite --for me (same environment) prints a join link.