EnvWallet CLI

The official command-line interface for EnvWallet - secure environment variable management.

Installation

# Global installation
npm install -g envwallet-cli

# Or use directly with npx (no installation needed)
npx envwallet-cli --help

Quick Start

1. Configure your API key:

npx envwallet-cli configure

2. Pull environment variables:

# Pull both .env and wallet files (default behavior - sparks joy! 🎉)
npx envwallet-cli pull

# Pull only encrypted wallet file
npx envwallet-cli pull --wallet

# Pull only encrypted vault file (legacy)
npx envwallet-cli pull --vault

# Pull specific environment
npx envwallet-cli pull -e development

# Pull without specifying environment (for single-env projects or env-specific API keys)
npx envwallet-cli pull --no-env

3. Push environment variables:

npx envwallet-cli push -f .env

Commands

configure

Configure the CLI with your EnvWallet API key.

pull

Pull environment variables from EnvWallet. By default, creates both .env and wallet files for maximum convenience! 🚀

Options:

• -e, --env <environment>: Environment name (optional - will prompt if multiple environments exist)
• -o, --output <file>: Output file (default: .env)
• -p, --project <id>: Project ID
• -w, --wallet: Pull only wallet file (encrypted)
• -v, --vault: Pull only vault file (encrypted, legacy format)
• --both: Explicitly pull both .env and wallet files (same as default)
• --no-env: Pull variables without specifying environment (useful for single-environment projects or environment-specific API keys)
• --verbose: Show detailed API request/response information for debugging

Smart Environment Detection:

• If your API key is environment-specific, it will use that environment automatically
• If only one environment exists in the project, it will use it automatically
• If multiple environments exist and none is specified, it will prompt you to select one

Default Behavior (New!):

By default, npx envwallet-cli pull creates both:

• .env - Plain text for local development
• .env.wallet - Encrypted for production deployment

push

Push environment variables to EnvWallet project.

Options:

• -f, --file <file>: Input .env file (default: .env)
• -p, --project <id>: Project ID

load

Load variables from .env.wallet file into process environment.

Options:

• -e, --env <environment>: Environment to load (default: development)
• -w, --wallet <file>: Wallet file path (default: .env.wallet)
• -v, --vault <file>: Vault file path (legacy, default: .env.vault)

Using with NPX

You can use the CLI without installing it globally:

# Configure
npx envwallet-cli configure

# Pull both .env and wallet files (default - auto-detects environment)
npx envwallet-cli pull

# Pull only wallet file (encrypted)
npx envwallet-cli pull --wallet

# Pull only vault file (encrypted, legacy)
npx envwallet-cli pull --vault

# Pull specific environment
npx envwallet-cli pull -e production

# Push variables
npx envwallet-cli push -f .env

Configuration

The CLI stores its configuration in a .envwallet.json file in your current directory.

Environment Variables

• ENVWALLET_API_URL: Override the default API URL

License

MIT