rvenv

/ˌɑːrviːiːɛnˈviː/

[Commands] · [Installation] · [Showcase] · [Docs]

rvenv is a lightweight shell-based framework I built to manage project-specific identities and secure environment variables without cluttering up your global configuration. It lets you "step into" a workspace where the PATH, PS1, and encrypted secrets are automatically scoped to that specific project.

Key Features

• Encrypted Vault: Store sensitive environment variables securely with AES-256 or ChaCha20 encryption.
• Master Password Storage: Optionally store your vault password locally (~/.config/rvenv/.vault_pass) for seamless session entry.
• Interactive Setup: Simple installation process to configure your identity and security preferences.
• Identity Management: Project-specific user identities (Name/Handle) scoped to your workspace.
• Environment Isolation: Automatic PATH and PS1 scoping when entering a project.
• Identifier Validation: Ensures all secret keys are valid Bash identifiers to prevent shell errors.
• Modular Architecture: Clean separation of concerns with router, engine, and vault components.

Quick Start

For Bash

git clone https://github.com/rvenv/rvenv.git
cd rvenv
make install

For PowerShell

git clone https://github.com/rvenv/rvenv.git
cd rvenv
./install.ps1

Common Usage

Initialize a Project

rvenv init

Store Secrets

rvenv put API_KEY "your-secret-token"

Enter Environment

# Bash
rvenv enter

Commands Reference