Browse documentation

Part VI · CLI · Plate 01

cns init

On this page

Listing 6.1.1   Synopsis

cns init [--domain <slug>] [--archetype <arch>]

Description

Bootstrap the current repository with the four CNS substrates.

Prerequisites

Install the organ binaries first. Run from the target Git repository. Set CNS_ROOT to the CNS checkout if using an installed copy of this CLI. THALAMUS_URL is optional and has no default; unset means local-only retrieval.

Actions

  1. Check Thalamus at THALAMUS_URL (unset: not configured).
  2. Build .axon/axon.db with axon index. Embed high-fan-in anchors with axon anchors embed only when THALAMUS_URL or AXON_EMBED_URL is set; otherwise report embed: not configured.
  3. Scaffold Git-tracked docs/soma/{README.md,concerns/} and render the Git-excluded .soma/ operational map.
  4. Provision .engram/ote.toml with retrieval endpoints derived from THALAMUS_URL. Unset: a local-only seat, no remote provider. Template URLs are never copied; an existing OTE is never rewritten. Run engram doctor for dense-vector backfill.
  5. Install .git/hooks/{post-commit,post-checkout,post-merge} and local Git exclusions for .axon/, .soma/, .engram/ and .cns/.