shellwise 0.1.1 → 0.1.3

package/README.md

@@ -31,11 +31,17 @@ Tab/Shift+Tab to navigate, Enter to select, Esc to dismiss
 
 ## Install
 
+> **Important:** This is a CLI tool — install it **globally**.
+
 ```bash
+# Recommended
 bun install -g shellwise
+
+# Or with npm
+npm install -g shellwise
 ```
 
-That's it. Shell integration is auto-injected into your `~/.zshrc` or `~/.bashrc` on install. Restart your terminal to activate.
+Shell integration is auto-injected into your `~/.zshrc` or `~/.bashrc` on install. Restart your terminal to activate.
 
 ### Manual setup
 
@@ -43,10 +49,10 @@ If auto-setup didn't work, add to your shell config:
 
 ```bash
 # ~/.zshrc
-eval "$(sw init zsh)"
+eval "$(shellwise init zsh)"
 
 # ~/.bashrc
-eval "$(sw init bash)"
+eval "$(shellwise init bash)"
 ```
 
 ## Usage
@@ -76,29 +82,31 @@ Press `Ctrl+R` to open full fuzzy search:
 
 ### Commands
 
+Both `shellwise` and `sw` work as the command name:
+
 ```bash
-sw search [--query <text>]     # Interactive fuzzy search (Ctrl+R)
-sw suggest --query <text>      # Get top suggestion (used by shell hook)
-sw add --command <cmd>         # Save a command to history
-sw init <zsh|bash>             # Output shell integration script
-sw import [zsh|bash]           # Import existing shell history
-sw stats                       # Show usage statistics
-sw prune --days <n>            # Remove entries older than n days
-sw daemon start|stop|status    # Manage background daemon
+shellwise search [--query <text>]     # Interactive fuzzy search (Ctrl+R)
+shellwise suggest --query <text>      # Get top suggestion (used by shell hook)
+shellwise add --command <cmd>         # Save a command to history
+shellwise init <zsh|bash>             # Output shell integration script
+shellwise import [zsh|bash]           # Import existing shell history
+shellwise stats                       # Show usage statistics
+shellwise prune --days <n>            # Remove entries older than n days
+shellwise daemon start|stop|status    # Manage background daemon
 ```
 
 ### Import existing history
 
 ```bash
-sw import zsh    # Import from ~/.zsh_history
-sw import bash   # Import from ~/.bash_history
+shellwise import zsh    # Import from ~/.zsh_history
+shellwise import bash   # Import from ~/.bash_history
 ```
 
 ## Architecture
 
 ```
 ┌──────────────┐     TCP (persistent)     ┌──────────────────┐
-│   Zsh/Bash   │◄────────────────────────►│   sw daemon      │
+│   Zsh/Bash   │◄────────────────────────►│ shellwise daemon │
 │   (shell)    │     ~1-3ms round-trip    │   (Bun process)  │
 └──────────────┘                          └────────┬─────────┘
                                                    │
@@ -132,6 +140,7 @@ sw import bash   # Import from ~/.bash_history
 
 ```bash
 bun remove -g shellwise
