agentic-loop 1.0.0

package/ralph/setup/feature-tour.sh

@@ -0,0 +1,155 @@
+#!/usr/bin/env bash
+# Path 2: Feature Tour (auto-demo) with skip options
+
+# Get script directory
+WIZARD_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+feature_tour() {
+  source "$WIZARD_DIR/ui.sh"
+  source "$WIZARD_DIR/quick-setup.sh"
+
+  clear
+  show_logo
+  echo -e "  ${BOLD}${EMOJI_MOVIE} Feature Tour${NC}\n"
+  echo -e "  ${DIM}Watch what agentic-loop can do for your codebase.${NC}"
+  echo -e "  ${DIM}Press 's' anytime to skip to setup.${NC}\n"
+  sleep 1
+
+  # Demo 1: vibe-check
+  demo_vibe_check
+  press_enter || { quick_setup; return; }
+
+  # Demo 2: Pre-commit hooks
+  demo_precommit
+  press_enter || { quick_setup; return; }
+
+  # Demo 3: Ralph autonomous loop
+  demo_ralph
+  press_enter || { quick_setup; return; }
+
+  # Demo 4: Claude Code skills
+  demo_skills
+  press_enter || { quick_setup; return; }
+
+  # Offer to install
+  echo ""
+  echo -e "  ${BOLD}That's the tour! Ready to set up your project?${NC}\n"
+
+  if confirm "Install agentic-loop?"; then
+    quick_setup
+  else
+    echo -e "\n  ${DIM}No problem! Run 'npx agentic-loop' anytime to set up.${NC}"
+  fi
+}
+
+demo_vibe_check() {
+  show_step 1 4 "vibe-check: Catch AI code issues"
+
+  echo -e "  ${DIM}$ vibe-check src/example.ts${NC}\n"
+  sleep 0.5
+
+  # Simulated output with typewriter effect
+  typewrite "  Scanning 1 file..." 0.03
+  sleep 0.3
+  echo ""
+
+  # Error
+  echo -e "  ${RED}${EMOJI_CROSS}${NC} ${BOLD}src/example.ts:15${NC}"
+  echo -e "    ${RED}[error]${NC} Hardcoded API URL detected"
+  echo -e "    ${DIM}const url = \"https://api.example.com/users\"${NC}"
+  sleep 0.2
+  echo ""
+
+  # Warnings
+  echo -e "  ${YELLOW}${EMOJI_WARN}${NC} ${BOLD}src/example.ts:23${NC}"
+  echo -e "    ${YELLOW}[warn]${NC} Function too long (85 lines, max 50)"
+  sleep 0.2
+  echo ""
+
+  echo -e "  ${YELLOW}${EMOJI_WARN}${NC} ${BOLD}src/example.ts:42${NC}"
+  echo -e "    ${YELLOW}[warn]${NC} Using 'any' type"
+  sleep 0.2
+  echo ""
+
+  echo -e "  Found ${RED}1 error${NC}, ${YELLOW}2 warnings${NC}"
+  echo ""
+  echo -e "  ${DIM}vibe-check catches common AI-generated code issues:${NC}"
+  echo -e "  ${DIM}- Hardcoded secrets and URLs${NC}"
+  echo -e "  ${DIM}- Overly complex functions${NC}"
+  echo -e "  ${DIM}- Missing error handling${NC}"
+  echo -e "  ${DIM}- TypeScript type issues${NC}"
+}
+
+demo_precommit() {
+  show_step 2 4 "Pre-commit hooks: Block bad commits"
+
+  echo -e "  ${DIM}$ git commit -m \"add feature\"${NC}\n"
+  sleep 0.5
+
+  echo -e "  ${GREEN}${EMOJI_CHECK}${NC} check-secrets............${GREEN}passed${NC}"
+  sleep 0.2
+  echo -e "  ${RED}${EMOJI_CROSS}${NC} check-hardcoded-urls.....${RED}FAILED${NC}"
+  sleep 0.3
+  echo ""
+  echo -e "  ${RED}Commit blocked!${NC} Fix the issue first."
+  echo ""
+  echo -e "  ${DIM}Pre-commit hooks automatically run before each commit:${NC}"
+  echo -e "  ${DIM}- Scans for hardcoded secrets (API keys, passwords)${NC}"
+  echo -e "  ${DIM}- Detects hardcoded URLs that should be config${NC}"
+  echo -e "  ${DIM}- Runs vibe-check quality scan${NC}"
+  echo ""
+  echo -e "  ${DIM}Bad code never makes it into your repo.${NC}"
+}
+
+demo_ralph() {
+  show_step 3 4 "Ralph: Autonomous development loop"
+
+  echo -e "  ${DIM}$ ralph prd \"Add user authentication\"${NC}\n"
+  sleep 0.5
+
+  echo -e "  ${CYAN}Claude:${NC} I have a few questions about this feature:"
+  sleep 0.2
+  echo -e "    1. What auth method? (OAuth, JWT, session-based)"
+  echo -e "    2. Need password reset flow?"
+  echo -e "    3. Any rate limiting requirements?"
+  echo -e "    4. Should failed logins be logged?"
+  echo ""
+  sleep 0.3
+
+  echo -e "  ${DIM}After you answer, Ralph:${NC}"
+  echo -e "    1. Generates detailed user stories"
+  echo -e "    2. Creates testable acceptance criteria"
+  echo -e "    3. Runs in a loop until ALL tests pass"
+  echo -e "    4. Commits working code automatically"
+  echo ""
+  echo -e "  ${DIM}You describe what you want. Ralph builds it.${NC}"
+}
+
+demo_skills() {
+  show_step 4 4 "Claude Code commands"
+
+  echo -e "  ${BOLD}In Claude Code, type these commands:${NC}\n"
+
+  echo -e "  ${CYAN}/idea${NC}            Brainstorm → PRD → Ready for Ralph"
+  sleep 0.1
+  echo -e "  ${CYAN}/vibe-help${NC}       Quick reference cheatsheet"
+  sleep 0.1
+  echo -e "  ${CYAN}/tour${NC}            Interactive walkthrough"
+  sleep 0.1
+  echo -e "  ${CYAN}/vibe-check${NC}      Full code quality audit"
+  sleep 0.1
+  echo -e "  ${CYAN}/review${NC}          Code review with security checks"
+  sleep 0.1
+  echo -e "  ${CYAN}/explain${NC}         Explain code line by line"
+  sleep 0.1
+  echo -e "  ${CYAN}/styleguide${NC}      Generate design system reference"
+  echo ""
+
+  echo -e "  ${DIM}These commands guide Claude through${NC}"
+  echo -e "  ${DIM}the agentic-loop workflow.${NC}"
+}
+
+# If run directly, execute feature_tour
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  feature_tour
+fi

