CLI Overview

The Envshed CLI (envshed) lets you manage secrets from the terminal.

Commands

Command	Description
envshed init	Create a .envshed.json project config
envshed login	Authenticate with Envshed
envshed whoami	Show the currently logged-in user
envshed branch	Show the current environment context
envshed env	Switch the active environment
envshed pull	Pull secrets to a .env file
envshed push	Push secrets from a .env file
envshed run	Run a command with secrets injected
envshed orgs	List organizations
envshed projects	List projects in an organization
envshed envs	List environments in a project
envshed token	Manage personal and service tokens

Global Options

Flag	Description
--locale <code>	Override the display language (e.g., en, es). Defaults to system locale.

Global behavior

All commands that operate on secrets (pull, push, run) require three pieces of context: organization, project, and environment. These can be provided via:

1. CLI flags (-o, -p, -e)
2. Project config (.envshed.json)

See Configuration for the full resolution order.

When context is resolved from config, the CLI prints it before executing:

  my-org / my-project / development

Language / Locale

The CLI supports multiple languages. The display language is resolved in this order:

1. --locale flag (e.g., envshed --locale es pull)
2. locale field in ~/.envshed/config.json
3. System locale (LANG / LC_ALL environment variables)
4. Default: en (English)

Currently supported: en (English), es (Spanish).