https://github.com/ahmadzafarcs/rust-vault

A simple and secure CLI password manager written in Rust. Store, retrieve, and manage your passwords locally with JSON-based persistence.
https://github.com/ahmadzafarcs/rust-vault

cargo rust software

Last synced: 13 days ago
JSON representation

A simple and secure CLI password manager written in Rust. Store, retrieve, and manage your passwords locally with JSON-based persistence.

• Host: GitHub
• URL: https://github.com/ahmadzafarcs/rust-vault
• Owner: ahmadzafarcs
• Created: 2025-11-18T15:00:21.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-11-18T15:39:03.000Z (7 months ago)
• Last Synced: 2025-11-18T17:19:35.742Z (7 months ago)
• Topics: cargo, rust, software
• Language: Rust
• Homepage:
• Size: 8.79 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# rust-vault

A simple and secure CLI password manager written in Rust. rust-vault allows you to store, retrieve, and manage your passwords locally using JSON-based persistence. It’s a beginner-friendly Rust project ideal for learning CLI development, structs, enums, and file I/O.

## Table of Contents

Features

Installation

Usage

Project Structure

Learning Goals

Future Improvements

License

## Features

Add a new password entry with service, username, and password.

List all saved entries.

Retrieve the password for a specific service.

Delete an entry from the vault.

Persistent storage in a local JSON file.

Beginner-friendly CLI application written in Rust.

## Installation

Clone the repository:

git clone git@github.com:yourusername/rust-vault.git

cd rust-vault

Build the project using Cargo:

cargo build --release

Usage

Run commands via Cargo. Examples:

## Add a new entry

cargo run -- add   

## List all entries

cargo run -- list

## Get password for a service

cargo run -- get 

## Delete an entry

cargo run -- delete 

Example workflow:

cargo run -- add gmail ahmad123 mypass123

cargo run -- list

cargo run -- get gmail

cargo run -- delete gmail

## Learning Goals

Practice Rust syntax: structs, enums, Result, Option.

Work with file I/O and JSON serialization (serde).

Build a functional CLI application.

Understand modular project structure in Rust.

Future Improvements

Add encryption for secure password storage.

Interactive CLI input (prompt for password instead of passing in command).

Search or filter entries by service name.

Export/import vault for backup purposes.

Improved error handling and user experience.

License

MIT License © Ahmad

If you want, I can also make an even shorter, recruiter-friendly version that highlights skills and project features in one page for your GitHub portfolio. Do you want me to do that?