diff --git a/.npmrc b/.npmrc
new file mode 100644
index 0000000..521a9f7
--- /dev/null
+++ b/.npmrc
@@ -0,0 +1 @@
+legacy-peer-deps=true
diff --git a/README.md b/README.md
index 929c97a..08076c6 100644
--- a/README.md
+++ b/README.md
@@ -124,13 +124,13 @@ Agent response
 - `setup/service.ts` — generates `run-*.sh` wrappers at install time (not tracked in git)
 - `groups/*/AGENTS.md` — per-group memory
 
-A `justfile` provides discoverable command shortcuts. Run `just` (or `just --list`) to see all recipes. Prefer `just` for interactive work; `npm run <name>` remains for CI and scripting.
+A `justfile` provides discoverable command shortcuts. Run `just` (or `just --list`) to see all recipes. Prefer `just` for interactive work; `npm run <name>` remains for CI and scripting. The full installer is intentionally exposed as `just install` / `npm run install:clawdie` instead of the npm lifecycle name `install`.
 
 Common mappings:
 
 ```
-just install              # npm run install
-just install-from-db      # npm run install -- --from db
+just install              # npm run install:clawdie
+just install-from-db      # npm run install:clawdie -- --from db
 just setup-db             # npm run setup -- --step db
 just setup-cms            # npm run setup -- --step cms
 ```
diff --git a/docs/public/architecture/deployment-models.md b/docs/public/architecture/deployment-models.md
index 2c60a70..75568b6 100644
--- a/docs/public/architecture/deployment-models.md
+++ b/docs/public/architecture/deployment-models.md
@@ -87,8 +87,7 @@ Everything in this repository is shared between both models:
 | Ansible playbooks | `infra/ansible/`      |
 
 The ISO build lives in a separate Clawdie-ISO repo and calls
-`just install` (or `npm run install`) after base OS install — the same entry point used
-in Model 1.
+`just install` after base OS install — the same entry point used in Model 1.
 
 ---
 
diff --git a/docs/public/install/install.md b/docs/public/install/install.md
index f8d73eb..66e3960 100644
--- a/docs/public/install/install.md
+++ b/docs/public/install/install.md
@@ -3,7 +3,7 @@ title: Install Orchestrator
 description: Single-command install flow for Clawdie.
 ---
 
-**Command:** `just install` (or `npm run install`)
+**Command:** `just install` (or `npm run install:clawdie`)
 
 ## Quick start
 
diff --git a/docs/public/sl/install/install.md b/docs/public/sl/install/install.md
index fe5bbf2..dba3c31 100644
--- a/docs/public/sl/install/install.md
+++ b/docs/public/sl/install/install.md
@@ -3,7 +3,7 @@ title: Namestitev
 description: Tok namestitve z enim ukazom za Clawdie.
 ---
 
-**Ukaz:** `just install` (ali `npm run install`)
+**Ukaz:** `just install` (ali `npm run install:clawdie`)
 
 ## Hitri začetek
 
diff --git a/package.json b/package.json
index abd580b..06e05f9 100644
--- a/package.json
+++ b/package.json
@@ -29,7 +29,7 @@
     "sync-readme-version": "node scripts/update-readme-version.mjs",
     "check-readme-version": "node scripts/update-readme-version.mjs --check",
     "publish-tenant-site": "tsx setup/publish-tenant-site.ts",
-    "install": "tsx setup/install.ts",
+    "install:clawdie": "tsx setup/install.ts",
     "verify-agent-jails": "sudo npx tsx setup/verify-agent-jails.ts",
     "install-hooks": "git config core.hooksPath hooks",
     "prepare": "git config core.hooksPath hooks 2>/dev/null || true",
diff --git a/setup/agent-jails.ts b/setup/agent-jails.ts
index 493e6f0..504efeb 100644
--- a/setup/agent-jails.ts
+++ b/setup/agent-jails.ts
@@ -5,7 +5,7 @@
  * Each gets pi + aider installed, scoped secrets, and nullfs mounts for
  * its domain. PF rules restrict cross-jail network access.
  *
- * Run: just setup-agent-jails  (or npm run install -- --from agent-jails)
+ * Run: just setup-agent-jails  (or just install -- --from agent-jails)
  */
 import { SERVICE_NAME } from '../src/platform-identity.js';
 import fs from 'fs';
diff --git a/setup/install.ts b/setup/install.ts
index f7464ad..2866c66 100644
--- a/setup/install.ts
+++ b/setup/install.ts
@@ -6,10 +6,10 @@
  * LLM key — reports provider status at the end and continues.
  *
  * Usage:
- *   npm run install
- *   npm run install -- --from pf          # resume from a step
- *   npm run install -- --no-snapshots     # skip ZFS checkpoints
- *   npm run install -- --dry-run          # print plan, run nothing
+ *   just install
+ *   just install -- --from pf          # resume from a step
+ *   just install -- --no-snapshots     # skip ZFS checkpoints
+ *   just install -- --dry-run          # print plan, run nothing
  */
 
 import { execFileSync, spawnSync } from 'child_process';
@@ -558,7 +558,7 @@ function printSummary(results: StepResult[]): void {
     );
     console.log(`\n  Resume from last failed step:`);
     console.log(
-      `    ${COLS.skipped}npm run install -- --from ${failed[0].name}${COLS.reset}`,
+      `    ${COLS.skipped}just install -- --from ${failed[0].name}${COLS.reset}`,
     );
   }
   console.log('─'.repeat(52));