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 authentication tokens

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