SPB Git

Repository Public

17 entries at the root
History

Latest commit Native macOS and iOS apps, AutoFill credential-provider extensions, release scripts, test report 40ea6ef

NameLast commitUpdated
apple Native macOS and iOS apps, AutoFill credential-provider extensions, release scripts, test report
apps Swift client engine + interop tests; fix lost edit on interrupted conflict, wrong-account...
docs SharedVaultKit (Swift SPV1 + models), cross-language vectors, ops scripts, OpenAPI, spec...
infrastructure SharedVaultKit (Swift SPV1 + models), cross-language vectors, ops scripts, OpenAPI, spec...
packages Web application, browser tests, static header fix, engine fixes from review
scripts SharedVaultKit (Swift SPV1 + models), cross-language vectors, ops scripts, OpenAPI, spec...
services Swift client engine + interop tests; fix lost edit on interrupted conflict, wrong-account...
tests Swift client engine + interop tests; fix lost edit on interrupted conflict, wrong-account...
.gitignore SharedVaultKit (Swift SPV1 + models), cross-language vectors, ops scripts, OpenAPI, spec...
.npmrc SP Vault: threat model, SPV1 protocol, API server, client engine, integration tests
package.json SP Vault: threat model, SPV1 protocol, API server, client engine, integration tests
pnpm-lock.yaml SP Vault: threat model, SPV1 protocol, API server, client engine, integration tests
README.md App icon, Apple provisioning script, README
SECURITY.md Connect/Agents subsystem, managed-secrets process, security and property tests, security docs
THREAT_MODEL.md Swift client engine + interop tests; fix lost edit on interrupted conflict, wrong-account...
tsconfig.json SP Vault: threat model, SPV1 protocol, API server, client engine, integration tests
vite.config.ts Connect/Agents subsystem, managed-secrets process, security and property tests, security docs
README.md View source

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

Clone sp-vault

Anonymous clone and fetch. Pushing requires the owner's personal access token.

Snapshot of main

Files main
Menu

Theme