@k1e1n04/mav 0.1.1 → 0.1.2

package/README.md

@@ -31,14 +31,33 @@ brew tap k1e1n04/mav https://github.com/k1e1n04/mav.git
 brew install mav
 ```
 
-### npm / pnpm
+### npm
 
 ```bash
 npm install -g @k1e1n04/mav
-# or
+```
+
+Requires Xcode Command Line Tools (macOS) or `build-essential` (Linux) for the native `node-pty` module.
+
+```bash
+# macOS
+xcode-select --install
+
+# Ubuntu / Debian
+sudo apt-get install -y build-essential python3
+```
+
+### pnpm
+
+pnpm v10+ blocks install scripts by default. An extra step is needed after install:
+
+```bash
 pnpm add -g @k1e1n04/mav
+pnpm approve-builds -g   # select node-pty to allow its native build
 ```
 
+> **Tip:** On macOS, Homebrew handles all of this automatically — use it if you prefer a simpler install.
+
 ### Build from Source
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k1e1n04/mav",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Multi-agent view — manage multiple AI CLI sessions in one terminal",
   "type": "module",
   "bin": {

package/scripts/postinstall.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // Rebuild node-pty's native binary if it wasn't built during install.
-// pnpm v9+ blocks transitive dependency install scripts by default, so
-// we trigger the build here from the package's own postinstall.
+// Runs automatically when installed via npm.
+// pnpm v10+ also blocks this script unless approved with `pnpm approve-builds -g`.
 import { execSync } from 'node:child_process'
 import { existsSync } from 'node:fs'
 import { dirname } from 'node:path'