From 5b7c5d21572e63aed4626b167e5ea9a2c736bb2d Mon Sep 17 00:00:00 2001
From: Mario Zechner <badlogicgames@gmail.com>
Date: Wed, 20 May 2026 14:47:18 +0200
Subject: [PATCH] docs: recommend scriptless npm installs

---
 packages/coding-agent/README.md          |  8 +++++---
 packages/coding-agent/docs/index.md      | 16 +++++++++-------
 packages/coding-agent/docs/quickstart.md |  4 +++-
 packages/coding-agent/docs/termux.md     |  2 +-
 4 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/packages/coding-agent/README.md b/packages/coding-agent/README.md
index fedc53d2..79f284a0 100644
--- a/packages/coding-agent/README.md
+++ b/packages/coding-agent/README.md
@@ -68,13 +68,15 @@ I regularly publish my own `pi-mono` work sessions here:
 ## Quick Start
 
 ```bash
-curl -fsSL https://pi.dev/install.sh | sh
+npm install -g --ignore-scripts @earendil-works/pi-coding-agent
 ```
 
-Or with npm:
+`--ignore-scripts` disables dependency lifecycle scripts during install. Pi does not require install scripts for normal npm installs.
+
+Installer alternative:
 
 ```bash
-npm install -g @earendil-works/pi-coding-agent
+curl -fsSL https://pi.dev/install.sh | sh
 ```
 
 Authenticate with an API key:
diff --git a/packages/coding-agent/docs/index.md b/packages/coding-agent/docs/index.md
index ffe97865..75a527d6 100644
--- a/packages/coding-agent/docs/index.md
+++ b/packages/coding-agent/docs/index.md
@@ -4,18 +4,20 @@ Pi is a minimal terminal coding harness. It is designed to stay small at the cor
 
 ## Quick start
 
-On linux or mac you can install Pi with curl:
+Install Pi with npm:
+
+```bash
+npm install -g --ignore-scripts @earendil-works/pi-coding-agent
+```
+
+`--ignore-scripts` disables dependency lifecycle scripts during install. Pi does not require install scripts for normal npm installs.
+
+On Linux or macOS, you can also use the installer:
 
 ```bash
 curl -fsSL https://pi.dev/install.sh | sh
 ```
 
-Or alternatively with npm:
-
-```bash
-npm install -g @earendil-works/pi-coding-agent
-```
-
 To uninstall pi itself, use npm for curl and npm installs:
 
 ```bash
diff --git a/packages/coding-agent/docs/quickstart.md b/packages/coding-agent/docs/quickstart.md
index 29f9896a..c7266346 100644
--- a/packages/coding-agent/docs/quickstart.md
+++ b/packages/coding-agent/docs/quickstart.md
@@ -7,9 +7,11 @@ This page gets you from install to a useful first pi session.
 Pi is distributed as an npm package:
 
 ```bash
-npm install -g @earendil-works/pi-coding-agent
+npm install -g --ignore-scripts @earendil-works/pi-coding-agent
 ```
 
+`--ignore-scripts` disables dependency lifecycle scripts during install. Pi does not require install scripts for normal npm installs.
+
 ### Uninstall
 
 Use the package manager that installed pi. The curl installer uses npm globally, so curl and npm installs are removed with npm:
diff --git a/packages/coding-agent/docs/termux.md b/packages/coding-agent/docs/termux.md
index c9b9973c..aba6e292 100644
--- a/packages/coding-agent/docs/termux.md
+++ b/packages/coding-agent/docs/termux.md
@@ -17,7 +17,7 @@ pkg update && pkg upgrade
 pkg install nodejs termux-api git
 
 # Install pi
-npm install -g @earendil-works/pi-coding-agent
+npm install -g --ignore-scripts @earendil-works/pi-coding-agent
 
 # Create config directory
 mkdir -p ~/.pi/agent