nv CLI

Environment variable management with Vercel-like developer experience.

Installation

npm install -g nvenv-cli
# or
bun add -g nvenv-cli
# or
pnpm add -g nvenv-cli

Quick Start

# Authenticate with your nv account
nv login

# List your workspaces
nv list

# Link to a workspace
nv link --workspace <workspace-id>

# Pull environment variables
nv pull --env production

# Pull to a custom file
nv pull --env development --output .env.local

Commands

nv login

Authenticate with nv via browser. This will:

1. Generate a unique verification code
2. Open your browser for confirmation
3. Save your authentication token locally

nv login

nv logout

Log out from your nv account and remove stored credentials.

nv logout

nv list (alias: ls)

List all your workspaces.

nv list
# or
nv ls

nv link

Link the current directory to a workspace. Once linked, you can use nv pull without specifying the workspace ID.

# Link to a workspace
nv link --workspace <workspace-id>

# Show current linked workspace
nv link

Options:

• -w, --workspace <id> - Workspace ID to link

nv pull

Pull environment variables from a workspace and save them to a local file.

# Pull development variables (default)
nv pull

# Pull production variables
nv pull --env production

# Pull from a specific workspace
nv pull --workspace <workspace-id> --env production

# Save to a custom file
nv pull --env production --output .env.production.local

Options:

• -e, --env <env> - Environment (production, preview, development). Default: development
• -w, --workspace <id> - Workspace ID (optional if linked)
• -o, --output <file> - Output file path. Default: .env.<env>.local

Configuration

The CLI stores configuration in your system's config directory:

• macOS: ~/Library/Preferences/nv-cli-nodejs
• Linux: ~/.config/nv-cli
• Windows: %APPDATA%\nv-cli\Config

Configuration includes:

• apiUrl - API endpoint (default: https://nvenv.dev)
• accessToken - Authentication token
• currentWorkspace - Linked workspace ID

Environment Variables

You can customize the API URL using an environment variable:

export NV_API_URL=https://your-nv-instance.com
nv login

Examples

Typical Workflow

# 1. Login
nv login

# 2. List workspaces to find the one you need
nv list

# 3. Link to your project workspace
nv link --workspace abc123

# 4. Pull production variables
nv pull --env production

# 5. Pull development variables for local development
nv pull --env development --output .env.local

CI/CD Integration

For CI/CD environments, you can skip the link step by always specifying the workspace:

nv pull --workspace $WORKSPACE_ID --env production --output .env.production

License

MIT