pi 패키지 설치시 pi 못찾아 발생하는 묹제 해결

README.md

@@ -52,6 +52,13 @@ curl -fsSL "https://gl.isitsoft.kr/publicproj/install-sh/-/raw/main/install-ctop
 curl -LsSf https://astral.sh/uv/install.sh | sh
 ```
 
+> 설치 후 `${HOME}/.local/bin`이 PATH에 없으면 추가하세요:
+>
+> ```bash
+> echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
+> source ~/.bashrc
+> ```
+
 **pi (Pi Coding Agent + 추천 패키지):**
 
 ```bash
@@ -92,6 +99,12 @@ powershell -ExecutionPolicy Bypass -c "$t=\"$env:TEMP\install-ctop.ps1\"; iwr -u
 powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
 ```
 
+> 설치 후 `$env:USERPROFILE\.local\bin`이 PATH에 없으면 추가하세요:
+>
+> ```powershell
+> [System.Environment]::SetEnvironmentVariable('Path', $env:USERPROFILE + '\.local\bin;' + [System.Environment]::GetEnvironmentVariable('Path', 'User'), 'User')
+> ```
+
 **pi (Pi Coding Agent + 추천 패키지):**
 
 ```powershell

install-pi.ps1

@@ -97,30 +97,73 @@ if ($piCmd) {
     Success "Pi installed via npm"
 }
 
-# Verify pi is available
+# ────────────────────────────────────────────
+# Resolve pi binary path (may not be in PATH yet after fresh install)
+# ────────────────────────────────────────────
+$piBin = $null
+
+# 1) Try current PATH
 $piCmd = Get-Command pi -ErrorAction SilentlyContinue
 if ($piCmd) {
-    Success "Pi is available: $($piCmd.Source)"
+    $piBin = $piCmd.Source
-} else {
+}
-    # Refresh PATH for current session
+
+# 2) Refresh PATH from registry and try again
+if (-not $piBin) {
     $env:Path = [System.Environment]::GetEnvironmentVariable('Path', 'User') + ';' + [System.Environment]::GetEnvironmentVariable('Path', 'Machine')
     $piCmd = Get-Command pi -ErrorAction SilentlyContinue
     if ($piCmd) {
-        Success "Pi is available: $($piCmd.Source)"
+        $piBin = $piCmd.Source
-    } else {
-        ErrExit "'pi' command not found. Check your PATH."
     }
 }
 
+# 3) Try common npm global locations
+if (-not $piBin) {
+    $npmPrefix = & npm config get prefix 2>$null
+    if ($LASTEXITPR -eq 0 -and $npmPrefix) {
+        $candidate = Join-Path $npmPrefix 'pi.cmd'
+        if (Test-Path $candidate) { $piBin = $candidate }
+        if (-not $piBin) {
+            $candidate = Join-Path $npmPrefix 'pi'
+            if (Test-Path $candidate) { $piBin = $candidate }
+        }
+    }
+}
+
+# 4) Try well-known locations
+if (-not $piBin) {
+    $candidates = @(
+        (Join-Path $env:APPDATA 'npm\pi.cmd'),
+        (Join-Path $env:APPDATA 'npm\pi'),
+        'C:\Program Files\nodejs\pi.cmd',
+        'C:\Program Files\nodejs\pi'
+    )
+    foreach ($c in $candidates) {
+        if (Test-Path $c) { $piBin = $c; break }
+    }
+}
+
+if ($piBin) {
+    # Add pi's directory to PATH for this session
+    $piDir = Split-Path $piBin
+    if ($env:Path -notlike "*$piDir*") {
+        $env:Path = "$piDir;$env:Path"
+        Info "Added $piDir to PATH for this session"
+    }
+    Success "Pi is available: $piBin"
+} else {
+    ErrExit "'pi' command not found after installation. Check your PATH or reinstall Node.js."
+}
+
 # ────────────────────────────────────────────
