SPB Git

Repository Public

README.md 2.5 KB

# 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

text
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 manifest

# Develop

bash
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/web

Local 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.

Files main
Menu

Theme