Reference

This page documents exact behavior. Open the reference overview

Commands

Reference

This page organizes the CLI by intent rather than by alphabet. Use it when you know roughly what you want to do and need the exact command surface for that job.

If you want examples and workflow context, see Guides. If you want the model behind these commands, see Concepts.

Global options

Available global options:

• --version, -V
• --profile, -p
• --group, -g
• --set
• --var
• --output json|text
• --install-completion
• --show-completion

Profile selection precedence

1. --profile
2. ENVCTL_PROFILE
3. config default_profile
4. local

Contract scope selectors

• --group LABEL targets variables whose normalized groups include LABEL
• --set NAME targets one named contract set
• --var KEY targets one explicit variable

These selectors are mutually exclusive.

Command groups

• Bootstrap

  Prepare local config and repository state.

  • config
  • init

• Shared contract

  Change the repository-owned environment requirements.

  • add
  • remove

• Local values

  Change only the values stored for the active profile.

  • set
  • unset
  • fill

• Inspect and validate

  Understand or validate resolved state before runtime.

  • check
  • inspect
  • status

• Projection

  Hand resolved state to subprocesses, files, or stdout.

  • run
  • sync
  • export

• Profiles

  Manage named local value contexts.

  • profile

• Vault

  Inspect and maintain physical local storage.

  • vault

• Project identity

  Manage binding and local project recovery.

  • project

• Hooks and guard

  Operate the local Git safety layer.

  • guard
  • hooks

Read next

check

Start here for the fastest pass/fail validation answer.

Open check reference

run

Start here for the default in-memory projection path.

Open run reference

Concepts

Go back here when the behavior only makes sense once the layers are clear.

Open concepts