CLI Overview

The ev CLI lets you manage secrets from any terminal. All encryption and decryption happens locally — the server only ever sees ciphertext.

Commands

Command	Description
`ev login`	Authenticate with an API token
`ev init`	Initialise a project in the current directory
`ev push`	Encrypt and upload your `.env` to Enver
`ev pull`	Download and decrypt secrets into `.env`
`ev user`	Show the currently authenticated user

Global flags

Flag	Description
`--version`, `-v`	Print the CLI version
`--help`, `-h`	Show help for any command

Environment variables

Variable	Description
`ENVER_API_URL`	Override the API base URL (default: `https://api-staging.enver-os.xyz/api/v1`)

Config file

The CLI stores your session token at ~/.enver/config.json. This file is shared with the VS Code extension, so logging in once works across both tools.

{
  "token": "env_live_..."
}

Project config

Running ev init creates a .ev.json in the current directory:

{
  "projectId": "my-app",
  "name": "My App",
  "defaultEnvironment": "DEVELOPMENT"
}

Commands like ev push and ev pull read this file to know which project and environment to target.

⌘I