feat: v0.2.0 — CLI command + proper icon + installer progress bar

1. jarvis-orb CLI: one command starts Brain + opens Orb
   - jarvis-orb (full), --brain (brain only), --orb (orb only), --demo
   - Registered in PATH on both macOS and Windows

2. App icon: cyan/purple gradient orb with glow (replaces placeholder)
   - PNG 32/128/256 + ICO for Windows

3. Installer UI: progress bar [████░░░░] 2/4 at each step
   - Both macOS (bash) and Windows (PowerShell)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: thestack_ai

brain/jarvis_brain/cli.py

@@ -0,0 +1,124 @@
+"""Jarvis Orb — CLI entry point.
+
+Usage:
+  jarvis-orb          Start Brain + open Orb
+  jarvis-orb --brain  Start Brain only (WebSocket server)
+  jarvis-orb --orb    Open Orb only
+  jarvis-orb --demo   Start demo mode (fake events)
+"""
+
+import argparse
+import asyncio
+import os
+import platform
+import subprocess
+import sys
+import time
+
+
+def find_orb_app():
+    """Find the Orb app on disk."""
+    system = platform.system()
+    if system == "Darwin":
+        paths = [
+            "/Applications/Jarvis Orb.app",
+            os.path.expanduser("~/Applications/Jarvis Orb.app"),
+        ]
+        for p in paths:
+            if os.path.exists(p):
+                return p
+    elif system == "Windows":
+        # Common install locations
+        appdata = os.environ.get("LOCALAPPDATA", "")
+        paths = [
+            os.path.join(appdata, "Jarvis Orb", "Jarvis Orb.exe"),
+            os.path.join(os.environ.get("PROGRAMFILES", ""), "Jarvis Orb", "Jarvis Orb.exe"),
+        ]
+        for p in paths:
+            if os.path.exists(p):
+                return p
+    return None
+
+
+def start_brain(demo=False):
+    """Start Brain Lite WebSocket server in background."""
+    brain_dir = os.path.expanduser("~/.jarvis-orb")
+    lib_dir = os.path.join(brain_dir, "lib")
+    sep = ";" if platform.system() == "Windows" else ":"
+    pythonpath = f"{lib_dir}{sep}{brain_dir}"
+
+    module = "jarvis_brain.demo_server" if demo else "jarvis_brain.demo_server"
+    python = "python" if platform.system() == "Windows" else "python3"
+
+    env = os.environ.copy()
+    env["PYTHONPATH"] = pythonpath
+
+    proc = subprocess.Popen(
+        [python, "-m", module],
+        cwd=brain_dir,
+        env=env,
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+    )
+    return proc
+
+
+def open_orb():
+    """Open the Orb desktop app."""
+    app_path = find_orb_app()
+    if not app_path:
+        print("  Orb app not found. Install it first.")
+        return None
+
+    system = platform.system()
+    if system == "Darwin":
+        subprocess.Popen(["open", app_path])
+    elif system == "Windows":
+        subprocess.Popen([app_path])
+    return app_path
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Jarvis Orb — AI Brain + Realtime Visualizer"
+    )
+    parser.add_argument("--brain", action="store_true", help="Start Brain only")
+    parser.add_argument("--orb", action="store_true", help="Open Orb only")
+    parser.add_argument("--demo", action="store_true", help="Demo mode (fake events)")
+    args = parser.parse_args()
+
+    print()
+    print("  \033[36m\033[1mJARVIS ORB\033[0m")
+    print()
+
+    if args.brain or (not args.orb):
+        mode = "demo" if args.demo else "brain"
+        print(f"  \033[32m✓\033[0m Brain starting...")
+        brain_proc = start_brain(demo=args.demo)
+        time.sleep(1)
+        if brain_proc.poll() is None:
+            print(f"  \033[32m✓\033[0m Brain running (PID {brain_proc.pid})")
+        else:
+            print(f"  \033[31m✗\033[0m Brain failed to start")
+            return
+
+    if args.orb or (not args.brain):
+        print(f"  \033[32m✓\033[0m Opening Orb...")
+        path = open_orb()
+        if path:
+            print(f"  \033[32m✓\033[0m Orb launched")
+
+    print()
+    print("  \033[36mYour AI is thinking.\033[0m")
+    print("  \033[2mPress Ctrl+C to stop.\033[0m")
+    print()
+
+    try:
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        print("\n  Stopped.")
+
+
+if __name__ == "__main__":
+    main()

install.ps1

@@ -8,11 +8,22 @@ $BrainDir = "$env:USERPROFILE\.jarvis-orb"
 $BrainBin = "$BrainDir\bin"
 
 # ── Colors ──
+$Script:StepNum = 0
+$Script:TotalSteps = 4
+
 function Write-Cyan($msg) { Write-Host "  $msg" -ForegroundColor Cyan }
 function Write-Ok($msg) { Write-Host "    ✓ $msg" -ForegroundColor Green }
 function Write-Warn($msg) { Write-Host "    ! $msg" -ForegroundColor Yellow }
 function Write-Info($msg) { Write-Host "    $msg" -ForegroundColor DarkGray }
