CLI Overview

The Redenv CLI is a command-line tool for managing encrypted secrets across environments. It handles the complete secret management lifecycle — from project creation to deployment.

Installation#

See the Installation Guide for detailed instructions and troubleshooting.

First-Time Setup#

Connect the CLI to your Upstash Redis instance:

redenv setup

You'll be prompted for your Upstash Redis REST URL and REST Token — both available in your Upstash Console. Credentials are stored securely in your system keychain.

Commands#

The CLI provides 20+ commands organized by function:

Quick Examples#

Create a project and add secrets:

redenv register my-app
redenv add API_KEY "sk_test_123"
redenv add DATABASE_URL "postgresql://localhost/myapp"
redenv list

Work with multiple environments:

redenv switch env production
redenv add API_KEY "sk_live_xyz"
redenv diff development production

Migrate from .env file:

redenv register my-app
redenv import .env

Enter interactive mode:

redenv shell
# Now run commands without 'redenv' prefix
> add API_KEY "value"
> list
> exit

Configuration#

Create a redenv.config.ts in your project root:

import { defineConfig } from "@redenv/core";

export default defineConfig({
  name: "my-app",
  environment: "development",
  plugins: [],
});

The CLI discovers configuration in this order:

1. redenv.config.ts in current directory
2. redenv.config.ts in parent directories
3. Global config from redenv setup