CLI Usage Guide

Master the EnvPush CLI to sync your environment variables across all your devices.

1. Authentication

Before you can sync secrets, you need to authenticate with your EnvPush account:

envpush login

Follow the prompts to enter your email and password.

2. Initialize Project

Link your local project directory to an existing project in your EnvPush vault:

envpush init

This command will:

  • Prompt you to select a Vault.
  • Prompt you to select or create a Project.
  • Create a local configuration file to save the link.

3. Pulling Secrets

Sync secrets from EnvPush to your local `.env` file:

envpush pull

By default, this pulls variables for the **Development** environment. You can specify other environments or output files using flags (coming soon).

4. Pushing Secrets

Upload your local `.env` secrets to EnvPush:

envpush push

Warning: Pushing will overwrite the encrypted secrets in your EnvPush vault with your local values.

Plan Limitations

Depending on your plan, there are limits on how many secrets you can sync using the CLI:

Free

50

Total Secrets limit

Plus

1,000

Total Secrets limit

Pro

Unlimited Secrets

If you reach your plan limit, the CLI will block `push` operations until you upgrade your plan or remove existing secrets.