Obscuro
Commands

obscuro init

Initialize an Obscuro vault in the current git repository

Usage

obscuro init

Sets up the .obscuro/ directory at your git repo root.

What Happens

  1. You pick a master password (with confirmation)
  2. Obscuro generates a random salt
  3. Derives a key using Argon2id
  4. Encrypts a verification token ("obscuro-verify")
  5. Writes .obscuro/config.json with the salt and token
  6. Creates an empty .obscuro/secrets.json
  7. 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

On this page