-# Step 2: Install packages
+# Step 2: Install packages using the resolved pi binary
 # ────────────────────────────────────────────
 if ($SkipPackages) {
     Info "Skipping package installation (-SkipPackages flag)."
 } else {
     Info ""
     Info "Installing Pi packages..."
-    Info "────────────────────────────────────────"
+    Info "---------------------------------------------------"
 
     $total = $Packages.Count
     $count = 0
@@ -133,7 +176,7 @@ if ($SkipPackages) {
 
         Info "[$count/$total] $name - $desc"
         try {
-            & pi install "npm:$name" 2>&1 | Out-Null
+            & $piBin install "npm:$name" 2>&1 | Out-Null
             if ($LASTEXITPR -eq 0) {
                 Success "  -> $name installed"
             } else {
@@ -147,7 +190,7 @@ if ($SkipPackages) {
     }
 
     Info ""
-    Info "────────────────────────────────────────"
+    Info "---------------------------------------------------"
     if ($failed.Count -eq 0) {
         Success "All packages installed! ($total/$total)"
     } else {
@@ -170,6 +213,15 @@ Info "=================================================="
 Success "Pi Coding Agent installation complete!"
 Info "=================================================="
 Info ""
+Info "Pi binary: $piBin"
+Info ""
+$piDir = Split-Path $piBin
+$userPath = [System.Environment]::GetEnvironmentVariable('Path', 'User')
+if ($userPath -notlike "*$piDir*") {
+    Info "NOTE: Add $piDir to your PATH permanently by running:"
+    Info "  [System.Environment]::SetEnvironmentVariable('Path', '$piDir;' + [System.Environment]::GetEnvironmentVariable('Path', 'User'), 'User')"
+}
+Info ""
 Info "Getting started:"
 Info "  1. Navigate to your project: cd C:\path\to\project"
 Info "  2. Start Pi: pi"

install-pi.sh

@@ -45,7 +45,10 @@ PACKAGES=(
 # ────────────────────────────────────────────
 info() { echo "[INFO]  $*" >&2; }
 warn() { echo "[WARN]  $*" >&2; }
-error()   { echo "[ERROR] $*" >&2; exit 1; }
+error() {
+	echo "[ERROR] $*" >&2
+	exit 1
+}
 success() { echo "[OK]    $*" >&2; }
 
 # ────────────────────────────────────────────
@@ -62,8 +65,8 @@ OS="$(uname -s)"
 ARCH="$(uname -m)"
 
 case "$OS" in
-    Darwin|Linux) ;;
+Darwin | Linux) ;;
-    *)
+*)
 	error "Unsupported OS: $OS. This script only supports macOS and Linux."
 	;;
 esac
@@ -91,21 +94,56 @@ else
 	fi
 fi
 
-# Verify pi is available (may need to re-hash PATH)
+# ────────────────────────────────────────────
+# Resolve pi binary path (may not be in PATH yet after fresh install)
+# ────────────────────────────────────────────
+PI_BIN=""
+
+# 1) Try current PATH
 if command -v pi &>/dev/null; then
-    success "Pi is available: $(command -v pi)"
+	PI_BIN="$(command -v pi)"
-else
+fi
-    # Try common locations
+
-    export PATH="$HOME/.local/bin:$HOME/.npm/bin:$HOME/.nvm/versions/node/$(ls "$HOME/.nvm/versions/node/" 2>/dev/null | tail -1)/bin:$PATH"
+# 2) Try expanding common locations where npm/pip install globally
-    if command -v pi &>/dev/null; then
+if [ -z "$PI_BIN" ]; then
-        success "Pi is available: $(command -v pi)"
+	for candidate in \
-    else
+		"$HOME/.local/bin/pi" \
-        error "'pi' command not found. Check your PATH."
+		"$HOME/.npm/bin/pi" \
+		"/usr/local/bin/pi" \
+		"$HOME/.nvm/versions/node/$(ls "$HOME/.nvm/versions/node/" 2>/dev/null | tail -1)/bin/pi" \
+		"$NVM_DIR/versions/node/$(ls "$NVM_DIR/versions/node/" 2>/dev/null | tail -1)/bin/pi"; do
+		if [ -x "$candidate" ]; then
+			PI_BIN="$candidate"
+			break
+		fi
+	done
+fi
+
+# 3) Try npm prefix to locate the global bin
+if [ -z "$PI_BIN" ] && command -v npm &>/dev/null; then
+	NPM_PREFIX="$(npm config get prefix 2>/dev/null || true)"
+	if [ -n "$NPM_PREFIX" ] && [ -x "$NPM_PREFIX/bin/pi" ]; then
+		PI_BIN="$NPM_PREFIX/bin/pi"
 	fi
 fi
 
+# Add pi's directory to PATH for this session so pi install subprocess works
+if [ -n "$PI_BIN" ]; then
+	PI_DIR="$(dirname "$PI_BIN")"
+	case ":$PATH:" in
+	*":$PI_DIR:"*) ;; # already in PATH
+	*)
+		export PATH="$PI_DIR:$PATH"
+		info "Added $PI_DIR to PATH for this session"
+		;;
+	esac
+	success "Pi is available: $PI_BIN"
+else
+	error "'pi' command not found. Check your PATH or reinstall Node.js."
+fi
+
 # ────────────────────────────────────────────
-# Step 2: Install packages
+# Step 2: Install packages using the resolved pi binary
 # ────────────────────────────────────────────
 info ""
 info "Installing Pi packages..."
@@ -121,7 +159,7 @@ for entry in "${PACKAGES[@]}"; do
 	COUNT=$((COUNT + 1))
 
 	info "[$COUNT/$TOTAL] $PKG — $DESC"
-    if pi install "npm:$PKG" 2>&1; then
+	if "$PI_BIN" install "npm:$PKG" 2>&1; then
 		success "  → $PKG installed"
 	else
 		warn "  → $PKG failed (install manually later: pi install npm:$PKG)"
@@ -152,6 +190,23 @@ info "════════════════════════
 success "Pi Coding Agent installation complete!"
 info "══════════════════════════════════════════"
 info ""
+info "Pi binary: $PI_BIN"
+info ""
+if [ -n "$PI_DIR" ]; then
+	case ":$PATH:" in
+	*":$PI_DIR:"*) ;;
+	*)
+		SHELL_RC=""
+		if [ -f "$HOME/.bashrc" ]; then SHELL_RC="$HOME/.bashrc"; elif [ -f "$HOME/.zshrc" ]; then SHELL_RC="$HOME/.zshrc"; fi
+		if [ -n "$SHELL_RC" ]; then
+			info "NOTE: Add $PI_DIR to your PATH permanently by running:"
+			info "  echo 'export PATH=\"$PI_DIR:\$PATH\"' >> $SHELL_RC"
+			info "  source $SHELL_RC"
+		fi
+		;;
+	esac
+fi
+info ""
 info "Getting started:"
 info "  1. Navigate to your project: cd /path/to/project"
 info "  2. Start Pi: pi"