Skip to main content

secret

Manage individual secrets by key.

secret get

envshed secret get <KEY> [options]

Fetches the decrypted value for a single secret. When stdout is a terminal (TTY), a warning is printed to stderr:

Tip: pipe to clipboard or file to avoid terminal history exposure

Options

OptionDescription
-o, --org <slug>Organization slug
-p, --project <slug>Project slug
-e, --env <slug>Environment slug
--output jsonPrint JSON output

secret set

envshed secret set <KEY> [options]

Sets or creates a secret. The value is never accepted as a positional argument or --value flag to prevent shell history exposure. Instead:

  • When stdin is a TTY, you are prompted interactively with a masked input.
  • When stdin is piped, the value is read from stdin (30-second timeout).

Options

OptionDescription
-o, --org <slug>Organization slug
-p, --project <slug>Project slug
-e, --env <slug>Environment slug
--placeholderMark the secret as a placeholder (no value required)
--output jsonPrint JSON output

secret delete

envshed secret delete <KEY> [options]

Deletes a secret. Prompts for confirmation unless --yes is passed.

Options

OptionDescription
-o, --org <slug>Organization slug
-p, --project <slug>Project slug
-e, --env <slug>Environment slug
-y, --yesSkip confirmation prompt
--output jsonPrint JSON output

secret override set

envshed secret override set <KEY> [options]

Sets a personal override for a secret. Your override is visible only to you and takes effect when you pull or run the environment. Uses the same masked prompt / stdin pipe pattern as secret set.

This command requires a user token. Service tokens cannot set personal overrides.

Options

OptionDescription
-o, --org <slug>Organization slug
-p, --project <slug>Project slug
-e, --env <slug>Environment slug
--output jsonPrint JSON output

secret override remove

envshed secret override remove <KEY> [options]

Removes your personal override for a secret. Prompts for confirmation unless --yes is passed.

This command requires a user token. Service tokens cannot remove personal overrides.

Options

OptionDescription
-o, --org <slug>Organization slug
-p, --project <slug>Project slug
-e, --env <slug>Environment slug
-y, --yesSkip confirmation prompt
--output jsonPrint JSON output