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).
See secretspec/README.md for the upstream product,
providers, and quick start.
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-commandOpt-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.
| 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.