Skip to content

Latest commit

 

History

History
46 lines (35 loc) · 2.05 KB

README.downstream.md

File metadata and controls

46 lines (35 loc) · 2.05 KB

frdminc/sudo-secretspec

Downstream fork of cachix/secretspec with an optional privilege-separated companion for autonomous local AI/operator use on macOS and Linux (Debian and other non-NixOS systems through the imperative installer, NixOS through the services.sudo-secretspec module).

Upstream SecretSpec

See secretspec/README.md for the upstream product, providers, and quick start.

Downstream companion: sudo-secretspec

This fork adds sudo-secretspec: a single Rust binary that mediates all credential CRUD/use through a privilege-separated broker, fail-closed value-free audit, and metadata-only doctor checks.

sudo-secretspec install                 # prompts / auto-detects when possible
sudo-secretspec run --reason "start app" -- your-command

Vault backup and recovery (0.21.1-sudo.6+, macOS)

Opt-in encrypted Git snapshots preserve the whole vault and its internal history outside the live store, with an SSH mirror and indefinite retention. The new sudo-secretspec backup status, backup run, and backup restore commands expose health, authenticated capture, and isolated recovery. doctor reports missing or unhealthy protection as advisories. This feature is unreleased and requires 0.21.1-sudo.6+; see the backup guide. Setup is explicit, never a Homebrew side effect.

Where things are documented

Topic File
Companion install, usage, installed paths, security model sudo-secretspec/README.md
AI/automation policy contract sudo-secretspec/AI-GUIDANCE.md
Distributable AI skill skills/sudo-secretspec/SKILL.md
Fork development notes, build lessons FORK-AI.md
Release process and Homebrew packaging packaging/README.md
Downstream version scheme CLAUDE.md

All downstream work lives on sudo-main. main is the upstream mirror only.