Skip to content

CedrickGD/Vault-X

Repository files navigation

VaultX

TL;DR: A local, single-user password manager built in PowerShell. Encrypted JSON vaults live in your profile, and you can manage them through either the terminal menu or a local Windows GUI. Auto-detects new vault files dropped into the data folder. 🔐⚡

Features

  • Local-only vaults stored under your user profile (no cloud sync).
  • AES encryption with per-vault salt and password-derived key.
  • Encrypt-then-MAC integrity (HMAC-SHA256) to detect tampering or corruption.
  • Menu-driven UI with fast navigation and a reliable back option.
  • Optional local Windows GUI mode with vault browser, entry editor, CSV import, export, 2FA, and recovery controls.
  • Persistent GUI theme toggle with dark and light modes.
  • GUI entry details open on demand and show full stored fields while masking passwords by default.
  • Add, view, edit, and delete entries for logins, URLs, and notes.
  • Built-in password generator in the entry editor plus /gen shortcut support in terminal prompts.
  • Search plus quick clipboard copy for entry fields.
  • Clipboard copies auto-clear after a short delay when unchanged.
  • Auto-refreshes when a new vault file is added to the data folder.
  • Offline 2FA (TOTP) compatible with Google Authenticator / Authy / Ente.
  • Optional 24h trusted device token after successful 2FA.
  • Export and import encrypted vaults for local migration between machines.
  • Export flow strips 2FA secret so recipients aren’t locked out.
  • Export can use master password or a separate export password.
  • Quick export locations (Desktop/Downloads) plus custom folder path.
  • Import browser CSV exports into entries.
  • Customizable UI colors (names or hex) with persistent settings + reset.
  • Optional recovery password to unlock vaults locally if the master password is lost.

How it Works

  1. Run VaultX.ps1 to launch the main menu, or run VaultX.ps1 -Gui to open the local GUI directly.
  2. Create or select a vault.
  3. Set or enter the master password to unlock it.
  4. Manage entries in the terminal, or switch to the GUI from the main menu and toggle the GUI theme as needed.
  5. Log out to return to the vault list.

Files

  • VaultX.ps1: main script, terminal UI, and local GUI.
  • Readme.md: this overview.

Notes

VaultX is designed for local use. If you do not set a recovery password, a lost master password cannot be recovered. 2FA secrets are stored inside the encrypted vault data and never written in plaintext to disk. Exported vaults default to VaultName_export.json. Vault deletion now uses a direct confirmation prompt in both the terminal UI and the GUI.

About

Local CLI Account Manager Tool - no serious data encryption !

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors