add¶

Reference

add changes the shared project contract. Use it when the application now requires a new variable as part of the repository-owned environment model.

envctl add KEY VALUE

Philosophy¶

add changes the shared model.

Use it when the project itself now requires a new variable, not when you only want to tweak your own local value.

--type to set variable type explicitly
--format to set semantic string format such as json, url, or csv when --type string
--required / --optional
--sensitive / --non-sensitive
--description
--default
--example
--pattern
--choice

Use add when the variable becomes part of the shared project contract.

Do not use add when the contract already exists and you only want to change your local value. In that case, use set.

Go back to the shared layer that add modifies.

Use the inverse shared-model mutation when a variable should stop existing.

See how contract changes behave in a shared repository workflow.