@nemus-cli/nemus 0.13.0 → 0.14.0

package/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.14.0] - 2026-09-02
+
+### Changed
+
+- **Shell integration now keeps its generated functions out of your shell RC
+  files.** Nemus writes them to `~/.nemus/shell-integration.sh` and adds only a
+  single guarded `source` line to `.zshrc`/`.bashrc`, so upgrades no longer
+  churn hundreds of lines in your personal shell config. Existing inline
+  installations migrate automatically without disturbing surrounding user
+  content, and reinstalls stay idempotent. Uninstall removes the generated file
+  too. Thanks to @uzikilon for the idea and original implementation (#50).
+
 ## [0.13.0] - 2026-09-02
 
 ### Added

package/README.md

@@ -138,7 +138,9 @@ npm install -g @nemus-cli/nemus
 ```
 
 The postinstall step sets up optional shell integration (auto-cd into new
-workspaces + a quick-navigate helper).
+workspaces + a quick-navigate helper). It keeps the generated functions in
+`~/.nemus/shell-integration.sh` and adds only a guarded source line to your
+shell RC file, so upgrades don't churn your `.zshrc`/`.bashrc`.
 
 ### From source
 

package/install-shell-integration.sh

@@ -491,17 +491,30 @@ else
   exit 1
 fi
 
-# Check if already installed (version marker is in the grep below)
-if grep -q "Shell Integration (v50)" "$RC_FILE" 2>/dev/null; then
+# Keep the generated functions out of the user's shell config. The same file
+# works in both bash and zsh; the RC file only needs this guarded source line.
+SHELL_INTEGRATION_DIR="$HOME/.nemus"
+SHELL_INTEGRATION_FILE="$SHELL_INTEGRATION_DIR/shell-integration.sh"
+SOURCE_LINE='[ -f "$HOME/.nemus/shell-integration.sh" ] && source "$HOME/.nemus/shell-integration.sh"'
+
+mkdir -p "$SHELL_INTEGRATION_DIR"
+SHELL_TMPFILE=$(mktemp "$SHELL_INTEGRATION_DIR/.shell-integration.XXXXXX")
+printf '%s\n' "$SHELL_FUNCTION" > "$SHELL_TMPFILE"
+mv "$SHELL_TMPFILE" "$SHELL_INTEGRATION_FILE"
+
+append_source_line() {
+  printf '\n# Nemus - Shell Integration\n%s\n' "$SOURCE_LINE" >> "$1"
+}
+
+# Check if already installed
+if grep -Fq "$SOURCE_LINE" "$RC_FILE" 2>/dev/null; then
   echo "✅ Shell integration already up to date in $RC_FILE"
 elif grep -q "# Nemus - Shell Integration" "$RC_FILE" 2>/dev/null; then
-  # Old version installed — remove it and install new version
+  # Old inline version installed — remove it and leave only the source line
   echo "🔄 Upgrading shell integration in $RC_FILE..."
   TMPFILE=$(mktemp)
   awk -f "$SCRIPT_DIR/remove-shell-block.awk" "$RC_FILE" > "$TMPFILE"
-  # Append new shell integration to temp file so mv is atomic
-  echo "" >> "$TMPFILE"
-  echo "$SHELL_FUNCTION" >> "$TMPFILE"
+  append_source_line "$TMPFILE"
   cp "$RC_FILE" "${RC_FILE}.backup.$(date +%Y%m%d_%H%M%S)"
   chmod --reference="$RC_FILE" "$TMPFILE" 2>/dev/null || chmod "$(stat -f '%Lp' "$RC_FILE")" "$TMPFILE" 2>/dev/null || true
   mv "$TMPFILE" "$RC_FILE"
@@ -514,9 +527,8 @@ else
     echo "📦 Backup created: ${RC_FILE}.backup.*"
   fi
 
-  # Append shell function (creates the file if it doesn't exist)
-  echo "" >> "$RC_FILE"
-  echo "$SHELL_FUNCTION" >> "$RC_FILE"
+  # Append the source line (creates the file if it doesn't exist)
+  append_source_line "$RC_FILE"
 
   echo "✅ Shell integration installed in $RC_FILE"
   echo ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nemus-cli/nemus",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "workspaces": [
     "packages/*"
   ],

package/remove-shell-block.awk

@@ -33,6 +33,14 @@ skip {
     saw_func = 1
     next
   }
+  if (/\.nemus\/shell-integration\.sh/ && /source/) {
+    # Current installs keep the functions in a generated file and leave only
+    # this source line in the RC file.
+    skip = 0
+    saw_func = 0
+    buf = ""
+    next
+  }
   # Non-function line: block is over — emit any buffered lines
   skip = 0
   if (buf != "") printf "%s", buf

package/uninstall.sh

@@ -38,7 +38,7 @@ echo -e "${YELLOW}This will NOT remove:${NC}"
 echo "  • Your workspaces ($HOME/workspaces/)"
 echo "  • Cache files (~/.workspace-manager-cache/)"
 echo "  • Configuration files (~/.workspace-manager-claude-config.json)"
-echo "  • Shell integration (from .zshrc or .bashrc)"
+echo "  • Shell integration (from .zshrc or .bashrc and ~/.nemus/)"
 echo "  • ghq (if installed)"
 echo ""
 
@@ -85,8 +85,11 @@ if [[ $REPLY =~ ^[Yy]$ ]]; then
         if grep -q "# Nemus - Shell Integration" "$HOME/.zshrc"; then
             # Create backup
             cp "$HOME/.zshrc" "$HOME/.zshrc.backup.$(date +%Y%m%d_%H%M%S)"
-            # Remove the function
-            sed -i.bak '/# Nemus - Shell Integration/,/^}$/d' "$HOME/.zshrc"
+            # Remove the block/source line (awk handles both formats safely)
+            TMPFILE=$(mktemp)
+            awk -f "$SCRIPT_DIR/remove-shell-block.awk" "$HOME/.zshrc" > "$TMPFILE"
+            chmod --reference="$HOME/.zshrc" "$TMPFILE" 2>/dev/null || chmod "$(stat -f '%Lp' "$HOME/.zshrc")" "$TMPFILE" 2>/dev/null || true
+            mv "$TMPFILE" "$HOME/.zshrc"
             print_success "Removed from .zshrc (backup created)"
         fi
     fi
@@ -96,11 +99,19 @@ if [[ $REPLY =~ ^[Yy]$ ]]; then
         if grep -q "# Nemus - Shell Integration" "$HOME/.bashrc"; then
             # Create backup
             cp "$HOME/.bashrc" "$HOME/.bashrc.backup.$(date +%Y%m%d_%H%M%S)"
-            # Remove the function
-            sed -i.bak '/# Nemus - Shell Integration/,/^}$/d' "$HOME/.bashrc"
+            # Remove the block/source line (awk handles both formats safely)
+            TMPFILE=$(mktemp)
+            awk -f "$SCRIPT_DIR/remove-shell-block.awk" "$HOME/.bashrc" > "$TMPFILE"
+            chmod --reference="$HOME/.bashrc" "$TMPFILE" 2>/dev/null || chmod "$(stat -f '%Lp' "$HOME/.bashrc")" "$TMPFILE" 2>/dev/null || true
+            mv "$TMPFILE" "$HOME/.bashrc"
             print_success "Removed from .bashrc (backup created)"
         fi
     fi
+
+    if [ -f "$HOME/.nemus/shell-integration.sh" ]; then
+        rm -f "$HOME/.nemus/shell-integration.sh"
+        print_success "Removed ~/.nemus/shell-integration.sh"
+    fi
 fi
 
 # Optionally remove cache