get-claudia 1.10.0 → 1.10.2

package/bin/index.js

@@ -309,8 +309,8 @@ ${colors.dim}She'll introduce herself and set things up for you.${colors.reset}
 
     if (gatewayInstalled) {
       console.log(`${colors.bold}Gateway:${colors.reset}
-  ${colors.dim}Configure API keys and allowlist, then:${colors.reset}
-  ${colors.cyan}claudia-gateway start${colors.reset}
+  ${colors.dim}If claudia-gateway isn't found, open a new terminal or run:${colors.reset}
+  ${colors.cyan}~/.claudia/bin/claudia-gateway start${colors.reset}
   ${colors.dim}See ~/.claudia/gateway.json for settings.${colors.reset}
 `);
     }

package/gateway/scripts/install.ps1

@@ -230,11 +230,20 @@ node "%USERPROFILE%\.claudia\gateway\src\index.js" %*
 Set-Content -Path $wrapperPath -Value $wrapperContent
 Write-Host "  ${GREEN}✓${NC} CLI installed at $wrapperPath"
 
-# PATH hint
+# Auto-add to user PATH if not already there
+$PATH_ADDED = $false
 $currentPath = [System.Environment]::GetEnvironmentVariable("PATH", "User")
 if ($currentPath -notlike "*$BIN_DIR*") {
-    Write-Host "  ${YELLOW}!${NC} Add to your PATH if not already present:"
-    Write-Host "    ${DIM}[Environment]::SetEnvironmentVariable('PATH', `$env:PATH + ';$BIN_DIR', 'User')${NC}"
+    try {
+        $newPath = if ($currentPath) { "$currentPath;$BIN_DIR" } else { $BIN_DIR }
+        [System.Environment]::SetEnvironmentVariable("PATH", $newPath, "User")
+        $env:PATH = "$BIN_DIR;$env:PATH"
+        Write-Host "  ${GREEN}✓${NC} PATH updated (user environment)"
+        $PATH_ADDED = $true
+    } catch {
+        Write-Host "  ${YELLOW}!${NC} Add to your PATH manually:"
+        Write-Host "    ${DIM}[Environment]::SetEnvironmentVariable('PATH', `$env:PATH + ';$BIN_DIR', 'User')${NC}"
+    }
 }
 
 # Create scheduled task (disabled by default)
@@ -298,30 +307,218 @@ Write-Host "  ║                                                           ║"
 Write-Host "  ╚═══════════════════════════════════════════════════════════╝"
 Write-Host "${NC}"
 
-Write-Host "${BOLD}Security checklist (do these before starting):${NC}"
+# Offer interactive setup guide
+Write-Host "  The gateway needs a chat platform (Telegram or Slack) to"
+Write-Host "  receive your messages. ${BOLD}Want a step-by-step setup guide?${NC}"
 Write-Host ""