-function Write-Step($msg) { Write-Host "`n  → $msg" -ForegroundColor White }
+function Write-Step($msg) {
+    $Script:StepNum++
+    $filled = [int]($Script:StepNum * 20 / $Script:TotalSteps)
+    $empty = 20 - $filled
+    $bar = ("█" * $filled) + ("░" * $empty)
+    Write-Host ""
+    Write-Host "  [$bar] $($Script:StepNum)/$($Script:TotalSteps)" -ForegroundColor DarkGray
+    Write-Host "  → $msg" -ForegroundColor White
+}
 
 # ── Header ──
 Write-Host ""
@@ -69,13 +80,27 @@ try {
 }
 
 # Create launcher
-$launcherContent = @"
+$brainLauncher = @"
 @echo off
 set PYTHONPATH=$BrainDir\lib;$BrainDir
 python -m jarvis_brain.mcp_server %*
 "@
-Set-Content -Path "$BrainBin\jarvis-brain.bat" -Value $launcherContent
-Write-Ok "Brain launcher → $BrainBin\jarvis-brain.bat"
+Set-Content -Path "$BrainBin\jarvis-brain.bat" -Value $brainLauncher
+
+$orbLauncher = @"
+@echo off
+set PYTHONPATH=$BrainDir\lib;$BrainDir
+python -m jarvis_brain.cli %*
+"@
+Set-Content -Path "$BrainBin\jarvis-orb.bat" -Value $orbLauncher
+Write-Ok "Commands → jarvis-orb, jarvis-brain"
+
+# Add to PATH
+$currentPath = [Environment]::GetEnvironmentVariable("Path", "User")
+if ($currentPath -notlike "*$BrainBin*") {
+    [Environment]::SetEnvironmentVariable("Path", "$BrainBin;$currentPath", "User")
+    Write-Ok "Added to PATH (restart terminal to use)"
+}
 
 # ── Step 3: Claude Code MCP ──
 Write-Step "Configuring Claude Code"

install.sh

@@ -39,8 +39,19 @@ case "$OS" in
   *) echo -e "  ${RED}Unsupported: $OS${R}"; exit 1 ;;
 esac
 
+STEP_NUM=0
+TOTAL_STEPS=4
+
 step() {
+  STEP_NUM=$((STEP_NUM + 1))
   echo ""
+  # Progress bar
+  local filled=$((STEP_NUM * 20 / TOTAL_STEPS))
+  local empty=$((20 - filled))
+  local bar=""
+  for i in $(seq 1 $filled); do bar="${bar}█"; done
+  for i in $(seq 1 $empty); do bar="${bar}░"; done
+  echo -e "  ${DIM}[${bar}] ${STEP_NUM}/${TOTAL_STEPS}${R}"
   echo -e "  ${CYAN}→${R} ${B}$1${R}"
 }
 
@@ -60,6 +71,19 @@ fail() {
   echo -e "    ${RED}✗${R} $1"
 }
 
+spinner() {
+  local pid=$1
+  local msg=$2
+  local chars="⠋⠙⠹⠸⠼⠴⠦⠧⠇⠏"
+  local i=0
+  while kill -0 $pid 2>/dev/null; do
+    printf "\r    ${CYAN}${chars:$i:1}${R} ${DIM}${msg}${R}" >&2
+    i=$(( (i + 1) % ${#chars} ))
+    sleep 0.1
+  done
+  printf "\r                                          \r" >&2
+}
+
 # ── Step 1: Environment ──
 step "Checking environment"
 info "$OS $ARCH"
@@ -107,7 +131,28 @@ export PYTHONPATH="$HOME/.jarvis-orb/lib:$HOME/.jarvis-orb"
 exec python3 -m jarvis_brain.mcp_server "$@"
 EOF
 chmod +x "$BRAIN_BIN/jarvis-brain"
-ok "Brain launcher → ~/.jarvis-orb/bin/jarvis-brain"
+
+cat > "$BRAIN_BIN/jarvis-orb" << 'EOF'
+#!/bin/bash
+export PYTHONPATH="$HOME/.jarvis-orb/lib:$HOME/.jarvis-orb"
+exec python3 -m jarvis_brain.cli "$@"
+EOF
+chmod +x "$BRAIN_BIN/jarvis-orb"
+ok "Commands → jarvis-orb, jarvis-brain"
+
+# Add to PATH if not already
+if [[ ":$PATH:" != *":$BRAIN_BIN:"* ]]; then
+  SHELL_RC=""
+  if [ -f "$HOME/.zshrc" ]; then SHELL_RC="$HOME/.zshrc"
+  elif [ -f "$HOME/.bashrc" ]; then SHELL_RC="$HOME/.bashrc"
+  fi
+  if [ -n "$SHELL_RC" ]; then
+    if ! grep -q "jarvis-orb/bin" "$SHELL_RC" 2>/dev/null; then
+      echo 'export PATH="$HOME/.jarvis-orb/bin:$PATH"' >> "$SHELL_RC"
+      ok "Added to PATH in $(basename $SHELL_RC)"
+    fi
+  fi
+fi
 
 # ── Step 3: Claude Code MCP ──
 step "Configuring Claude Code"