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.)