@atlante/cli

Command-line interface for validating, building, and initializing Atlante projects. Requires Node.js 22 or later.

Usage

Run the CLI directly from npm:

npx @atlante/cli init
npx @atlante/cli validate
npx @atlante/cli build

For a global atlante command:

npm install --global @atlante/cli
atlante --help

Commands

• atlante init [path] [--preset starter] [--force] — scaffold atlante.jsonc, register @atlante/opencode-plugin, and build artifacts
• atlante validate [path] — validate the document and referenced template inputs without rendering
• atlante build [path] — validate, render, and atomically publish host-neutral artifacts under .atlante/artifacts/

path defaults to the current directory and may be a config file or project directory. Atlante discovers both atlante.jsonc and atlante.json. Validation and building use the same raw-overlay expansion path before checking or rendering the canonical document. init performs a build automatically. Run atlante build after changing the source configuration.

init creates or updates opencode.jsonc while preserving existing settings.

The artifact format and its verification rules are documented in SPECIFICATION.md §9.1; the builder's fail-closed readArtifacts reader contract is in @atlante/builder's README. Artifact format/version is distinct from the document schema version. Artifacts contain rendered values and may be sensitive; keep .atlante/ local and do not publish it.