package/ralph/setup/quick-setup.sh

@@ -0,0 +1,239 @@
+#!/usr/bin/env bash
+# Path 1: Quick Setup for experienced users
+
+# Get script directory
+WIZARD_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+VIBE_ROOT="$(cd "$WIZARD_DIR/../.." && pwd)"
+
+quick_setup() {
+  clear
+  source "$WIZARD_DIR/ui.sh"
+  show_logo
+
+  # Detect project
+  local project_type
+  project_type=$(detect_project_type)
+  echo -e "  Detected: ${GREEN}$project_type${NC} project\n"
+
+  # Show what will be installed
+  echo -e "  ${BOLD}This will set up:${NC}"
+  echo -e "    ${CYAN}•${NC} Claude Code skills (11 slash commands)"
+  echo -e "    ${CYAN}•${NC} Pre-commit hooks (security + quality)"
+  echo -e "    ${CYAN}•${NC} Ralph autonomous loop"
+  echo -e "    ${CYAN}•${NC} vibe-check CLI"
+  echo ""
+
+  # Non-interactive mode: skip prompts (CI, Claude Code, piped input)
+  if [[ ! -t 0 ]] || [[ -n "${CI:-}" ]] || [[ -n "${CLAUDE_CODE:-}" ]]; then
+    echo -e "  ${DIM}(Non-interactive mode detected, auto-installing...)${NC}"
+    echo ""
+    do_install
+    show_completion
+    return
+  fi
+
+  # Ask how they want to proceed
+  echo -e "  ${BOLD}How would you like to proceed?${NC}"
+  echo ""
+  echo -e "  ${GREEN}[1]${NC} ${EMOJI_ROCKET} ${BOLD}Quick install${NC}"
+  echo -e "      ${DIM}Install everything now, explore later${NC}"
+  echo ""
+  echo -e "  ${GREEN}[2]${NC} ${EMOJI_MOVIE} ${BOLD}Take a tour${NC}"
+  echo -e "      ${DIM}Walk through each feature with Claude${NC}"
+  echo ""
+
+  local choice
+  while true; do
+    echo -ne "  Press ${GREEN}1${NC} or ${GREEN}2${NC} (or ${DIM}q${NC} to quit): "
+    read -r -n 1 choice
+    echo ""
+    case "$choice" in
+      1)
+        echo ""
+        do_install
+        show_completion
+        return
+        ;;
+      2)
+        echo ""
+        echo -e "  ${CYAN}Great!${NC} After setup, run ${BOLD}/tour${NC} in Claude Code"
+        echo -e "  ${DIM}for an interactive walkthrough of all features.${NC}"
+        echo ""
+        sleep 2
+        do_install
+        show_completion_with_tour
+        return
+        ;;
+      q|Q)
+        echo -e "\n  ${DIM}Setup cancelled. Run 'npx agentic-loop' anytime.${NC}"
+        return 1
+        ;;
+      *)
+        echo -e "  ${RED}Invalid choice${NC}"
+        ;;
+    esac
+  done
+}
+
+do_install() {
+  install_claude_skills
+  install_precommit_hooks
+  install_ralph
+  configure_mcp
+}
+
+show_completion_with_tour() {
+  echo ""
+  echo -e "  ${GREEN}┌─────────────────────────────────┐${NC}"
+  echo -e "  ${GREEN}│       Setup complete! ${EMOJI_PARTY}        │${NC}"
+  echo -e "  ${GREEN}└─────────────────────────────────┘${NC}"
+  echo ""
+  echo -e "  ${BOLD}Next step:${NC} Open Claude Code and run:"
+  echo ""
+  echo -e "    ${CYAN}/tour${NC}"
+  echo ""
+  echo -e "  ${DIM}This will walk you through all the features.${NC}"
+  echo ""
+}
+
+detect_project_type() {
+  # Django + React (AllThrive pattern)
+  [[ -d "frontend" && -d "core" ]] && echo "django-react" && return
+  # Django alone
+  [[ -f "manage.py" ]] && echo "django" && return
+  # Rust
+  [[ -f "Cargo.toml" ]] && echo "rust" && return
+  # Go
+  [[ -f "go.mod" ]] && echo "go" && return
+  # Python
+  [[ -f "pyproject.toml" || -f "requirements.txt" ]] && echo "python" && return
+  # Node/TypeScript
+  [[ -f "package.json" ]] && echo "node" && return
+  # Minimal/unknown
+  echo "minimal"
+}
+
+install_claude_skills() {
+  echo -e "  ${CYAN}Installing Claude skills...${NC}"
+
+  mkdir -p .claude/commands
+
+  # Copy all command files from agentic-loop
+  if [[ -d "$VIBE_ROOT/.claude/commands" ]]; then
+    cp -r "$VIBE_ROOT/.claude/commands/"* .claude/commands/ 2>/dev/null || true
+    local count=$(ls -1 .claude/commands/*.md 2>/dev/null | wc -l | tr -d ' ')
+    echo -e "    ${GREEN}${EMOJI_CHECK}${NC} $count slash commands installed"
+  else
+    echo -e "    ${YELLOW}${EMOJI_WARN}${NC} No command templates found"
+  fi
+}
+
+install_precommit_hooks() {
+  echo -e "  ${CYAN}Setting up pre-commit hooks...${NC}"
+
+  if [[ ! -f .pre-commit-config.yaml ]]; then
+    cat > .pre-commit-config.yaml << 'EOF'
+repos:
+  - repo: https://github.com/allthriveai/agentic-loop
+    rev: v1.0.0
+    hooks:
+      - id: check-secrets
+        name: Check for hardcoded secrets
+      - id: check-hardcoded-urls
+        name: Check for hardcoded URLs
+      - id: vibe-check-quality
+        name: AI code quality check
+EOF
+    echo -e "    ${GREEN}${EMOJI_CHECK}${NC} Created .pre-commit-config.yaml"
+  else
+    echo -e "    ${DIM}Skipped: .pre-commit-config.yaml already exists${NC}"
+  fi
+
+  if command -v pre-commit &>/dev/null; then
+    if [[ -d ".git" ]]; then
+      pre-commit install > /dev/null 2>&1
+      echo -e "    ${GREEN}${EMOJI_CHECK}${NC} Hooks installed"
+    else
+      echo -e "    ${YELLOW}${EMOJI_WARN}${NC} Not a git repo, run 'pre-commit install' after git init"
+    fi
+  else
+    echo -e "    ${YELLOW}${EMOJI_WARN}${NC} pre-commit not found"
+    echo -e "        Run: ${CYAN}pip install pre-commit && pre-commit install${NC}"
+  fi
+}
+
+install_ralph() {
+  echo -e "  ${CYAN}Initializing Ralph...${NC}"
+
+  # Delegate to ralph init via the CLI
+  if [[ -f "$VIBE_ROOT/bin/ralph.sh" ]]; then
+    # Only init if not already initialized
+    if [[ ! -d ".ralph" ]]; then
+      if "$VIBE_ROOT/bin/ralph.sh" init > /dev/null 2>&1; then
+        echo -e "    ${GREEN}${EMOJI_CHECK}${NC} Ralph initialized"
+      else
+        echo -e "    ${YELLOW}${EMOJI_WARN}${NC} Ralph init failed (you can run 'ralph init' later)"
+      fi
+    else
+      echo -e "    ${DIM}Skipped: Ralph already initialized${NC}"
+    fi
+  else
+    echo -e "    ${YELLOW}${EMOJI_WARN}${NC} Ralph not available in this installation"
+  fi
+}
+
+configure_mcp() {
+  echo -e "  ${CYAN}Configuring MCP servers...${NC}"
+
+  local claude_json="$HOME/.claude.json"
+
+  # Check for jq
+  if ! command -v jq &>/dev/null; then
+    echo -e "    ${YELLOW}${EMOJI_WARN}${NC} jq not found, skipping MCP config"
+    echo -e "        Install: ${CYAN}brew install jq${NC} or ${CYAN}apt install jq${NC}"
+    return
+  fi
+
+  # Create claude.json if it doesn't exist
+  [[ ! -f "$claude_json" ]] && echo '{}' > "$claude_json"
+
+  # Check if chrome-devtools is already configured
+  if jq -e '.mcpServers["chrome-devtools"]' "$claude_json" > /dev/null 2>&1; then
+    echo -e "    ${DIM}Skipped: Chrome DevTools MCP already configured${NC}"
+    return
+  fi
+
+  # Add Chrome DevTools MCP
+  local tmp=$(mktemp)
+  jq '.mcpServers["chrome-devtools"] = {
+    "command": "npx",
+    "args": ["-y", "@anthropic-ai/mcp-server-chrome-devtools@0.0.5"]
+  }' "$claude_json" > "$tmp" && mv "$tmp" "$claude_json"
+
+  echo -e "    ${GREEN}${EMOJI_CHECK}${NC} Chrome DevTools MCP configured"
+}
+
+show_completion() {
+  echo ""
+  echo -e "  ${GREEN}┌─────────────────────────────────┐${NC}"
+  echo -e "  ${GREEN}│       Setup complete! ${EMOJI_PARTY}        │${NC}"
+  echo -e "  ${GREEN}└─────────────────────────────────┘${NC}"
+  echo ""
+  echo -e "  ${BOLD}Try these commands:${NC}"
+  echo ""
+  echo -e "    ${CYAN}vibe-check .${NC}          Scan your code for issues"
+  echo -e "    ${CYAN}ralph prd \"idea\"${NC}     Start autonomous development"
+  echo -e "    ${CYAN}ralph check${NC}           Run all quality checks"
+  echo ""
+  echo -e "  ${BOLD}In Claude Code:${NC}"
+  echo ""
+  echo -e "    ${CYAN}/help${NC}                 See available commands"
+  echo -e "    ${CYAN}/prd${NC}                  Generate requirements"
+  echo -e "    ${CYAN}/review${NC}               Code review changes"
+  echo ""
+}
+
+# If sourced, export functions; if run directly, execute quick_setup
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  quick_setup
+fi

package/ralph/setup/tutorial.sh

@@ -0,0 +1,159 @@
+#!/usr/bin/env bash
+# Path 3: New to Claude Code tutorial
+
+# Get script directory
+WIZARD_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+tutorial() {
+  source "$WIZARD_DIR/ui.sh"
+  source "$WIZARD_DIR/quick-setup.sh"
+
+  clear
+  show_logo
+  echo -e "  ${BOLD}${EMOJI_BOOK} Welcome to Claude Code!${NC}\n"
+  echo -e "  ${DIM}This tutorial will teach you the basics.${NC}"
+  echo -e "  ${DIM}Press 's' at any time to skip to setup.${NC}\n"
+
+  press_enter || { quick_setup; return; }
+
+  # Lesson 1: What is Claude Code
+  lesson_what_is_claude
+  press_enter || { quick_setup; return; }
+
+  # Lesson 2: Slash commands
+  lesson_slash_commands
+  press_enter || { quick_setup; return; }
+
+  # Lesson 3: MCP servers
+  lesson_mcp
+  press_enter || { quick_setup; return; }
+
+  # Lesson 4: agentic-loop integration
+  lesson_integration
+  press_enter || { quick_setup; return; }
+
+  # Complete - offer setup
+  echo ""
+  echo -e "  ${GREEN}${EMOJI_PARTY} Tutorial complete!${NC}\n"
+  echo -e "  You now know the basics of Claude Code."
+  echo -e "  Let's set up agentic-loop for your project.\n"
+
+  quick_setup
+}
+
+lesson_what_is_claude() {
+  clear
+  show_logo
+  show_step 1 4 "What is Claude Code?"
+
+  echo -e "  Claude Code is ${BOLD}Anthropic's official CLI${NC} for Claude AI."
+  echo ""
+  echo -e "  It's an AI coding assistant that can:"
+  echo ""
+  echo -e "    ${CYAN}•${NC} Read and understand your entire codebase"
+  echo -e "    ${CYAN}•${NC} Write and edit code across multiple files"
+  echo -e "    ${CYAN}•${NC} Run terminal commands (with your permission)"
+  echo -e "    ${CYAN}•${NC} Browse the web for documentation"
+  echo -e "    ${CYAN}•${NC} Use tools via MCP (Model Context Protocol)"
+  echo ""
+  echo -e "  ${BOLD}How to use it:${NC}"
+  echo ""
+  echo -e "    ${DIM}\$ claude${NC}"
+  echo -e "    ${CYAN}Claude:${NC} How can I help you today?"
+  echo ""
+  echo -e "    ${DIM}\$ claude \"explain this function\"${NC}"
+  echo -e "    ${CYAN}Claude:${NC} This function does..."
+  echo ""
+  echo -e "  ${DIM}Try it: Open a new terminal and type 'claude'${NC}"
+}
+
+lesson_slash_commands() {
+  clear
+  show_logo
+  show_step 2 4 "Slash Commands"
+
+  echo -e "  Slash commands are ${BOLD}shortcuts for common tasks${NC}."
+  echo ""
+  echo -e "  ${BOLD}Built-in commands:${NC}"
+  echo ""
+  echo -e "    ${CYAN}/help${NC}      Show all available commands"
+  echo -e "    ${CYAN}/clear${NC}     Clear conversation history"
+  echo -e "    ${CYAN}/compact${NC}   Summarize context to save tokens"
+  echo -e "    ${CYAN}/cost${NC}      Show token usage and cost"
+  echo ""
+  echo -e "  ${BOLD}Custom commands${NC} (from ${DIM}.claude/commands/${NC}):"
+  echo ""
+  echo -e "    ${CYAN}/idea${NC}      Brainstorm → PRD → Ready for Ralph"
+  echo -e "    ${CYAN}/vibe-check${NC} Code quality audit"
+  echo -e "    ${CYAN}/review${NC}    Code review with security checks"
+  echo ""
+  echo -e "  Custom commands are markdown files with prompts."
+  echo -e "  agentic-loop installs 7 pre-built commands."
+  echo ""
+  echo -e "  ${DIM}Try it: In Claude Code, type '/vibe-help' for the cheatsheet${NC}"
+}
+
+lesson_mcp() {
+  clear
+  show_logo
+  show_step 3 4 "MCP Servers (Tools)"
+
+  echo -e "  ${BOLD}MCP${NC} = Model Context Protocol"
+  echo ""
+  echo -e "  MCP lets Claude use ${BOLD}external tools${NC}."
+  echo ""
+  echo -e "  ${BOLD}Example: Chrome DevTools MCP${NC}"
+  echo ""
+  echo -e "    ${CYAN}•${NC} Navigate to URLs in a browser"
+  echo -e "    ${CYAN}•${NC} Take screenshots of pages"
+  echo -e "    ${CYAN}•${NC} Inspect page elements"
+  echo -e "    ${CYAN}•${NC} Check console for errors"
+  echo ""
+  echo -e "  This means Claude can ${BOLD}verify your UI changes${NC}"
+  echo -e "  actually work in a real browser."
+  echo ""
+  echo -e "  ${BOLD}Config location:${NC} ${DIM}~/.claude.json${NC}"
+  echo ""
+  cat << 'EOF'
+  {
+    "mcpServers": {
+      "chrome-devtools": {
+        "command": "npx",
+        "args": ["-y", "@anthropic-ai/mcp-server-chrome-devtools"]
+      }
+    }
+  }
+EOF
+  echo ""
+  echo -e "  ${DIM}agentic-loop configures this automatically.${NC}"
+}
+
+lesson_integration() {
+  clear
+  show_logo
+  show_step 4 4 "agentic-loop Integration"
+
+  echo -e "  ${BOLD}agentic-loop${NC} adds superpowers to Claude Code:"
+  echo ""
+  echo -e "  ${BOLD}1. The Workflow (/idea → Ralph → Ship)${NC}"
+  echo -e "     ${DIM}Brainstorm ideas, generate PRDs, execute autonomously${NC}"
+  echo ""
+  echo -e "  ${BOLD}2. Code Quality (/vibe-check)${NC}"
+  echo -e "     ${DIM}Catches AI-generated code issues before commit${NC}"
+  echo ""
+  echo -e "  ${BOLD}3. Pre-commit Hooks${NC}"
+  echo -e "     ${DIM}Automatically blocks problematic commits${NC}"
+  echo ""
+  echo -e "  ${BOLD}4. Slash Commands (7 included)${NC}"
+  echo -e "     ${DIM}/idea, /vibe-help, /tour, /vibe-check, /review, /explain, /styleguide${NC}"
+  echo ""
+  echo -e "  ${BOLD}5. MCP Configuration${NC}"
+  echo -e "     ${DIM}Chrome DevTools for visual verification${NC}"
+  echo ""
+  echo -e "  ${DIM}All of this installs with: npm install agentic-loop${NC}"
+}
+
+# If run directly, execute tutorial
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+  tutorial
+fi

package/ralph/setup/ui.sh

@@ -0,0 +1,136 @@
+#!/usr/bin/env bash
+# UI utilities: colors, ASCII art, prompts
+
+# Colors
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+MAGENTA='\033[0;35m'
+BOLD='\033[1m'
+DIM='\033[2m'
+NC='\033[0m'
+
+# Emoji support check
+EMOJI_ROCKET="🚀"
+EMOJI_MOVIE="🎬"
+EMOJI_BOOK="📚"
+EMOJI_CHECK="✓"
+EMOJI_CROSS="✗"
+EMOJI_WARN="⚠"
+EMOJI_PARTY="🎉"
+
+show_logo() {
+  echo -e "${CYAN}"
+  cat << 'EOF'
+
+  ╦  ╦╦╔╗ ╔═╗   ┬   ╔╦╗╦ ╦╦═╗╦╦  ╦╔═╗
+  ╚╗╔╝║╠╩╗║╣   ┌┼─   ║ ╠═╣╠╦╝║╚╗╔╝║╣
+   ╚╝ ╩╚═╝╚═╝  └┘    ╩ ╩ ╩╩╚═╩ ╚╝ ╚═╝
+
+EOF
+  echo -e "${NC}"
+  echo -e "  ${DIM}Tools to help you thrive with agentic coding${NC}"
+  echo -e "  ${DIM}by AllThrive.ai${NC}"
+  echo -e "  ${DIM}─────────────────────────────────${NC}"
+  echo ""
+}
+
+show_welcome() {
+  echo -e "  ${BOLD}Welcome!${NC} How would you like to get started?"
+  echo ""
+  echo -e "  ${GREEN}[1]${NC} ${EMOJI_ROCKET} ${BOLD}Quick Setup${NC}"
+  echo -e "      ${DIM}I know what I'm doing, just configure my project${NC}"
+  echo ""
+  echo -e "  ${GREEN}[2]${NC} ${EMOJI_MOVIE} ${BOLD}Feature Tour${NC}"
+  echo -e "      ${DIM}Show me what agentic-loop can do (auto-demo)${NC}"
+  echo ""
+  echo -e "  ${GREEN}[3]${NC} ${EMOJI_BOOK} ${BOLD}New to Claude Code${NC}"
+  echo -e "      ${DIM}Teach me the basics (interactive tutorial)${NC}"
+  echo ""
+}
+
+prompt_menu() {
+  local choice
+  while true; do
+    echo -ne "  Press ${GREEN}1${NC}, ${GREEN}2${NC}, or ${GREEN}3${NC} (or ${DIM}q${NC} to quit): "
+    read -r -n 1 choice
+    echo ""
+    case "$choice" in
+      1|2|3|q|Q) echo "$choice"; return ;;
+      *) echo -e "  ${RED}Invalid choice${NC}" ;;
+    esac
+  done
+}
+
+# Typewriter effect for demos
+typewrite() {
+  local text="$1" delay="${2:-0.02}"
+  for ((i=0; i<${#text}; i++)); do
+    echo -n "${text:$i:1}"
+    sleep "$delay"
+  done
+  echo ""
+}
+
+# Progress indicator
+show_step() {
+  local current="$1" total="$2" desc="$3"
+  echo -e "\n  ${CYAN}[$current/$total]${NC} ${BOLD}$desc${NC}\n"
+}
+
+# Continue prompt with skip option
+# Returns 0 to continue, 1 to skip to setup
+press_enter() {
+  echo ""
+  echo -ne "  ${DIM}Press Enter to continue, or 's' to skip to setup...${NC} "
+  read -r -n 1 key
+  echo ""
+  [[ "$key" == "s" || "$key" == "S" ]] && return 1
+  return 0
+}
+
+# Print success message
+print_success() {
+  echo -e "  ${GREEN}${EMOJI_CHECK}${NC} $1"
+}
+
+# Print error message
+print_error() {
+  echo -e "  ${RED}${EMOJI_CROSS}${NC} $1"
+}
+
+# Print warning message
+print_warning() {
+  echo -e "  ${YELLOW}${EMOJI_WARN}${NC} $1"
+}
+
+# Print info message
+print_info() {
+  echo -e "  ${CYAN}→${NC} $1"
+}
+
+# Spinner for long operations
+spin() {
+  local pid=$1
+  local delay=0.1
+  local spinstr='|/-\'
+  while [ "$(ps a | awk '{print $1}' | grep $pid)" ]; do
+    local temp=${spinstr#?}
+    printf "  [%c]  " "$spinstr"
+    local spinstr=$temp${spinstr%"$temp"}
+    sleep $delay
+    printf "\b\b\b\b\b\b"
+  done
+  printf "      \b\b\b\b\b\b"
+}
+
+# Confirmation prompt
+confirm() {
+  local prompt="${1:-Proceed?}"
+  echo -ne "  $prompt ${GREEN}[Y/n]${NC} "
+  read -r -n 1 confirm
+  echo ""
+  [[ "$confirm" != "n" && "$confirm" != "N" ]]
+}