Commands
obscuro init
Initialize an Obscuro vault in the current git repository
Usage
obscuro initSets up the .obscuro/ directory at your git repo root.
What Happens
- You pick a master password (with confirmation)
- Obscuro generates a random salt
- Derives a key using Argon2id
- Encrypts a verification token (
"obscuro-verify") - Writes
.obscuro/config.jsonwith the salt and token - Creates an empty
.obscuro/secrets.json - Asks if you'd like to save the password in your OS keychain
The offer now launches the full backend selector, letting you choose between the OS keychain and a managed password file at ~/.config/obscuro/vaults/<hash>.pw. You can also skip and run obscuro auth store later to set or change your backend.
Files Created
.obscuro/config.json— salt + verification token (mode 0600).obscuro/secrets.json— where your secrets go (mode 0600).obscuro/directory (mode 0700)
Example
$ obscuro init
Enter master password:
Confirm master password:
Vault initialized at .obscuro/
Store password for future use? [Y/n]: Y
[Use ↑/↓ to navigate, enter to select]
[✓] OS keychain — ready
[✓] managed file — ready — writes to ~/.config/obscuro/vaults/a1b2c3d4.pw