CLI Reference

ev is a CLI-first tool. All commands follow a consistent pattern: ev <command> [target] [flags].

Targeting Apps and Environments

Most commands accept an optional [app:env] argument using colon syntax:

ev push                    # uses ev.yaml defaults
ev push staging            # override environment only
ev push backend:staging    # override app and environment

Commands

CommandDescription
ev initInitialize a new project or join an existing one
ev pushPush local .env to remote
ev pullPull remote secrets into local .env
ev diffCompare local vs remote, or two environments
ev logShow release history
ev getGet a single secret value
ev rollbackRoll back to a previous release
ev envList, create, and delete environments
ev promoteCopy secrets from one environment to another
ev accessManage team access and key rotation
ev backendConfigure storage backends
ev importImport secrets from an external provider
ev statusShow current project and environment context
ev scanScan codebase for env var references
ev doctorCheck setup for issues
ev completionsGenerate shell completions

On this page