+# or: npm uninstall -g shellwise
 ```
 
 Shell integration is automatically removed from your config on uninstall.

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "shellwise",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Smart command history with inline auto-suggest and fuzzy search for your terminal",
   "type": "module",
   "bin": {
+    "shellwise": "./bin/sw.js",
     "sw": "./bin/sw.js"
   },
   "files": [

package/scripts/setup.sh

@@ -10,15 +10,33 @@ DIM='\033[2m'
 BOLD='\033[1m'
 RESET='\033[0m'
 
+# Detect if this is a local (not global) install
+if [[ -z "$(command -v shellwise 2>/dev/null)" && -z "$(command -v sw 2>/dev/null)" ]]; then
+  # Check if we're inside node_modules (local install)
+  if [[ "$PWD" == *"node_modules"* ]] || [[ "${INIT_CWD:-}" == *"node_modules"* ]]; then
+    echo -e "${YELLOW}${BOLD}[shellwise]${RESET} This is a CLI tool — install it globally:"
+    echo -e "  ${BOLD}bun install -g shellwise${RESET}"
+    echo -e "  ${DIM}or: npm install -g shellwise${RESET}"
+    exit 0
+  fi
+fi
+
 MARKER="# shellwise shell integration"
 
-# Detect sw binary path
+# Detect shellwise binary path (prefer 'shellwise' over 'sw' to avoid conflicts)
 SW_BIN=""
-if command -v sw &>/dev/null; then
-  SW_BIN="sw"
-else
-  # Try common global bin paths
-  for p in "$HOME/.bun/bin/sw" "$HOME/.local/bin/sw" "$(npm prefix -g 2>/dev/null)/bin/sw"; do
+if command -v shellwise &>/dev/null; then
+  SW_BIN="shellwise"
+elif command -v sw &>/dev/null; then
+  # Verify it's actually shellwise, not another tool
+  if sw --help 2>&1 | grep -q "shellwise" 2>/dev/null; then
+    SW_BIN="sw"
+  fi
+fi
+
+# Try common global bin paths
+if [[ -z "$SW_BIN" ]]; then
+  for p in "$HOME/.bun/bin/shellwise" "$HOME/.local/bin/shellwise" "$(npm prefix -g 2>/dev/null)/bin/shellwise"; do
     if [[ -x "$p" ]]; then
       SW_BIN="$p"
       break
@@ -27,8 +45,8 @@ else
 fi
 
 if [[ -z "$SW_BIN" ]]; then
-  echo -e "${YELLOW}[shellwise]${RESET} Could not find sw binary. Add manually:"
-  echo '  eval "$(sw init zsh)"   # add to ~/.zshrc'
+  echo -e "${YELLOW}[shellwise]${RESET} Could not find shellwise binary. Add manually:"
+  echo '  eval "$(shellwise init zsh)"   # add to ~/.zshrc'
   exit 0
 fi
 
@@ -75,14 +93,16 @@ case "$SHELL_NAME" in
   *)
     echo -e "${YELLOW}[shellwise]${RESET} Unsupported shell: $SHELL_NAME"
     echo '  Supported: zsh, bash'
-    echo '  Add manually: eval "$(sw init zsh)"'
+    echo '  Add manually: eval "$(shellwise init zsh)"'
     exit 0
     ;;
 esac
 
 # Start daemon for fast suggest
-if command -v sw &>/dev/null; then
-  sw daemon start &>/dev/null || true
+if command -v shellwise &>/dev/null; then
+  shellwise daemon start &>/dev/null || true
+elif [[ -n "$SW_BIN" ]]; then
+  $SW_BIN daemon start &>/dev/null || true
 fi
 
 echo -e "${GREEN}${BOLD}[shellwise]${RESET} Restart your terminal or run: ${BOLD}source ~/.${SHELL_NAME}rc${RESET}"

package/src/index.ts

@@ -29,7 +29,7 @@ function parseFlags(args: string[]): Record<string, string> {
 function printHelp(): void {
   console.log(`shellwise - Smart command history with fuzzy search
 
-Usage: sw <command> [options]
+Usage: shellwise <command> [options]  (or: sw <command>)
 
 Commands:
   search [--query <text>]     Interactive fuzzy search (Ctrl+R)
@@ -42,8 +42,8 @@ Commands:
   daemon start|stop|status    Manage background daemon (faster suggest)
 
 Setup:
-  Add to ~/.zshrc:   eval "$(sw init zsh)"
-  Add to ~/.bashrc:  eval "$(sw init bash)"
+  Add to ~/.zshrc:   eval "$(shellwise init zsh)"
+  Add to ~/.bashrc:  eval "$(shellwise init bash)"
 
 Features:
   - Auto-save: commands are recorded automatically
@@ -80,7 +80,7 @@ async function main(): Promise<void> {
       case "add": {
         const flags = parseFlags(args.slice(1));
         if (!flags.command) {
-          console.error("Usage: sw add --command <cmd>");
+          console.error("Usage: shellwise add --command <cmd>");
           process.exit(1);
         }
 
@@ -106,10 +106,10 @@ async function main(): Promise<void> {
       case "init": {
         const shell = args[1];
         if (!shell) {
-          console.error("Usage: sw init <zsh|bash>");
+          console.error("Usage: shellwise init <zsh|bash>");
           process.exit(1);
         }
-        runInit(shell, "sw");
+        runInit(shell, "shellwise");
         break;
       }
 
@@ -139,7 +139,7 @@ async function main(): Promise<void> {
               return;
             }
             // Fork to background
-            const proc = Bun.spawn(["sw", "daemon", "_run"], {
+            const proc = Bun.spawn(["shellwise", "daemon", "_run"], {
               stdio: ["ignore", "ignore", "ignore"],
               // @ts-ignore - Bun supports detached
               detached: true,
@@ -179,7 +179,7 @@ async function main(): Promise<void> {
             break;
           }
           default:
-            console.error("Usage: sw daemon start|stop|status");
+            console.error("Usage: shellwise daemon start|stop|status");
             process.exit(1);
         }
         break;