-if (-not $LOCAL_MODEL) {
-    Write-Host "  ${YELLOW}□${NC} Set ANTHROPIC_API_KEY as an environment variable"
-} else {
-    Write-Host "  ${GREEN}✓${NC} Local model $LOCAL_MODEL configured (no API key needed)"
-    Write-Host "  ${DIM}    Set ANTHROPIC_API_KEY to use Claude instead${NC}"
+$showGuide = Read-Host "  Show setup guide? [y/n, default=y]"
+if (-not $showGuide) { $showGuide = "y" }
+
+if ($showGuide -match "^[Yy]") {
+    Write-Host ""
+    Write-Host "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    Write-Host ""
+    Write-Host "  ${BOLD}Which platform?${NC}"
+    Write-Host "    ${CYAN}1)${NC} Telegram   ${DIM}(easiest, 2 minutes)${NC}"
+    Write-Host "    ${CYAN}2)${NC} Slack      ${DIM}(requires workspace admin)${NC}"
+    Write-Host "    ${CYAN}3)${NC} Skip       ${DIM}(I'll set it up later)${NC}"
+    Write-Host ""
+    $platformChoice = Read-Host "  Choice [1-3, default=1]"
+    if (-not $platformChoice) { $platformChoice = "1" }
+
+    if ($platformChoice -eq "1") {
+        Write-Host ""
+        Write-Host "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        Write-Host ""
+        Write-Host "  ${BOLD}Telegram Setup${NC}"
+        Write-Host ""
+        Write-Host "  ${CYAN}Step 1:${NC} Open Telegram and search for ${BOLD}@BotFather${NC}"
+        Write-Host "          (or open: ${DIM}https://t.me/BotFather${NC})"
+        Write-Host ""
+        Write-Host "  ${CYAN}Step 2:${NC} Send ${BOLD}/newbot${NC} to BotFather"
+        Write-Host "          He'll ask for a display name (anything, e.g. $([char]34)My Claudia$([char]34))"
+        Write-Host "          Then a username (must end in 'bot', e.g. $([char]34)my_claudia_bot$([char]34))"
+        Write-Host ""
+        Write-Host "  ${CYAN}Step 3:${NC} BotFather will reply with a token like:"
+        Write-Host "          ${DIM}123456789:ABCdefGHIjklMNOpqrsTUVwxyz${NC}"
+        Write-Host "          Copy that token."
+        Write-Host ""
+        $botToken = Read-Host "  Paste your bot token here (or press Enter to skip)"
+
+        if ($botToken) {
+            Write-Host ""
+            Write-Host "  ${CYAN}Step 4:${NC} Now get your Telegram user ID."
+            Write-Host "          Search for ${BOLD}@userinfobot${NC} in Telegram"
+            Write-Host "          (or open: ${DIM}https://t.me/userinfobot${NC})"
+            Write-Host "          Send it any message. It replies with your ID (a number)."
+            Write-Host ""
+            $userId = Read-Host "  Paste your user ID here (or press Enter to skip)"
+
+            if ($userId) {
+                # Write the config
+                $cfgData = @{}
+                if (Test-Path $CONFIG_FILE) {
+                    try { $cfgData = Get-Content $CONFIG_FILE -Raw | ConvertFrom-Json } catch {}
+                }
+                if (-not $cfgData.channels) { $cfgData | Add-Member -NotePropertyName "channels" -NotePropertyValue @{} -Force }
+                $cfgData.channels | Add-Member -NotePropertyName "telegram" -NotePropertyValue @{
+                    enabled = $true
+                    allowedUsers = @($userId)
+                } -Force
+                $cfgData | ConvertTo-Json -Depth 10 | Set-Content $CONFIG_FILE
+
+                Write-Host ""
+                Write-Host "  ${GREEN}✓${NC} Telegram configured in gateway.json"
+                Write-Host "  ${GREEN}✓${NC} User $userId added to allowlist"
+                Write-Host ""
+
+                $env:TELEGRAM_BOT_TOKEN = $botToken
+
+                # Auto-persist token to PowerShell profile
+                $profilePath = $PROFILE.CurrentUserAllHosts
+                $profileDir = Split-Path $profilePath -Parent
+                if (-not (Test-Path $profileDir)) { New-Item -ItemType Directory -Force -Path $profileDir | Out-Null }
+                if (-not (Test-Path $profilePath)) { New-Item -ItemType File -Force -Path $profilePath | Out-Null }
+
+                $profileContent = Get-Content $profilePath -Raw -ErrorAction SilentlyContinue
+                $tokenLine = "`$env:TELEGRAM_BOT_TOKEN = '$botToken'"
+
+                if ($profileContent -match 'TELEGRAM_BOT_TOKEN') {
+                    # Replace existing line
+                    $profileContent = $profileContent -replace '(?m)^\$env:TELEGRAM_BOT_TOKEN\s*=.*$', $tokenLine
+                    Set-Content -Path $profilePath -Value $profileContent
+                    Write-Host "  ${GREEN}✓${NC} Bot token updated in PowerShell profile"
+                } else {
+                    Add-Content -Path $profilePath -Value "`n# Claudia Gateway - Telegram`n$tokenLine"
+                    Write-Host "  ${GREEN}✓${NC} Bot token saved to PowerShell profile"
+                }
+            } else {
+                Write-Host ""
+                Write-Host "  ${YELLOW}!${NC} Skipped user ID. You'll need to add it manually:"
+                Write-Host "    ${DIM}Edit $CONFIG_FILE and set:"
+                Write-Host "    channels.telegram.allowedUsers = [$([char]34)YOUR_USER_ID$([char]34)]${NC}"
+            }
+        } else {
+            Write-Host ""
+            Write-Host "  ${DIM}No worries. When you have your token, run:${NC}"
+            Write-Host "    ${CYAN}`$env:TELEGRAM_BOT_TOKEN = 'your-token-here'${NC}"
+            Write-Host "    ${CYAN}claudia-gateway start${NC}"
+        }
+
+    } elseif ($platformChoice -eq "2") {
+        Write-Host ""
+        Write-Host "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        Write-Host ""
+        Write-Host "  ${BOLD}Slack Setup${NC}"
+        Write-Host ""
+        Write-Host "  ${CYAN}Step 1:${NC} Go to ${BOLD}https://api.slack.com/apps${NC}"
+        Write-Host "          Click ${BOLD}Create New App${NC} > ${BOLD}From scratch${NC}"
+        Write-Host "          Pick a name and workspace."
+        Write-Host ""
+        Write-Host "  ${CYAN}Step 2:${NC} Enable ${BOLD}Socket Mode${NC} (in Settings sidebar)"
+        Write-Host "          This generates an app-level token (starts with ${DIM}xapp-${NC})"
+        Write-Host "          Name it anything (e.g. $([char]34)claudia-socket$([char]34)). Copy it."
+        Write-Host ""
+        Write-Host "  ${CYAN}Step 3:${NC} Go to ${BOLD}OAuth & Permissions${NC}. Add these bot token scopes:"
+        Write-Host "          ${DIM}app_mentions:read, chat:write, im:history, im:read, im:write${NC}"
+        Write-Host ""
+        Write-Host "  ${CYAN}Step 4:${NC} Go to ${BOLD}Event Subscriptions${NC}. Enable events."
+        Write-Host "          Subscribe to: ${DIM}message.im${NC} and ${DIM}app_mention${NC}"
+        Write-Host ""
+        Write-Host "  ${CYAN}Step 5:${NC} Click ${BOLD}Install to Workspace${NC} (in sidebar or OAuth page)"
+        Write-Host "          This generates a bot token (starts with ${DIM}xoxb-${NC}). Copy it."
+        Write-Host ""
+        Write-Host "  ${CYAN}Step 6:${NC} Get your Slack user ID:"
+        Write-Host "          Click your profile picture > ${BOLD}Profile${NC} > ${BOLD}...${NC} (more) > ${BOLD}Copy member ID${NC}"
+        Write-Host ""
+        $slackBot = Read-Host "  Paste your bot token (xoxb-...)"
+        $slackApp = Read-Host "  Paste your app token (xapp-...)"
+        $slackUser = Read-Host "  Paste your user ID (U...)"
+
+        if ($slackBot -and $slackApp -and $slackUser) {
+            $cfgData = @{}
+            if (Test-Path $CONFIG_FILE) {
+                try { $cfgData = Get-Content $CONFIG_FILE -Raw | ConvertFrom-Json } catch {}
+            }
+            if (-not $cfgData.channels) { $cfgData | Add-Member -NotePropertyName "channels" -NotePropertyValue @{} -Force }
+            $cfgData.channels | Add-Member -NotePropertyName "slack" -NotePropertyValue @{
+                enabled = $true
+                allowedUsers = @($slackUser)
+            } -Force
+            $cfgData | ConvertTo-Json -Depth 10 | Set-Content $CONFIG_FILE
+
+            # Export tokens for this session
+            $env:SLACK_BOT_TOKEN = $slackBot
+            $env:SLACK_APP_TOKEN = $slackApp
+
+            Write-Host ""
+            Write-Host "  ${GREEN}✓${NC} Slack configured in gateway.json"
+            Write-Host "  ${GREEN}✓${NC} User $slackUser added to allowlist"
+
+            # Auto-persist tokens to PowerShell profile
+            $profilePath = $PROFILE.CurrentUserAllHosts
+            $profileDir = Split-Path $profilePath -Parent
+            if (-not (Test-Path $profileDir)) { New-Item -ItemType Directory -Force -Path $profileDir | Out-Null }
+            if (-not (Test-Path $profilePath)) { New-Item -ItemType File -Force -Path $profilePath | Out-Null }
+
+            $profileContent = Get-Content $profilePath -Raw -ErrorAction SilentlyContinue
+            $sbotLine = "`$env:SLACK_BOT_TOKEN = '$slackBot'"
+            $sappLine = "`$env:SLACK_APP_TOKEN = '$slackApp'"
+
+            if ($profileContent -match 'SLACK_BOT_TOKEN') {
+                $profileContent = $profileContent -replace '(?m)^\$env:SLACK_BOT_TOKEN\s*=.*$', $sbotLine
+                $profileContent = $profileContent -replace '(?m)^\$env:SLACK_APP_TOKEN\s*=.*$', $sappLine
+                Set-Content -Path $profilePath -Value $profileContent
+                Write-Host "  ${GREEN}✓${NC} Slack tokens updated in PowerShell profile"
+            } else {
+                Add-Content -Path $profilePath -Value "`n# Claudia Gateway - Slack`n$sbotLine`n$sappLine"
+                Write-Host "  ${GREEN}✓${NC} Slack tokens saved to PowerShell profile"
+            }
+        } else {
+            Write-Host ""
+            Write-Host "  ${DIM}Missing some values. When you have all tokens, run:${NC}"
+            Write-Host "    ${CYAN}`$env:SLACK_BOT_TOKEN = 'xoxb-...'${NC}"
+            Write-Host "    ${CYAN}`$env:SLACK_APP_TOKEN = 'xapp-...'${NC}"
+            Write-Host "    ${CYAN}claudia-gateway start${NC}"
+        }
+    }
+
+    Write-Host ""
+    Write-Host "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    Write-Host ""
+
+    # Show the "How to Use" box if a platform was configured
+    if ($platformChoice -eq "1" -or $platformChoice -eq "2") {
+        Write-Host "  ${BOLD}${CYAN}How It Works: Two Terminals${NC}"
+        Write-Host ""
+        Write-Host "  The gateway is a separate program that connects your"
+        Write-Host "  chat app (Telegram/Slack) to Claudia. It needs to run"
+        Write-Host "  in its own terminal window while you use Claude in another."
+        Write-Host ""
+        Write-Host "  ${BOLD}Terminal 1 (gateway):${NC}"
+        Write-Host "    ${CYAN}claudia-gateway start${NC}"
+        Write-Host "    ${DIM}Keep this running. It connects to your bot.${NC}"
+        Write-Host ""
+        Write-Host "  ${BOLD}Terminal 2 (Claude):${NC}"
+        Write-Host "    ${CYAN}cd your-project && claude${NC}"
+        Write-Host "    ${DIM}Your normal Claude Code sessions.${NC}"
+        Write-Host ""
+        Write-Host "  ${YELLOW}!${NC} The gateway must be running before you message the bot."
+        Write-Host "    If the gateway is stopped, your bot won't respond."
+        Write-Host ""
+        Write-Host "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        Write-Host ""
+    }
 }
-Write-Host "  ${YELLOW}□${NC} Set TELEGRAM_BOT_TOKEN (or SLACK_BOT_TOKEN + SLACK_APP_TOKEN)"
-Write-Host "  ${YELLOW}□${NC} Add your user ID(s) to allowedUsers in gateway.json"
-Write-Host "  ${YELLOW}□${NC} Never commit API keys to git or store them in gateway.json"
-Write-Host ""
-Write-Host "${BOLD}Quick start:${NC}"
+
+Write-Host "${BOLD}Security reminders:${NC}"
 Write-Host ""
 if (-not $LOCAL_MODEL) {
-    Write-Host "  ${CYAN}1.${NC} `$env:ANTHROPIC_API_KEY = 'sk-ant-...'"
-    Write-Host "  ${CYAN}2.${NC} `$env:TELEGRAM_BOT_TOKEN = '123456:ABC...'"
-    Write-Host "  ${CYAN}3.${NC} Edit $CONFIG_FILE (enable channel, set allowedUsers)"
-    Write-Host "  ${CYAN}4.${NC} claudia-gateway start"
+    Write-Host "  ${YELLOW}□${NC} Set ANTHROPIC_API_KEY as an environment variable"
 } else {
-    Write-Host "  ${CYAN}1.${NC} `$env:TELEGRAM_BOT_TOKEN = '123456:ABC...'"
-    Write-Host "  ${CYAN}2.${NC} Edit $CONFIG_FILE (enable channel, set allowedUsers)"
-    Write-Host "  ${CYAN}3.${NC} claudia-gateway start"
+    Write-Host "  ${GREEN}✓${NC} Local model $LOCAL_MODEL (no API key needed)"
 }
+Write-Host "  ${YELLOW}□${NC} Never commit API keys to git or store them in config files"
 Write-Host ""
 Write-Host "${BOLD}Installed:${NC}"
 Write-Host ""
@@ -329,6 +526,10 @@ Write-Host "  ${CYAN}◆${NC} Gateway source     ${DIM}$GATEWAY_DIR${NC}"
 Write-Host "  ${CYAN}◆${NC} Config             ${DIM}$CONFIG_FILE${NC}"
 Write-Host "  ${CYAN}◆${NC} CLI                ${DIM}$wrapperPath${NC}"
 Write-Host "  ${CYAN}◆${NC} Logs               ${DIM}$CLAUDIA_DIR\gateway.log${NC}"
+if ($PATH_ADDED) {
+    Write-Host ""
+    Write-Host "  ${YELLOW}!${NC} PATH was updated. Restart your terminal for it to take effect."
+}
 Write-Host ""
 Write-Host "${BOLD}CLI commands:${NC}"
 Write-Host ""

package/gateway/scripts/install.sh

@@ -239,10 +239,36 @@ WRAPPER
 chmod +x "$BIN_DIR/claudia-gateway"
 echo -e "  ${GREEN}✓${NC} CLI installed at ~/.claudia/bin/claudia-gateway"
 
-# Add to PATH hint if not already there
+# Auto-add to PATH via shell rc file if not already there
+PATH_ADDED=0
 if [[ ":$PATH:" != *":$BIN_DIR:"* ]]; then
-    echo -e "  ${YELLOW}!${NC} Add to your PATH if not already present:"
-    echo -e "    ${DIM}export PATH=\"\$HOME/.claudia/bin:\$PATH\"${NC}"
+    PATH_LINE='export PATH="$HOME/.claudia/bin:$PATH"'
+
+    # Detect shell rc file
+    SHELL_RC=""
+    if [ -n "$ZSH_VERSION" ] || [ "$(basename "$SHELL")" = "zsh" ]; then
+        SHELL_RC="$HOME/.zshrc"
+    elif [ -n "$BASH_VERSION" ] || [ "$(basename "$SHELL")" = "bash" ]; then
+        SHELL_RC="$HOME/.bashrc"
+    fi
+
+    if [ -n "$SHELL_RC" ]; then
+        # Check if already in rc file (even if not in current PATH)
+        if [ -f "$SHELL_RC" ] && grep -q '\.claudia/bin' "$SHELL_RC" 2>/dev/null; then
+            echo -e "  ${GREEN}✓${NC} PATH already configured in $(basename "$SHELL_RC")"
+        else
+            echo "" >> "$SHELL_RC"
+            echo "# Claudia CLI" >> "$SHELL_RC"
+            echo "$PATH_LINE" >> "$SHELL_RC"
+            echo -e "  ${GREEN}✓${NC} PATH added to ~/${SHELL_RC##*/}"
+            PATH_ADDED=1
+        fi
+        # Also add to current session
+        export PATH="$HOME/.claudia/bin:$PATH"
+    else
+        echo -e "  ${YELLOW}!${NC} Add to your PATH manually:"
+        echo -e "    ${DIM}${PATH_LINE}${NC}"
+    fi
 fi
 
 # Create LaunchAgent / systemd unit (disabled by default)
@@ -338,30 +364,221 @@ cat << 'EOF'
 EOF
 echo -e "${NC}"
 
-echo -e "${BOLD}Security checklist (do these before starting):${NC}"
+# Offer interactive setup guide
+echo -e "  The gateway needs a chat platform (Telegram or Slack) to"
+echo -e "  receive your messages. ${BOLD}Want a step-by-step setup guide?${NC}"
 echo
-if [ -z "$LOCAL_MODEL" ]; then
-    echo -e "  ${YELLOW}□${NC} Set ANTHROPIC_API_KEY as an environment variable"
-else
-    echo -e "  ${GREEN}✓${NC} Local model ${LOCAL_MODEL} configured (no API key needed)"
-    echo -e "  ${DIM}    Set ANTHROPIC_API_KEY to use Claude instead${NC}"
+read -p "  Show setup guide? [y/n, default=y]: " SHOW_GUIDE
+SHOW_GUIDE="${SHOW_GUIDE:-y}"
+
+if [[ "$SHOW_GUIDE" =~ ^[Yy] ]]; then
+    echo
+    echo -e "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo
+    echo -e "  ${BOLD}Which platform?${NC}"
+    echo -e "    ${CYAN}1)${NC} Telegram   ${DIM}(easiest, 2 minutes)${NC}"
+    echo -e "    ${CYAN}2)${NC} Slack      ${DIM}(requires workspace admin)${NC}"
+    echo -e "    ${CYAN}3)${NC} Skip       ${DIM}(I'll set it up later)${NC}"
+    echo
+    read -p "  Choice [1-3, default=1]: " PLATFORM_CHOICE
+    PLATFORM_CHOICE="${PLATFORM_CHOICE:-1}"
+
+    if [ "$PLATFORM_CHOICE" = "1" ]; then
+        echo
+        echo -e "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo
+        echo -e "  ${BOLD}Telegram Setup${NC}"
+        echo
+        echo -e "  ${CYAN}Step 1:${NC} Open Telegram and search for ${BOLD}@BotFather${NC}"
+        echo -e "          (or tap: ${DIM}https://t.me/BotFather${NC})"
+        echo
+        echo -e "  ${CYAN}Step 2:${NC} Send ${BOLD}/newbot${NC} to BotFather"
+        echo -e "          He'll ask for a display name (anything, e.g. \"My Claudia\")"
+        echo -e "          Then a username (must end in 'bot', e.g. \"my_claudia_bot\")"
+        echo
+        echo -e "  ${CYAN}Step 3:${NC} BotFather will reply with a token like:"
+        echo -e "          ${DIM}123456789:ABCdefGHIjklMNOpqrsTUVwxyz${NC}"
+        echo -e "          Copy that token."
+        echo
+        read -p "  Paste your bot token here (or press Enter to skip): " BOT_TOKEN
+
+        if [ -n "$BOT_TOKEN" ]; then
+            echo
+            echo -e "  ${CYAN}Step 4:${NC} Now get your Telegram user ID."
+            echo -e "          Search for ${BOLD}@userinfobot${NC} in Telegram"
+            echo -e "          (or tap: ${DIM}https://t.me/userinfobot${NC})"
+            echo -e "          Send it any message. It replies with your ID (a number)."
+            echo
+            read -p "  Paste your user ID here (or press Enter to skip): " USER_ID
+
+            if [ -n "$USER_ID" ]; then
+                # Write the config
+                node -e "
+                  const fs = require('fs');
+                  const path = '$CONFIG_FILE';
+                  let c = {};
+                  try { c = JSON.parse(fs.readFileSync(path, 'utf8')); } catch {}
+                  if (!c.channels) c.channels = {};
+                  if (!c.channels.telegram) c.channels.telegram = {};
+                  c.channels.telegram.enabled = true;
+                  c.channels.telegram.allowedUsers = ['$USER_ID'];
+                  fs.writeFileSync(path, JSON.stringify(c, null, 2));
+                " 2>/dev/null
+
+                echo
+                echo -e "  ${GREEN}✓${NC} Telegram configured in gateway.json"
+                echo -e "  ${GREEN}✓${NC} User ${USER_ID} added to allowlist"
+                echo
+
+                # Export the token for this session
+                export TELEGRAM_BOT_TOKEN="$BOT_TOKEN"
+
+                # Auto-persist token to shell rc file
+                TOKEN_LINE="export TELEGRAM_BOT_TOKEN=\"$BOT_TOKEN\""
+                if [ -n "$SHELL_RC" ]; then
+                    if [ -f "$SHELL_RC" ] && grep -q 'TELEGRAM_BOT_TOKEN' "$SHELL_RC" 2>/dev/null; then
+                        # Replace existing line
+                        sed -i.bak "s|^export TELEGRAM_BOT_TOKEN=.*|$TOKEN_LINE|" "$SHELL_RC" && rm -f "${SHELL_RC}.bak"
+                        echo -e "  ${GREEN}✓${NC} Bot token updated in ~/${SHELL_RC##*/}"
+                    else
+                        echo "" >> "$SHELL_RC"
+                        echo "# Claudia Gateway - Telegram" >> "$SHELL_RC"
+                        echo "$TOKEN_LINE" >> "$SHELL_RC"
+                        echo -e "  ${GREEN}✓${NC} Bot token saved to ~/${SHELL_RC##*/}"
+                    fi
+                else
+                    echo -e "  ${YELLOW}!${NC} Add this to your shell profile to persist the token:"
+                    echo -e "    ${DIM}${TOKEN_LINE}${NC}"
+                fi
+            else
+                echo
+                echo -e "  ${YELLOW}!${NC} Skipped user ID. You'll need to add it manually:"
+                echo -e "    ${DIM}Edit ~/.claudia/gateway.json and set:"
+                echo -e "    channels.telegram.allowedUsers = [\"YOUR_USER_ID\"]${NC}"
+            fi
+        else
+            echo
+            echo -e "  ${DIM}No worries. When you have your token, run:${NC}"
+            echo -e "    ${CYAN}export TELEGRAM_BOT_TOKEN=\"your-token-here\"${NC}"
+            echo -e "    ${CYAN}claudia-gateway start${NC}"
+        fi
+
+    elif [ "$PLATFORM_CHOICE" = "2" ]; then
+        echo
+        echo -e "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo
+        echo -e "  ${BOLD}Slack Setup${NC}"
+        echo
+        echo -e "  ${CYAN}Step 1:${NC} Go to ${BOLD}https://api.slack.com/apps${NC}"
+        echo -e "          Click ${BOLD}Create New App${NC} > ${BOLD}From scratch${NC}"
+        echo -e "          Pick a name and workspace."
+        echo
+        echo -e "  ${CYAN}Step 2:${NC} Enable ${BOLD}Socket Mode${NC} (in Settings sidebar)"
+        echo -e "          This generates an app-level token (starts with ${DIM}xapp-${NC})"
+        echo -e "          Name it anything (e.g. \"claudia-socket\"). Copy it."
+        echo
+        echo -e "  ${CYAN}Step 3:${NC} Go to ${BOLD}OAuth & Permissions${NC}. Add these bot token scopes:"
+        echo -e "          ${DIM}app_mentions:read, chat:write, im:history, im:read, im:write${NC}"
+        echo
+        echo -e "  ${CYAN}Step 4:${NC} Go to ${BOLD}Event Subscriptions${NC}. Enable events."
+        echo -e "          Subscribe to: ${DIM}message.im${NC} and ${DIM}app_mention${NC}"
+        echo
+        echo -e "  ${CYAN}Step 5:${NC} Click ${BOLD}Install to Workspace${NC} (in sidebar or OAuth page)"
+        echo -e "          This generates a bot token (starts with ${DIM}xoxb-${NC}). Copy it."
+        echo
+        echo -e "  ${CYAN}Step 6:${NC} Get your Slack user ID:"
+        echo -e "          Click your profile picture > ${BOLD}Profile${NC} > ${BOLD}...${NC} (more) > ${BOLD}Copy member ID${NC}"
+        echo
+        read -p "  Paste your bot token (xoxb-...): " SLACK_BOT
+        read -p "  Paste your app token (xapp-...): " SLACK_APP
+        read -p "  Paste your user ID (U...): " SLACK_USER
+
+        if [ -n "$SLACK_BOT" ] && [ -n "$SLACK_APP" ] && [ -n "$SLACK_USER" ]; then
+            node -e "
+              const fs = require('fs');
+              const path = '$CONFIG_FILE';
+              let c = {};
+              try { c = JSON.parse(fs.readFileSync(path, 'utf8')); } catch {}
+              if (!c.channels) c.channels = {};
+              if (!c.channels.slack) c.channels.slack = {};
+              c.channels.slack.enabled = true;
+              c.channels.slack.allowedUsers = ['$SLACK_USER'];
+              fs.writeFileSync(path, JSON.stringify(c, null, 2));
+            " 2>/dev/null
+
+            # Export tokens for this session
+            export SLACK_BOT_TOKEN="$SLACK_BOT"
+            export SLACK_APP_TOKEN="$SLACK_APP"
+
+            echo
+            echo -e "  ${GREEN}✓${NC} Slack configured in gateway.json"
+            echo -e "  ${GREEN}✓${NC} User ${SLACK_USER} added to allowlist"
+
+            # Auto-persist tokens to shell rc file
+            SBOT_LINE="export SLACK_BOT_TOKEN=\"$SLACK_BOT\""
+            SAPP_LINE="export SLACK_APP_TOKEN=\"$SLACK_APP\""
+            if [ -n "$SHELL_RC" ]; then
+                if [ -f "$SHELL_RC" ] && grep -q 'SLACK_BOT_TOKEN' "$SHELL_RC" 2>/dev/null; then
+                    sed -i.bak "s|^export SLACK_BOT_TOKEN=.*|$SBOT_LINE|" "$SHELL_RC" && rm -f "${SHELL_RC}.bak"
+                    sed -i.bak "s|^export SLACK_APP_TOKEN=.*|$SAPP_LINE|" "$SHELL_RC" && rm -f "${SHELL_RC}.bak"
+                    echo -e "  ${GREEN}✓${NC} Slack tokens updated in ~/${SHELL_RC##*/}"
+                else
+                    echo "" >> "$SHELL_RC"
+                    echo "# Claudia Gateway - Slack" >> "$SHELL_RC"
+                    echo "$SBOT_LINE" >> "$SHELL_RC"
+                    echo "$SAPP_LINE" >> "$SHELL_RC"
+                    echo -e "  ${GREEN}✓${NC} Slack tokens saved to ~/${SHELL_RC##*/}"
+                fi
+            else
+                echo -e "  ${YELLOW}!${NC} Add these to your shell profile to persist the tokens:"
+                echo -e "    ${DIM}${SBOT_LINE}${NC}"
+                echo -e "    ${DIM}${SAPP_LINE}${NC}"
+            fi
+        else
+            echo
+            echo -e "  ${DIM}Missing some values. When you have all tokens, run:${NC}"
+            echo -e "    ${CYAN}export SLACK_BOT_TOKEN=\"xoxb-...\"${NC}"
+            echo -e "    ${CYAN}export SLACK_APP_TOKEN=\"xapp-...\"${NC}"
+            echo -e "    ${CYAN}claudia-gateway start${NC}"
+        fi
+    fi
+
+    echo
+    echo -e "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+    echo
+
+    # Show the "How to Use" box if a platform was configured
+    if [ "$PLATFORM_CHOICE" = "1" ] || [ "$PLATFORM_CHOICE" = "2" ]; then
+        echo -e "  ${BOLD}${CYAN}How It Works: Two Terminals${NC}"
+        echo
+        echo -e "  The gateway is a separate program that connects your"
+        echo -e "  chat app (Telegram/Slack) to Claudia. It needs to run"
+        echo -e "  in its own terminal window while you use Claude in another."
+        echo
+        echo -e "  ${BOLD}Terminal 1 (gateway):${NC}"
+        echo -e "    ${CYAN}claudia-gateway start${NC}"
+        echo -e "    ${DIM}Keep this running. It connects to your bot.${NC}"
+        echo
+        echo -e "  ${BOLD}Terminal 2 (Claude):${NC}"
+        echo -e "    ${CYAN}cd your-project && claude${NC}"
+        echo -e "    ${DIM}Your normal Claude Code sessions.${NC}"
+        echo
+        echo -e "  ${YELLOW}!${NC} The gateway must be running before you message the bot."
+        echo -e "    If the gateway is stopped, your bot won't respond."
+        echo
+        echo -e "${DIM}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
+        echo
+    fi
 fi
-echo -e "  ${YELLOW}□${NC} Set TELEGRAM_BOT_TOKEN (or SLACK_BOT_TOKEN + SLACK_APP_TOKEN)"
-echo -e "  ${YELLOW}□${NC} Add your user ID(s) to allowedUsers in gateway.json"
-echo -e "  ${YELLOW}□${NC} Never commit API keys to git or store them in gateway.json"
-echo
-echo -e "${BOLD}Quick start:${NC}"
+
+echo -e "${BOLD}Security reminders:${NC}"
 echo
 if [ -z "$LOCAL_MODEL" ]; then
-    echo -e "  ${CYAN}1.${NC} export ANTHROPIC_API_KEY=sk-ant-..."
-    echo -e "  ${CYAN}2.${NC} export TELEGRAM_BOT_TOKEN=123456:ABC..."
-    echo -e "  ${CYAN}3.${NC} Edit ~/.claudia/gateway.json (enable channel, set allowedUsers)"
-    echo -e "  ${CYAN}4.${NC} claudia-gateway start"
+    echo -e "  ${YELLOW}□${NC} Set ANTHROPIC_API_KEY as an environment variable"
 else
-    echo -e "  ${CYAN}1.${NC} export TELEGRAM_BOT_TOKEN=123456:ABC..."
-    echo -e "  ${CYAN}2.${NC} Edit ~/.claudia/gateway.json (enable channel, set allowedUsers)"
-    echo -e "  ${CYAN}3.${NC} claudia-gateway start"
+    echo -e "  ${GREEN}✓${NC} Local model ${LOCAL_MODEL} (no API key needed)"
 fi
+echo -e "  ${YELLOW}□${NC} Never commit API keys to git or store them in config files"
 echo
 echo -e "${BOLD}Installed:${NC}"
 echo
@@ -369,6 +586,10 @@ echo -e "  ${CYAN}◆${NC} Gateway source     ${DIM}$GATEWAY_DIR${NC}"
 echo -e "  ${CYAN}◆${NC} Config             ${DIM}~/.claudia/gateway.json${NC}"
 echo -e "  ${CYAN}◆${NC} CLI                ${DIM}~/.claudia/bin/claudia-gateway${NC}"
 echo -e "  ${CYAN}◆${NC} Logs               ${DIM}~/.claudia/gateway.log${NC}"
+if [ "$PATH_ADDED" = "1" ]; then
+    echo
+    echo -e "  ${YELLOW}!${NC} PATH was updated. Run ${BOLD}source ~/${SHELL_RC##*/}${NC} or open a new terminal."
+fi
 echo
 echo -e "${BOLD}CLI commands:${NC}"
 echo

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "get-claudia",
-  "version": "1.10.0",
+  "version": "1.10.2",
   "description": "An AI assistant who learns how you work.",
   "keywords": [
     "claudia",