fluxy-bot 0.2.35 → 0.2.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fluxy-bot",
-  "version": "0.2.35",
+  "version": "0.2.36",
   "description": "Self-hosted AI bot — run your own AI assistant from anywhere",
   "type": "module",
   "license": "MIT",

package/scripts/install

@@ -0,0 +1,279 @@
+#!/bin/sh
+set -e
+
+# ─── Fluxy Installer ────────────────────────────────────────────────────────
+# curl -fsSL https://fluxy.bot/install | sh
+#
+# Downloads Node.js + Fluxy into ~/.fluxy — no system dependencies needed.
+# ─────────────────────────────────────────────────────────────────────────────
+
+MIN_NODE_MAJOR=18
+NODE_VERSION="22.14.0"
+FLUXY_HOME="$HOME/.fluxy"
+TOOLS_DIR="$FLUXY_HOME/tools"
+NODE_DIR="$TOOLS_DIR/node"
+BIN_DIR="$FLUXY_HOME/bin"
+USE_SYSTEM_NODE=false
+
+CYAN='\033[36m'
+GREEN='\033[32m'
+YELLOW='\033[33m'
+RED='\033[31m'
+DIM='\033[2m'
+BOLD='\033[1m'
+RESET='\033[0m'
+
+printf "\n${CYAN}${BOLD}  ╔═══════════════════════════════╗${RESET}\n"
+printf "${CYAN}${BOLD}  ║         FLUXY               ║${RESET}\n"
+printf "${CYAN}${BOLD}  ╚═══════════════════════════════╝${RESET}\n"
+printf "${DIM}  Self-hosted AI bot${RESET}\n\n"
+
+# ─── Detect platform ────────────────────────────────────────────────────────
+
+detect_platform() {
+  OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+  ARCH=$(uname -m)
+
+  case "$OS" in
+    linux)  PLATFORM="linux" ;;
+    darwin) PLATFORM="darwin" ;;
+    *)
+      printf "  ${RED}✗${RESET}  Unsupported OS: $OS\n"
+      exit 1
+      ;;
+  esac
+
+  case "$ARCH" in
+    x86_64)          NODEARCH="x64" ;;
+    aarch64|arm64)   NODEARCH="arm64" ;;
+    armv7l|armv6l)   NODEARCH="armv7l" ;;
+    *)
+      printf "  ${RED}✗${RESET}  Unsupported architecture: $ARCH\n"
+      exit 1
+      ;;
+  esac
+
+  printf "  ${DIM}Platform: ${PLATFORM}/${NODEARCH}${RESET}\n"
+}
+
+# ─── Check for system Node.js ─────────────────────────────────────────────
+
+check_system_node() {
+  if command -v node >/dev/null 2>&1; then
+    SYS_NODE_VERSION=$(node -v 2>/dev/null || echo "")
+    if [ -n "$SYS_NODE_VERSION" ]; then
+      MAJOR=$(echo "$SYS_NODE_VERSION" | sed 's/^v//' | cut -d. -f1)
+      if [ "$MAJOR" -ge "$MIN_NODE_MAJOR" ] 2>/dev/null; then
+        USE_SYSTEM_NODE=true
+        printf "  ${GREEN}✔${RESET}  Node.js ${SYS_NODE_VERSION} (system)\n"
+        return 0
+      fi
+    fi
+  fi
+  return 1
+}
+
+# ─── Download Node.js ───────────────────────────────────────────────────────
+
+install_node() {
+  # Check if we already have a bundled node that works
+  if [ -x "$NODE_DIR/bin/node" ]; then
+    EXISTING=$("$NODE_DIR/bin/node" -v 2>/dev/null || echo "")
+    if [ -n "$EXISTING" ]; then
+      printf "  ${GREEN}✔${RESET}  Node.js ${EXISTING} (bundled)\n"
+      return 0
+    fi
+  fi
+
+  printf "  ${CYAN}↓${RESET}  Downloading Node.js v${NODE_VERSION}...\n"
+
+  NODE_URL="https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-${PLATFORM}-${NODEARCH}.tar.xz"
+  TMPFILE=$(mktemp /tmp/node-XXXXXX.tar.xz)
+
+  # Download
+  if command -v curl >/dev/null 2>&1; then
+    curl -fsSL -o "$TMPFILE" "$NODE_URL"
+  elif command -v wget >/dev/null 2>&1; then
+    wget -qO "$TMPFILE" "$NODE_URL"
+  else
+    printf "  ${RED}✗${RESET}  curl or wget required\n"
+    exit 1
+  fi
+
+  # Extract
+  mkdir -p "$TOOLS_DIR"
+  rm -rf "$NODE_DIR"
+  mkdir -p "$NODE_DIR"
+
+  tar xf "$TMPFILE" -C "$NODE_DIR" --strip-components=1
+  rm -f "$TMPFILE"
+
+  # Verify
+  if [ ! -x "$NODE_DIR/bin/node" ]; then
+    printf "  ${RED}✗${RESET}  Node.js download failed\n"
+    exit 1
+  fi
+
+  printf "  ${GREEN}✔${RESET}  Node.js v${NODE_VERSION} installed\n"
+}
+
+# ─── Install Fluxy ────────────────────────────────────────────────────────
+
+install_fluxy() {
+  if [ "$USE_SYSTEM_NODE" = true ]; then
+    NPM="npm"
+    NODE="node"
+  else
+    NPM="$NODE_DIR/bin/npm"
+    NODE="$NODE_DIR/bin/node"
+  fi
+
+  printf "  ${CYAN}↓${RESET}  Installing fluxy...\n"
+
+  # Get tarball URL from npm registry
+  TARBALL_URL=$("$NPM" view fluxy-bot dist.tarball 2>/dev/null)
+  if [ -z "$TARBALL_URL" ]; then
+    printf "  ${RED}✗${RESET}  Failed to fetch package info from npm\n"
+    exit 1
+  fi
+
+  # Download and extract tarball
+  TMPDIR=$(mktemp -d)
+  if command -v curl >/dev/null 2>&1; then
+    curl -fsSL -o "$TMPDIR/fluxy.tgz" "$TARBALL_URL"
+  elif command -v wget >/dev/null 2>&1; then
+    wget -qO "$TMPDIR/fluxy.tgz" "$TARBALL_URL"
+  fi
+
+  tar xzf "$TMPDIR/fluxy.tgz" -C "$TMPDIR"
+  EXTRACTED="$TMPDIR/package"
+
+  if [ ! -d "$EXTRACTED" ]; then
+    rm -rf "$TMPDIR"
+    printf "  ${RED}✗${RESET}  Installation failed\n"
+    exit 1
+  fi
+
+  # Copy source files to ~/.fluxy/ (preserves existing config.json, memory.db, etc.)
+  cp -r "$EXTRACTED"/* "$FLUXY_HOME"/
+  cp -r "$EXTRACTED"/.[!.]* "$FLUXY_HOME"/ 2>/dev/null || true
+  rm -rf "$TMPDIR"
+
+  # Install dependencies inside ~/.fluxy/
+  (cd "$FLUXY_HOME" && "$NPM" install --omit=dev 2>/dev/null)
+
+  # Build chat interface if not pre-built in the tarball
+  if [ -d "$FLUXY_HOME/dist-fluxy" ] && [ -f "$FLUXY_HOME/dist-fluxy/onboard.html" ]; then
+    printf "  ${GREEN}✔${RESET}  Chat interface ready\n"
+  else
+    printf "  ${CYAN}↓${RESET}  Building chat interface...\n"
+    if (cd "$FLUXY_HOME" && "$NPM" run build:fluxy 2>/dev/null); then
+      printf "  ${GREEN}✔${RESET}  Chat interface built\n"
+    else
+      printf "  ${YELLOW}!${RESET}  Chat build skipped — will build on first start\n"
+    fi
+  fi
+
+  # Verify
+  if [ ! -f "$FLUXY_HOME/bin/cli.js" ]; then
+    printf "  ${RED}✗${RESET}  Installation failed\n"
+    exit 1
+  fi
+
+  VERSION=$("$NODE" -e "const p=JSON.parse(require('fs').readFileSync('$FLUXY_HOME/package.json','utf8'));console.log(p.version)" 2>/dev/null || echo "unknown")
+
+  printf "  ${GREEN}✔${RESET}  Fluxy v${VERSION} installed\n"
+}
+
+# ─── Create wrapper script ──────────────────────────────────────────────────
+
+create_wrapper() {
+  mkdir -p "$BIN_DIR"
+
+  # Remove any existing wrapper/symlink
+  rm -f "$BIN_DIR/fluxy"
+
+  if [ "$USE_SYSTEM_NODE" = true ]; then
+    cat > "$BIN_DIR/fluxy" << 'WRAPPER'
+#!/bin/sh
+CLI="$HOME/.fluxy/bin/cli.js"
+exec node "$CLI" "$@"
+WRAPPER
+  else
+    cat > "$BIN_DIR/fluxy" << 'WRAPPER'
+#!/bin/sh
+FLUXY_HOME="$HOME/.fluxy"
+NODE="$FLUXY_HOME/tools/node/bin/node"
+CLI="$FLUXY_HOME/bin/cli.js"
+exec "$NODE" "$CLI" "$@"
+WRAPPER
+  fi
+
+  chmod +x "$BIN_DIR/fluxy"
+  printf "  ${GREEN}✔${RESET}  Created ${DIM}~/.fluxy/bin/fluxy${RESET}\n"
+}
+
+# ─── Add to PATH ────────────────────────────────────────────────────────────
+
+setup_path() {
+  SHELL_NAME=$(basename "$SHELL" 2>/dev/null || echo "sh")
+  EXPORT_LINE='export PATH="$HOME/.fluxy/bin:$PATH"'
+  ALREADY_IN_PATH=false
+
+  case ":$PATH:" in
+    *":$BIN_DIR:"*) ALREADY_IN_PATH=true ;;
+  esac
+
+  if [ "$ALREADY_IN_PATH" = true ]; then
+    return 0
+  fi
+
+  # Add to shell profile
+  PROFILE=""
+  case "$SHELL_NAME" in
+    zsh)  PROFILE="$HOME/.zshrc" ;;
+    bash)
+      if [ -f "$HOME/.bash_profile" ]; then
+        PROFILE="$HOME/.bash_profile"
+      else
+        PROFILE="$HOME/.bashrc"
+      fi
+      ;;
+    fish)
+      mkdir -p "$HOME/.config/fish"
+      if ! grep -q "fluxy/bin" "$HOME/.config/fish/config.fish" 2>/dev/null; then
+        echo 'set -gx PATH "$HOME/.fluxy/bin" $PATH' >> "$HOME/.config/fish/config.fish"
+      fi
+      printf "  ${GREEN}✔${RESET}  Added to PATH ${DIM}(~/.config/fish/config.fish)${RESET}\n"
+      return 0
+      ;;
+    *)    PROFILE="$HOME/.profile" ;;
+  esac
+
+  if [ -n "$PROFILE" ]; then
+    if ! grep -q "fluxy/bin" "$PROFILE" 2>/dev/null; then
+      printf "\n# Fluxy\n%s\n" "$EXPORT_LINE" >> "$PROFILE"
+    fi
+    printf "  ${GREEN}✔${RESET}  Added to PATH ${DIM}(${PROFILE})${RESET}\n"
+  fi
+
+  export PATH="$BIN_DIR:$PATH"
+}
+
+# ─── Main ────────────────────────────────────────────────────────────────────
+
+mkdir -p "$FLUXY_HOME"
+
+detect_platform
+check_system_node || install_node
+install_fluxy
+create_wrapper
+setup_path
+
+printf "\n  ${GREEN}${BOLD}✔  Fluxy is ready!${RESET}\n\n"
+printf "  Get started:\n\n"
+printf "    ${CYAN}fluxy init${RESET}      Set up your bot\n"
+printf "    ${CYAN}fluxy start${RESET}     Start your bot\n"
+printf "    ${CYAN}fluxy status${RESET}    Check if it's running\n\n"
+printf "  ${DIM}Run ${RESET}${CYAN}fluxy init${RESET}${DIM} to begin.${RESET}\n"
+printf "  ${DIM}(Open a new terminal if 'fluxy' isn't found yet)${RESET}\n\n"

package/scripts/install.sh

@@ -1,121 +1,279 @@
-#!/usr/bin/env bash
-set -euo pipefail
+#!/bin/sh
+set -e
 
-# ── Fluxy Installer ──
-# Downloads the latest fluxy-bot from npm and installs to ~/.fluxy/
+# ─── Fluxy Installer ────────────────────────────────────────────────────────
+# curl -fsSL https://fluxy.bot/install | sh
+#
+# Downloads Node.js + Fluxy into ~/.fluxy — no system dependencies needed.
+# ─────────────────────────────────────────────────────────────────────────────
 
+MIN_NODE_MAJOR=18
+NODE_VERSION="22.14.0"
 FLUXY_HOME="$HOME/.fluxy"
+TOOLS_DIR="$FLUXY_HOME/tools"
+NODE_DIR="$TOOLS_DIR/node"
+BIN_DIR="$FLUXY_HOME/bin"
+USE_SYSTEM_NODE=false
 
-c_reset='\033[0m'
-c_cyan='\033[36m'
-c_green='\033[32m'
-c_red='\033[31m'
-c_dim='\033[2m'
-c_bold='\033[1m'
+CYAN='\033[36m'
+GREEN='\033[32m'
+YELLOW='\033[33m'
+RED='\033[31m'
+DIM='\033[2m'
+BOLD='\033[1m'
+RESET='\033[0m'
 
-info()  { echo -e "  ${c_cyan}▸${c_reset} $1"; }
-ok()    { echo -e "  ${c_green}✔${c_reset} $1"; }
-err()   { echo -e "  ${c_red}✘${c_reset} $1" >&2; }
+printf "\n${CYAN}${BOLD}  ╔═══════════════════════════════╗${RESET}\n"
+printf "${CYAN}${BOLD}  ║         FLUXY               ║${RESET}\n"
+printf "${CYAN}${BOLD}  ╚═══════════════════════════════╝${RESET}\n"
+printf "${DIM}  Self-hosted AI bot${RESET}\n\n"
 
-echo -e "\n  ${c_cyan}${c_bold}Fluxy Installer${c_reset}\n"
+# ─── Detect platform ────────────────────────────────────────────────────────
 
-# ── Check dependencies ──
-for cmd in node npm curl tar; do
-  if ! command -v "$cmd" &>/dev/null; then
-    err "$cmd is required but not installed."
+detect_platform() {
+  OS=$(uname -s | tr '[:upper:]' '[:lower:]')
+  ARCH=$(uname -m)
+
+  case "$OS" in
+    linux)  PLATFORM="linux" ;;
+    darwin) PLATFORM="darwin" ;;
+    *)
+      printf "  ${RED}✗${RESET}  Unsupported OS: $OS\n"
+      exit 1
+      ;;
+  esac
+
+  case "$ARCH" in
+    x86_64)          NODEARCH="x64" ;;
+    aarch64|arm64)   NODEARCH="arm64" ;;
+    armv7l|armv6l)   NODEARCH="armv7l" ;;
+    *)
+      printf "  ${RED}✗${RESET}  Unsupported architecture: $ARCH\n"
+      exit 1
+      ;;
+  esac
+
+  printf "  ${DIM}Platform: ${PLATFORM}/${NODEARCH}${RESET}\n"
+}
+
+# ─── Check for system Node.js ─────────────────────────────────────────────
+
+check_system_node() {
+  if command -v node >/dev/null 2>&1; then
+    SYS_NODE_VERSION=$(node -v 2>/dev/null || echo "")
+    if [ -n "$SYS_NODE_VERSION" ]; then
+      MAJOR=$(echo "$SYS_NODE_VERSION" | sed 's/^v//' | cut -d. -f1)
+      if [ "$MAJOR" -ge "$MIN_NODE_MAJOR" ] 2>/dev/null; then
+        USE_SYSTEM_NODE=true
+        printf "  ${GREEN}✔${RESET}  Node.js ${SYS_NODE_VERSION} (system)\n"
+        return 0
+      fi
+    fi
+  fi
+  return 1
+}
+
+# ─── Download Node.js ───────────────────────────────────────────────────────
+
+install_node() {
+  # Check if we already have a bundled node that works
+  if [ -x "$NODE_DIR/bin/node" ]; then
+    EXISTING=$("$NODE_DIR/bin/node" -v 2>/dev/null || echo "")
+    if [ -n "$EXISTING" ]; then
+      printf "  ${GREEN}✔${RESET}  Node.js ${EXISTING} (bundled)\n"
+      return 0
+    fi
+  fi
+
+  printf "  ${CYAN}↓${RESET}  Downloading Node.js v${NODE_VERSION}...\n"
+
+  NODE_URL="https://nodejs.org/dist/v${NODE_VERSION}/node-v${NODE_VERSION}-${PLATFORM}-${NODEARCH}.tar.xz"
+  TMPFILE=$(mktemp /tmp/node-XXXXXX.tar.xz)
+
+  # Download
+  if command -v curl >/dev/null 2>&1; then
+    curl -fsSL -o "$TMPFILE" "$NODE_URL"
+  elif command -v wget >/dev/null 2>&1; then
+    wget -qO "$TMPFILE" "$NODE_URL"
+  else
+    printf "  ${RED}✗${RESET}  curl or wget required\n"
     exit 1
   fi
-done
-
-# ── Get tarball URL ──
-info "Fetching latest version..."
-TARBALL_URL=$(npm view fluxy-bot dist.tarball 2>/dev/null)
-if [ -z "$TARBALL_URL" ]; then
-  err "Failed to fetch tarball URL from npm."
-  exit 1
-fi
-VERSION=$(npm view fluxy-bot version 2>/dev/null)
-ok "Found fluxy-bot@${VERSION}"
-
-# ── Download and extract ──
-TMPDIR=$(mktemp -d)
-trap 'rm -rf "$TMPDIR"' EXIT
-
-info "Downloading..."
-curl -fsSL "$TARBALL_URL" -o "$TMPDIR/fluxy.tgz"
-ok "Downloaded"
-
-info "Extracting..."
-tar xzf "$TMPDIR/fluxy.tgz" -C "$TMPDIR"
-ok "Extracted"
-
-# npm pack tarballs extract into a 'package/' directory
-EXTRACTED="$TMPDIR/package"
-if [ ! -d "$EXTRACTED" ]; then
-  err "Unexpected tarball structure."
-  exit 1
-fi
-
-# ── Copy to ~/.fluxy/ ──
-info "Installing to $FLUXY_HOME..."
-mkdir -p "$FLUXY_HOME"
 
-# cp -r overwrites existing files but does NOT delete extras (config.json, memory.db, etc.)
-cp -r "$EXTRACTED"/* "$FLUXY_HOME"/
-# Also copy hidden files if any
-cp -r "$EXTRACTED"/.[!.]* "$FLUXY_HOME"/ 2>/dev/null || true
-ok "Files copied"
-
-# ── Install dependencies ──
-info "Installing dependencies (this may take a moment)..."
-cd "$FLUXY_HOME"
-npm install --omit=dev 2>/dev/null
-ok "Dependencies installed"
-
-# ── Build fluxy chat + onboard (served as static files) ──
-if [ -d "$FLUXY_HOME/dist-fluxy" ] && [ -f "$FLUXY_HOME/dist-fluxy/onboard.html" ]; then
-  ok "Chat interface (pre-built)"
-else
-  info "Building chat interface..."
-  if npm run build:fluxy; then
-    ok "Chat interface built"
+  # Extract
+  mkdir -p "$TOOLS_DIR"
+  rm -rf "$NODE_DIR"
+  mkdir -p "$NODE_DIR"
+
+  tar xf "$TMPFILE" -C "$NODE_DIR" --strip-components=1
+  rm -f "$TMPFILE"
+
+  # Verify
+  if [ ! -x "$NODE_DIR/bin/node" ]; then
+    printf "  ${RED}✗${RESET}  Node.js download failed\n"
+    exit 1
+  fi
+
+  printf "  ${GREEN}✔${RESET}  Node.js v${NODE_VERSION} installed\n"
+}
+
+# ─── Install Fluxy ────────────────────────────────────────────────────────
+
+install_fluxy() {
+  if [ "$USE_SYSTEM_NODE" = true ]; then
+    NPM="npm"
+    NODE="node"
+  else
+    NPM="$NODE_DIR/bin/npm"
+    NODE="$NODE_DIR/bin/node"
+  fi
+
+  printf "  ${CYAN}↓${RESET}  Installing fluxy...\n"
+
+  # Get tarball URL from npm registry
+  TARBALL_URL=$("$NPM" view fluxy-bot dist.tarball 2>/dev/null)
+  if [ -z "$TARBALL_URL" ]; then
+    printf "  ${RED}✗${RESET}  Failed to fetch package info from npm\n"
+    exit 1
+  fi
+
+  # Download and extract tarball
+  TMPDIR=$(mktemp -d)
+  if command -v curl >/dev/null 2>&1; then
+    curl -fsSL -o "$TMPDIR/fluxy.tgz" "$TARBALL_URL"
+  elif command -v wget >/dev/null 2>&1; then
+    wget -qO "$TMPDIR/fluxy.tgz" "$TARBALL_URL"
+  fi
+
+  tar xzf "$TMPDIR/fluxy.tgz" -C "$TMPDIR"
+  EXTRACTED="$TMPDIR/package"
+
+  if [ ! -d "$EXTRACTED" ]; then
+    rm -rf "$TMPDIR"
+    printf "  ${RED}✗${RESET}  Installation failed\n"
+    exit 1
+  fi
+
+  # Copy source files to ~/.fluxy/ (preserves existing config.json, memory.db, etc.)
+  cp -r "$EXTRACTED"/* "$FLUXY_HOME"/
+  cp -r "$EXTRACTED"/.[!.]* "$FLUXY_HOME"/ 2>/dev/null || true
+  rm -rf "$TMPDIR"
+
+  # Install dependencies inside ~/.fluxy/
+  (cd "$FLUXY_HOME" && "$NPM" install --omit=dev 2>/dev/null)
+
+  # Build chat interface if not pre-built in the tarball
+  if [ -d "$FLUXY_HOME/dist-fluxy" ] && [ -f "$FLUXY_HOME/dist-fluxy/onboard.html" ]; then
+    printf "  ${GREEN}✔${RESET}  Chat interface ready\n"
+  else
+    printf "  ${CYAN}↓${RESET}  Building chat interface...\n"
+    if (cd "$FLUXY_HOME" && "$NPM" run build:fluxy 2>/dev/null); then
+      printf "  ${GREEN}✔${RESET}  Chat interface built\n"
+    else
+      printf "  ${YELLOW}!${RESET}  Chat build skipped — will build on first start\n"
+    fi
+  fi
+
+  # Verify
+  if [ ! -f "$FLUXY_HOME/bin/cli.js" ]; then
+    printf "  ${RED}✗${RESET}  Installation failed\n"
+    exit 1
+  fi
+
+  VERSION=$("$NODE" -e "const p=JSON.parse(require('fs').readFileSync('$FLUXY_HOME/package.json','utf8'));console.log(p.version)" 2>/dev/null || echo "unknown")
+
+  printf "  ${GREEN}✔${RESET}  Fluxy v${VERSION} installed\n"
+}
+
+# ─── Create wrapper script ──────────────────────────────────────────────────
+
+create_wrapper() {
+  mkdir -p "$BIN_DIR"
+
+  # Remove any existing wrapper/symlink
+  rm -f "$BIN_DIR/fluxy"
+
+  if [ "$USE_SYSTEM_NODE" = true ]; then
+    cat > "$BIN_DIR/fluxy" << 'WRAPPER'
+#!/bin/sh
+CLI="$HOME/.fluxy/bin/cli.js"
+exec node "$CLI" "$@"
+WRAPPER
   else
-    err "Chat interface build failed — it will be built on first start"
+    cat > "$BIN_DIR/fluxy" << 'WRAPPER'
+#!/bin/sh
+FLUXY_HOME="$HOME/.fluxy"
+NODE="$FLUXY_HOME/tools/node/bin/node"
+CLI="$FLUXY_HOME/bin/cli.js"
+exec "$NODE" "$CLI" "$@"
+WRAPPER
   fi
-fi
-
-# ── Create symlink ──
-info "Creating fluxy command..."
-chmod +x "$FLUXY_HOME/bin/cli.js"
-
-SYMLINK_TARGET="$FLUXY_HOME/bin/cli.js"
-SYMLINK_CREATED=false
-
-# Try /usr/local/bin first
-if [ -d "/usr/local/bin" ] && [ -w "/usr/local/bin" ]; then
-  ln -sf "$SYMLINK_TARGET" /usr/local/bin/fluxy
-  SYMLINK_CREATED=true
-  ok "Created /usr/local/bin/fluxy"
-elif [ -d "/usr/local/bin" ]; then
-  # Try with sudo
-  if sudo ln -sf "$SYMLINK_TARGET" /usr/local/bin/fluxy 2>/dev/null; then
-    SYMLINK_CREATED=true
-    ok "Created /usr/local/bin/fluxy (sudo)"
+
+  chmod +x "$BIN_DIR/fluxy"
+  printf "  ${GREEN}✔${RESET}  Created ${DIM}~/.fluxy/bin/fluxy${RESET}\n"
+}
+
+# ─── Add to PATH ────────────────────────────────────────────────────────────
+
+setup_path() {
+  SHELL_NAME=$(basename "$SHELL" 2>/dev/null || echo "sh")
+  EXPORT_LINE='export PATH="$HOME/.fluxy/bin:$PATH"'
+  ALREADY_IN_PATH=false
+
+  case ":$PATH:" in
+    *":$BIN_DIR:"*) ALREADY_IN_PATH=true ;;
+  esac
+
+  if [ "$ALREADY_IN_PATH" = true ]; then
+    return 0
   fi
-fi
-
-# Fallback to ~/.local/bin
-if [ "$SYMLINK_CREATED" = false ]; then
-  mkdir -p "$HOME/.local/bin"
-  ln -sf "$SYMLINK_TARGET" "$HOME/.local/bin/fluxy"
-  ok "Created ~/.local/bin/fluxy"
-
-  # Check if ~/.local/bin is in PATH
-  if ! echo "$PATH" | tr ':' '\n' | grep -q "$HOME/.local/bin"; then
-    echo -e "\n  ${c_dim}Add ~/.local/bin to your PATH:${c_reset}"
-    echo -e "  ${c_dim}  export PATH=\"\$HOME/.local/bin:\$PATH\"${c_reset}"
+
+  # Add to shell profile
+  PROFILE=""
+  case "$SHELL_NAME" in
+    zsh)  PROFILE="$HOME/.zshrc" ;;
+    bash)
+      if [ -f "$HOME/.bash_profile" ]; then
+        PROFILE="$HOME/.bash_profile"
+      else
+        PROFILE="$HOME/.bashrc"
+      fi
+      ;;
+    fish)
+      mkdir -p "$HOME/.config/fish"
+      if ! grep -q "fluxy/bin" "$HOME/.config/fish/config.fish" 2>/dev/null; then
+        echo 'set -gx PATH "$HOME/.fluxy/bin" $PATH' >> "$HOME/.config/fish/config.fish"
+      fi
+      printf "  ${GREEN}✔${RESET}  Added to PATH ${DIM}(~/.config/fish/config.fish)${RESET}\n"
+      return 0
+      ;;
+    *)    PROFILE="$HOME/.profile" ;;
+  esac
+
+  if [ -n "$PROFILE" ]; then
+    if ! grep -q "fluxy/bin" "$PROFILE" 2>/dev/null; then
+      printf "\n# Fluxy\n%s\n" "$EXPORT_LINE" >> "$PROFILE"
+    fi
+    printf "  ${GREEN}✔${RESET}  Added to PATH ${DIM}(${PROFILE})${RESET}\n"
   fi
-fi
 
-echo -e "\n  ${c_green}${c_bold}Fluxy v${VERSION} installed successfully!${c_reset}"
-echo -e "  ${c_dim}Run 'fluxy' to start your bot.${c_reset}\n"
+  export PATH="$BIN_DIR:$PATH"
+}
+
+# ─── Main ────────────────────────────────────────────────────────────────────
+
+mkdir -p "$FLUXY_HOME"
+
+detect_platform
+check_system_node || install_node
+install_fluxy
+create_wrapper
+setup_path
+
+printf "\n  ${GREEN}${BOLD}✔  Fluxy is ready!${RESET}\n\n"
+printf "  Get started:\n\n"
+printf "    ${CYAN}fluxy init${RESET}      Set up your bot\n"
+printf "    ${CYAN}fluxy start${RESET}     Start your bot\n"
+printf "    ${CYAN}fluxy status${RESET}    Check if it's running\n\n"
+printf "  ${DIM}Run ${RESET}${CYAN}fluxy init${RESET}${DIM} to begin.${RESET}\n"
+printf "  ${DIM}(Open a new terminal if 'fluxy' isn't found yet)${RESET}\n\n"

package/supervisor/fluxy-agent.ts

@@ -6,11 +6,10 @@
 import { query, type SDKMessage, type SDKUserMessage } from '@anthropic-ai/claude-agent-sdk';
 import fs from 'fs';
 import path from 'path';
-import os from 'os';
 import { log } from '../shared/logger.js';
 import { DATA_DIR, PKG_DIR } from '../shared/paths.js';
+import { getClaudeAccessToken } from '../worker/claude-auth.js';
 
-const CREDENTIALS_FILE = path.join(os.homedir(), '.claude', '.credentials.json');
 const PROMPT_FILE = path.join(import.meta.dirname, '..', 'worker', 'prompts', 'fluxy-system-prompt.txt');
 
 // In-memory session tracking (conversationId → sessionId)
@@ -58,22 +57,6 @@ function buildMultiPartPrompt(text: string, attachments: AgentAttachment[]): Asy
   })();
 }
 
-/** Read the OAuth token stored by claude-auth */
-function readOAuthToken(): string | null {
-  try {
-    if (fs.existsSync(CREDENTIALS_FILE)) {
-      const creds = JSON.parse(fs.readFileSync(CREDENTIALS_FILE, 'utf-8'));
-      // Support both flat format ({ accessToken }) and nested ({ claudeAiOauth: { accessToken } })
-      const oauth = creds.claudeAiOauth || creds;
-      if (oauth.accessToken) {
-        if (oauth.expiresAt && Date.now() >= oauth.expiresAt) return null;
-        return oauth.accessToken;
-      }
-    }
-  } catch {}
-  return null;
-}
-
 /** Read the custom system prompt addendum */
 function readSystemPromptAddendum(): string {
   try {
@@ -94,7 +77,7 @@ export async function startFluxyAgentQuery(
   onMessage: (type: string, data: any) => void,
   attachments?: AgentAttachment[],
 ): Promise<void> {
-  const oauthToken = readOAuthToken();
+  const oauthToken = await getClaudeAccessToken();
   if (!oauthToken) {
     onMessage('bot:error', { conversationId, error: 'Claude OAuth token not found. Please authenticate via the dashboard.' });
     return;

package/worker/claude-auth.ts

@@ -117,6 +117,29 @@ export function readClaudeAccessToken(): string | null {
   return oauth.accessToken;
 }
 
+/** Read a valid access token, refreshing if expired. Returns null if unavailable. */
+export async function getClaudeAccessToken(): Promise<string | null> {
+  const oauth = readOAuthBlock();
+  if (!oauth?.accessToken) return null;
+
+  // Token still valid
+  if (oauth.expiresAt && Date.now() < oauth.expiresAt) {
+    return oauth.accessToken;
+  }
+
+  // Try refresh
+  if (oauth.refreshToken) {
+    const refreshed = await refreshClaudeToken(oauth.refreshToken);
+    if (refreshed) {
+      // Re-read after refresh
+      const fresh = readOAuthBlock();
+      return fresh?.accessToken || null;
+    }
+  }
+
+  return null;
+}
+
 /* ── Helpers ── */
 
 /**