PassMan

PassMan is a secure, local-first password manager built with Rust that stores your passwords encrypted locally with military-grade encryption. Your data never leaves your device, ensuring complete privacy and security. 🔒

✨ Key Features

#

🔐 Security & Privacy

- Military-Grade Encryption: AES-GCM-256 encryption with Argon2id key derivation
- Local-First Storage: All data is stored locally on your device
- No Cloud Dependencies: Your data never leaves your device
- Memory Safety: Built with Rust for memory safety and performance
- Secure File Permissions: Vault files have restricted permissions (600)

#

🚀 Cross-Platform Support

- Windows: Native Windows application
- macOS: Native macOS application
- Linux: Native Linux application
- CLI Interface: Full command-line interface for power users
- Desktop GUI: Beautiful desktop application (coming soon)

#

🛠️ Advanced Features

- Password Generation: Strong password generation with customizable options
- Vault Management: Encrypted vault files with secure storage
- Account Management: Store and organize multiple accounts
- Search & Filter: Quick search through your passwords
- Import/Export: Secure data migration capabilities

🏗️ Architecture

The project follows a modular architecture with three main components:

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Desktop GUI   │    │   CLI Tool      │    │   Backend Lib   │
│   (Tauri +      │    │   (Rust)        │    │   (Rust)        │
│   React/Next)   │    │                 │    │                 │
└─────────┬───────┘    └─────────┬───────┘    └─────────┬───────┘
          │                      │                      │
          └──────────────────────┼──────────────────────┘
                                 │
                    ┌─────────────▼─────────────┐
                    │     Encrypted Vault      │
                    │     (Local JSON File)    │
                    └───────────────────────────┘

🚀 Quick Start

#

Prerequisites

- Rust 1.70+ (install from [rustup.rs](https://rustup.rs/))
- Git

#

Building from Source

1. Clone the repository

bash
   git clone https://github.com/tarunjawla/passman.git
   cd passman
   

2. Build the project

bash
   cargo build --release
   

3. Run the CLI

bash
   ./target/release/passman --help
   

#

Using the CLI

1. Initialize a new vault

bash
   passman init your-email@example.com
   

2. Add an account

bash
   passman add "GitHub" --type social --url github.com --username user@example.com
   

3. List accounts

bash
   passman list
   

4. Generate a password

bash
   passman generate --length 16 --special --numbers
   

🔒 Security Details

- Encryption: AES-GCM-256 for vault encryption
- Key Derivation: Argon2id with secure parameters
- Memory Safety: Sensitive data is zeroized after use
- File Permissions: Vault files have restricted permissions (600)
- No Network: No data is ever sent over the network

📦 Project Structure

passman/
├── backend/          # Core Rust library
│   ├── src/
│   │   ├── lib.rs           # Public API
│   │   ├── models.rs        # Data structures
│   │   ├── crypto.rs        # Encryption/decryption
│   │   ├── storage.rs       # Vault file management
│   │   ├── auth.rs          # Authentication
│   │   ├── generator.rs     # Password generation
│   │   └── vault.rs         # Main vault manager
│   └── Cargo.toml
├── cli/              # Command-line interface
│   ├── src/
│   │   └── main.rs
│   └── Cargo.toml
├── desktop/          # Desktop GUI (Tauri)
│   └── src-tauri/
├── website/          # Marketing website
└── Cargo.toml        # Workspace configuration

🛠️ Development Status

#

✅ Completed (Phase 1)

- [x] Rust workspace setup
- [x] Backend library with core functionality
- [x] Data models and types
- [x] Encryption/decryption system
- [x] Password generation
- [x] Vault storage management
- [x] Authentication system
- [x] CLI tool with basic commands

#

🚧 In Progress

- [ ] Desktop GUI (Tauri + React)
- [ ] Cross-platform builds
- [ ] Comprehensive testing
- [ ] Documentation

#

📋 Planned

- [ ] Mobile apps
- [ ] Browser extension
- [ ] Advanced features (2FA, etc.)