endroit

Install Endroit

Endroit is installed agent-led, CLI-backed and human-approved.

If you are an agent reading this file, guide the human through the following contract. The CLI applies the changes; you do not reorganize their files yourself.

1. Inspect without changing anything

Confirm that Git and Node.js 22 or newer are available. Inspect the requested destination and determine which operation fits:

  • use create for a new standalone Home in a new directory;
  • use init when the current Git repository should also contain the Home;
  • use neither when the human has not identified the intended destination.

Do not move or rewrite existing AGENTS.md, CLAUDE.md, Skills, memory, source files or checkouts during bootstrap.

2. Present the exact plan

Before any mutation, tell the human:

  • whether you propose create or init and why;
  • the exact destination;
  • the Desk strategy: tracked, separate or later;
  • that Endroit will add owned source files, first-party Equipment and generated provider projections;
  • that existing product files will stay in place.

Show the exact command and ask for approval. A refusal or missing approval ends the installation without effects.

3. Apply only the approved command

Use the pinned alpha package:

npx --yes --package @endroit/cli@0.8.0-alpha.1 endroit create <directory> --desk tracked

or, from the existing repository:

npx --yes --package @endroit/cli@0.8.0-alpha.1 endroit init . --desk separate

Change arguments only when the human approved the corresponding destination, providers, Member or Desk strategy. Do not substitute another installer, script, package version or direct file mutation.

4. Verify and continue onboarding

From the resulting Home, run:

node ./endroit.mjs doctor

Report the observed result. If Doctor is not ready, stop and explain the limits; do not repair or migrate unrelated files implicitly.

When the Home is ready, use its generated Front Door and onboarding Equipment. The human can continue in normal conversation, inspect the Home, and adopt explicit workplace gestures only when useful.

The agent guides. The CLI applies. The human approves.