> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enver-os.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Overview

> The `ev` CLI is the primary way to interact with Enver from your terminal or CI/CD pipeline.

# 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`](/cli/login) | Authenticate with an API token                |
| [`ev init`](/cli/init)   | Initialise a project in the current directory |
| [`ev push`](/cli/push)   | Encrypt and upload your `.env` to Enver       |
| [`ev pull`](/cli/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.

```json theme={null}
{
  "token": "env_live_..."
}
```

## Project config

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

```json theme={null}
{
  "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.