Skip to content

Getting started

Getting started

Start here if you are new to envctl and want the shortest path to a correct mental model and a working repository. This section is intentionally small: install the CLI, follow one safe flow, then deepen your understanding only where needed.

Who this section is for

Use this section if you want one of two things:

  • your first successful local setup
  • the minimum mental model that makes the CLI feel predictable

If you already know the model and just need exact behavior, skip to the reference section.

The key split to learn early is simple: the contract is shared, the values are local, and projection is explicit.

Start with one of these

Installation

Install the CLI and confirm it is available in your shell.

Open installation

Quickstart

Take the shortest safe path from zero to a validated first run.

Open quickstart

First project

Follow a slightly fuller onboarding flow for a real repository checkout.

Open first project

Mental model

Learn the minimum model before you memorize commands.

Open mental model

What you should get from this section

By the end of this section, you should be able to answer:

  • what belongs in the contract and what does not
  • where local values live
  • how a normal first-run flow works
  • why run is usually cleaner than generating files by default

Quickstart

If you want the shortest path to a working project, start here.

Open quickstart

Mental model

If you want the concepts before the commands, start here.

Open mental model

Concepts

If you already have the basics and want the canonical definitions, continue here.

Open concepts