vagrant-claude-sandbox 0.2.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a0c3f6d76bc6a8854641197815ae4e7a1b5685a322576d72969d8e00b82b39d7
-  data.tar.gz: 67eb291fdbefa65b04a48d684e89658955c7819d9f49df469a27d1b8b035cd38
+  metadata.gz: 83aa818f90a8658daa51e1666f727910359e687032aa9e0c2686667ab82c5e57
+  data.tar.gz: a683a780d3770714c1be586f7066a3dfa102a858c5cc2bb123da9e936d2fb43a
 SHA512:
-  metadata.gz: 0da4554053ffc441c32e1f97e0be973aead1bc98b8a77d62956987b4f4f9413709e935c48731bea51740f52f20ef78f44331ca422ad86c3c082173776af26d68
-  data.tar.gz: bf1b40b5839f36a84180436c120af389eb7b3d92aadacf3172520e2f5b8ec01a4396230f7c237fb1450a79f0400ed171becf14716914fdc0be18d492d816641b
+  metadata.gz: 45117ae9e15c7101215e393ce4bb7e70c05c0e5b37885b648f1c15253176ffd631b5638b8bcd5d860a9d52fadeb9e47ff2cde209c0028afd4f40571889b789d2
+  data.tar.gz: 8083c2e00adf8dbc09f6b758a53d64bf9db7527e2dca70d74df3520b8a3719fa0329e439a261dcd27b019ccc952366cc8be0a037c08eb9b0f996f9bfd34ddc75

data/README.md

@@ -125,6 +125,14 @@ end
 
 **Security note:** Only use mirrors from trusted sources. The official Ubuntu mirror is always the safest option.
 
+## Notifications
+
+Vagrant uses the `vagrant-notify-server` gem to provide desktop notifications from Claude.
+To display notifications on your OS, [install `terminal-notifier` on MacOS](https://formulae.brew.sh/formula/terminal-notifier) or `libnotify-bin` on Linux (untested).
+
+By default notifications appear when Claude completes tasks or needs input.
+To customize notification behavior: Copy lib/vagrant-claude-sandbox/notification_config.yml.example to ~/.vagrant-claude-sandbox/notification_config.yml to configure which notifications appear.
+
 ## Development and Testing
 
 ### Running Tests

data/bin/vagrant-notify-server

@@ -0,0 +1,12 @@
+#!/usr/bin/env ruby
+
+# Add lib directory to load path
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+require 'vagrant-claude-sandbox/notification_server'
+
+# If port specified on command line, use it. Otherwise, let auto-detection work
+# (reads from .vagrant-notification-port if present, otherwise uses default)
+port = ARGV[0] ? ARGV[0].to_i : nil
+server = VagrantPlugins::ClaudeSandbox::NotificationServer.new(port)
+server.start

data/lib/vagrant-claude-sandbox/command.rb

@@ -27,7 +27,8 @@ module VagrantPlugins
           workspace_path = config.workspace_path || "/agent-workspace"
 
           # Build the command to run
-          command = "cd #{workspace_path}; . ~/.nvm/nvm.sh && exec claude --dangerously-skip-permissions --chrome"
+          # Source nvm only if needed (claude might already be in PATH)
+          command = "cd #{workspace_path}; [ -f ~/.nvm/nvm.sh ] && . ~/.nvm/nvm.sh; exec claude --dangerously-skip-permissions --chrome"
 
           # Execute SSH with the command
           machine.action(:ssh_run, ssh_run_command: command, ssh_opts: { extra_args: ["-t"] })

data/lib/vagrant-claude-sandbox/config.rb

@@ -33,7 +33,7 @@ module VagrantPlugins
         @claude_config_path = File.expand_path("~/.claude/") if @claude_config_path == UNSET_VALUE
         @skip_claude_cli_install = false if @skip_claude_cli_install == UNSET_VALUE
         @additional_packages = [] if @additional_packages == UNSET_VALUE
-        @provider = "virtualbox" if @provider == UNSET_VALUE
+        @provider = "docker" if @provider == UNSET_VALUE
         @docker_image = nil if @docker_image == UNSET_VALUE
         @ubuntu_mirror = nil if @ubuntu_mirror == UNSET_VALUE
       end
@@ -72,7 +72,7 @@ module VagrantPlugins
         # Vagrant will choose the appropriate one based on:
         # 1. --provider flag from command line
         # 2. Existing .vagrant directory state
-        # 3. Default provider (VirtualBox)
+        # 3. Default provider (Docker)
         apply_virtualbox_config!(root_config)
         apply_docker_config!(root_config)
 
@@ -96,8 +96,49 @@ module VagrantPlugins
             destination: "/tmp/claude-config"
         end
 
+        # Copy claude-notify script to VM
+        claude_notify_script = File.expand_path("../scripts/claude-notify", __FILE__)
+        if File.exist?(claude_notify_script)
+          root_config.vm.provision "file",
+            source: claude_notify_script,
+            destination: "/tmp/claude-notify"
+        end
+
         # Configure SSH port with auto-correction for conflicts
         root_config.vm.network :forwarded_port, guest: 22, host: 2200, id: "ssh", auto_correct: true
+
+        # Forward notification port from host to guest (guest can send notifications to host)
+        # Use auto_correct to handle port conflicts
+        root_config.vm.network :forwarded_port, guest: 29325, host: 29325, id: "notifications", host_ip: "127.0.0.1", auto_correct: true
+
+        # Write the actual notification port to a file after VM is up so scripts can read it
+        root_config.trigger.after :up do |trigger|
+          trigger.ruby do |env, machine|
+            # Get the actual forwarded port for notifications
+            ports = machine.provider.driver.read_forwarded_ports rescue []
+            notification_port = nil
+
+            # Find the notification port mapping
+            ports.each do |port_info|
+              # Format varies by provider, handle both
+              if port_info.is_a?(Array) && port_info.length >= 4
+                # VirtualBox format: [name, guest_port, host_port, host_ip]
+                notification_port = port_info[2] if port_info[1] == 29325
+              elsif port_info.is_a?(Hash)
+                notification_port = port_info[:host] if port_info[:guest] == 29325
+              end
+            end
+
+            # Default to 29325 if we couldn't detect
+            notification_port ||= 29325
+
+            # Write port to workspace config file
+            workspace = machine.config.claude_sandbox.workspace_path rescue "/agent-workspace"
+            port_file = File.join(Dir.pwd, ".vagrant-notification-port")
+            File.write(port_file, notification_port.to_s)
+            machine.ui.info("Notification server port: #{notification_port}")
+          end
+        end
       end
 
       def apply_virtualbox_config!(root_config)
@@ -172,6 +213,10 @@ module VagrantPlugins
             lsb-release \
             git \
             unzip \
+            libnotify-bin \
+            dbus-x11 \
+            inotify-tools \
+            netcat-openbsd \
             #{additional_packages}
 
           #{docker_install_script}
@@ -223,6 +268,86 @@ module VagrantPlugins
             echo "Claude plugins and skills loaded successfully!"
           fi
 
+          # Set up notification forwarding to host
+          echo "Setting up notification forwarding to host..."
+
+          # Backup original notify-send if it exists
+          if [ -f /usr/bin/notify-send ]; then
+            mv /usr/bin/notify-send /usr/bin/notify-send.real
+          fi
+
+          # Create wrapper script that forwards to host
+          cat > /usr/bin/notify-send << 'NOTIFY_EOF'
+#!/bin/bash
+# Wrapper script to forward notifications to host
+
+TITLE=""
+MESSAGE=""
+
+# Read port from config file (written by vagrant trigger), default to 29325
+if [ -f "/agent-workspace/.vagrant-notification-port" ]; then
+    HOST_PORT=$(cat /agent-workspace/.vagrant-notification-port)
+else
+    HOST_PORT=29325
+fi
+
+# Parse notify-send arguments (simplified)
+while [[ $# -gt 0 ]]; do
+  case $1 in
+    -u|--urgency)
+      shift 2
+      ;;
+    -t|--expire-time)
+      shift 2
+      ;;
+    -i|--icon)
+      shift 2
+      ;;
+    -c|--category)
+      shift 2
+      ;;
+    *)
+      if [ -z "$TITLE" ]; then
+        TITLE="$1"
+      elif [ -z "$MESSAGE" ]; then
+        MESSAGE="$1"
+      fi
+      shift
+      ;;
+  esac
+done
+
+# Default message if not provided
+[ -z "$MESSAGE" ] && MESSAGE="$TITLE" && TITLE="Notification"
+
+# Try host.docker.internal first (Docker), then fall back to 10.0.2.2 (VirtualBox)
+for HOST_IP in host.docker.internal 10.0.2.2; do
+  if echo "NOTIFY|$TITLE|$MESSAGE" | nc -w 1 $HOST_IP $HOST_PORT > /dev/null 2>&1; then
+    exit 0
+  fi
+done
+
+# Fall back to local notification if host server not available
+if [ -f /usr/bin/notify-send.real ]; then
+  exec /usr/bin/notify-send.real "$TITLE" "$MESSAGE"
+fi
+
+# If all else fails, just log it
+logger "Notification: $TITLE - $MESSAGE"
+NOTIFY_EOF
+
+          chmod +x /usr/bin/notify-send
+          echo "Notification forwarding configured!"
+
+          # Install claude-notify helper script
+          if [ -f "/tmp/claude-notify" ]; then
+            echo "Installing claude-notify helper script..."
+            mv /tmp/claude-notify /usr/local/bin/claude-notify
+            chmod +x /usr/local/bin/claude-notify
+            chown root:root /usr/local/bin/claude-notify
+            echo "claude-notify installed successfully!"
+          fi
+
           echo "Claude sandbox environment setup complete!"
         SHELL
 

data/lib/vagrant-claude-sandbox/notification_config.yml.example

@@ -0,0 +1,29 @@
+# Notification Configuration for vagrant-claude-sandbox
+# Copy this file to ~/.vagrant-claude-sandbox/notification_config.yml to customize
+
+# Which notification types to show
+# Types: info, success, error, warning, needs_input, task_complete, task_start
+show_types:
+  - task_complete
+  - needs_input
+  - error
+  - warning
+
+# Default timeout in seconds (0 = permanent until dismissed)
+default_timeout: 0
+
+# Override timeout for specific types (in seconds)
+type_timeouts:
+  info: 10
+  success: 15
+  error: 0       # Errors stay until dismissed
+  warning: 0     # Warnings stay until dismissed
+  needs_input: 0 # User input needed stays until dismissed
+  task_complete: 0  # Task completions stay until dismissed
+  task_start: 5  # Task starts auto-dismiss after 5s
+
+# Enable sound for notifications
+enable_sound: false
+
+# Only show notifications with URLs (e.g., link to conversation)
+require_url: false

data/lib/vagrant-claude-sandbox/notification_server.rb

@@ -0,0 +1,189 @@
+require 'socket'
+require 'json'
+require 'yaml'
+
+module VagrantPlugins
+  module ClaudeSandbox
+    class NotificationServer
+      DEFAULT_PORT = 29325
+      PORT_FILE = ".vagrant-notification-port"
+      DEFAULT_CONFIG = {
+        'show_types' => ['task_complete', 'needs_input', 'error', 'warning'],
+        'default_timeout' => 0,
+        'type_timeouts' => {
+          'info' => 10,
+          'success' => 15,
+          'error' => 0,
+          'warning' => 0,
+          'needs_input' => 0,
+          'task_complete' => 0,
+          'task_start' => 5
+        },
+        'enable_sound' => false,
+        'require_url' => false
+      }
+
+      def initialize(port = nil)
+        @port = port || detect_port
+        @server = nil
+        @config = load_config
+      end
+
+      def detect_port
+        # Check for port file in current directory (written by vagrant trigger)
+        if File.exist?(PORT_FILE)
+          port = File.read(PORT_FILE).strip.to_i
+          return port if port > 0
+        end
+        DEFAULT_PORT
+      end
+
+      def load_config
+        config_path = File.expand_path('~/.vagrant-claude-sandbox/notification_config.yml')
+        if File.exist?(config_path)
+          begin
+            loaded = YAML.load_file(config_path)
+            DEFAULT_CONFIG.merge(loaded || {})
+          rescue => e
+            puts "Warning: Failed to load config from #{config_path}: #{e.message}"
+            puts "Using default configuration"
+            DEFAULT_CONFIG
+          end
+        else
+          DEFAULT_CONFIG
+        end
+      end
+
+      def start
+        @server = TCPServer.new('127.0.0.1', @port)
+        puts "Notification server listening on port #{@port}..."
+        puts "VM can now send notifications to this host."
+        puts ""
+        puts "Configuration:"
+        puts "  Show types: #{@config['show_types'].join(', ')}"
+        puts "  Default timeout: #{@config['default_timeout'] == 0 ? 'permanent' : "#{@config['default_timeout']}s"}"
+        puts "  Require URL: #{@config['require_url']}"
+        puts ""
+        puts "Press Ctrl+C to stop."
+
+        trap("INT") do
+          puts "\nShutting down notification server..."
+          @server.close if @server
+          exit
+        end
+
+        loop do
+          client = @server.accept
+          handle_client(client)
+        end
+      rescue Errno::EADDRINUSE
+        puts "Error: Port #{@port} is already in use."
+        puts "Another notification server may already be running."
+        exit 1
+      rescue => e
+        puts "Error starting notification server: #{e.message}"
+        exit 1
+      end
+
+      private
+
+      def handle_client(client)
+        request = client.gets
+        return unless request
+
+        # Parse protocol: NOTIFY|title|message|url|timeout|type (url, timeout, type optional)
+        parts = request.strip.split('|', 6)
+        if parts[0] == 'NOTIFY' && parts.length >= 3
+          title = parts[1]
+          message = parts[2]
+          url = parts[3] if parts.length >= 4 && !parts[3].to_s.strip.empty?
+          timeout_str = parts[4] if parts.length >= 5
+          timeout = timeout_str.to_i if timeout_str && !timeout_str.strip.empty?
+          type = parts[5] if parts.length >= 6
+          type = 'info' if !type || type.strip.empty?
+          type = type.strip if type
+
+          # Filter based on configuration
+          if should_show_notification?(type, url)
+            # Apply configured timeout
+            timeout = get_timeout_for_type(type) if timeout.nil?
+            send_notification(title, message, url, timeout, type)
+            client.puts "OK"
+          else
+            client.puts "FILTERED"
+          end
+        else
+          client.puts "ERROR: Invalid format. Use: NOTIFY|title|message|url|timeout|type"
+        end
+      ensure
+        client.close
+      end
+
+      def should_show_notification?(type, url)
+        # Check if this type should be shown
+        return false unless @config['show_types'].include?(type)
+
+        # Check if URL is required
+        return false if @config['require_url'] && (url.nil? || url.empty?)
+
+        true
+      end
+
+      def get_timeout_for_type(type)
+        @config['type_timeouts'][type] || @config['default_timeout']
+      end
+
+      def send_notification(title, message, url = nil, timeout = nil, type = 'info')
+        # Detect OS and send notification
+        case RbConfig::CONFIG['host_os']
+        when /darwin|mac os/
+          send_macos_notification(title, message, url, timeout, type)
+        when /linux/
+          send_linux_notification(title, message, url, timeout, type)
+        else
+          puts "[#{type}] #{title}: #{message}"
+          puts "  URL: #{url}" if url
+          puts "  Timeout: #{timeout}s" if timeout
+        end
+      end
+
+      def send_macos_notification(title, message, url = nil, timeout = nil, type = 'info')
+        # Try terminal-notifier first (more features including clickable notifications)
+        if system('which terminal-notifier > /dev/null 2>&1')
+          args = ['-title', title, '-message', message]
+          args += ['-sound', 'default'] if @config['enable_sound']
+          args += ['-open', url] if url
+          # terminal-notifier timeout is in seconds, 0 means "stick around until dismissed"
+          args += ['-timeout', timeout.to_s] if timeout && timeout > 0
+          system('terminal-notifier', *args)
+        else
+          # Fall back to osascript (not clickable, no timeout control)
+          escaped_title = title.gsub('"', '\"')
+          escaped_message = message.gsub('"', '\"')
+          system("osascript -e 'display notification \"#{escaped_message}\" with title \"#{escaped_title}\"'")
+          puts "  (Install terminal-notifier for clickable notifications and timeout control: brew install terminal-notifier)" if url || timeout
+        end
+      end
+
+      def send_linux_notification(title, message, url = nil, timeout = nil, type = 'info')
+        # notify-send supports -t for timeout in milliseconds
+        args = [title]
+
+        # Add URL to message if provided
+        if url
+          full_message = "#{message}\n\n🔗 #{url}"
+          args << full_message
+        else
+          args << message
+        end
+
+        # Add timeout if specified (convert seconds to milliseconds, 0 means no timeout)
+        if timeout && timeout > 0
+          args += ['-t', (timeout * 1000).to_s]
+        end
+
+        system('notify-send', *args)
+      end
+    end
+  end
+end

data/lib/vagrant-claude-sandbox/plugin.rb

@@ -1,4 +1,8 @@
 require_relative "path_fixer"
+require 'fileutils'
+
+# Set Docker as the default provider unless already specified
+ENV['VAGRANT_DEFAULT_PROVIDER'] ||= 'docker'
 
 # Fix Docker PATH issues immediately when plugin loads (before Vagrant initialization)
 VagrantPlugins::ClaudeSandbox::PathFixer.fix_docker_path!
@@ -18,6 +22,40 @@ module VagrantPlugins
         require_relative "command"
         Command
       end
+
+      # Check for required plugins on environment load
+      action_hook(:check_dependencies, :environment_load) do |hook|
+        hook.after(Vagrant::Action::Builtin::HandleBox, Action::CheckDependencies)
+      end
+    end
+
+    # Action to check for vagrant-notify-forwarder plugin
+    module Action
+      class CheckDependencies
+        def initialize(app, env)
+          @app = app
+        end
+
+        def call(env)
+          # Check if vagrant-notify-forwarder is installed
+          unless plugin_installed?("vagrant-notify-forwarder")
+            env[:ui].warn("vagrant-notify-forwarder plugin is not installed.")
+            env[:ui].warn("This plugin enables real-time filesystem change notifications from host to guest,")
+            env[:ui].warn("improving performance for development tools like webpack, nodemon, etc.")
+            env[:ui].warn("")
+            env[:ui].info("Install it with: vagrant plugin install vagrant-notify-forwarder")
+            env[:ui].warn("")
+          end
+
+          @app.call(env)
+        end
+
+        private
+
+        def plugin_installed?(plugin_name)
+          Vagrant::Plugin::Manager.instance.installed_plugins.key?(plugin_name)
+        end
+      end
     end
   end
 end

data/lib/vagrant-claude-sandbox/scripts/claude-notify

@@ -0,0 +1,300 @@
+#!/bin/bash
+# Claude Code notification helper
+# Sends rich notifications with project context and optional URLs
+
+# Don't use set -e because we handle non-zero exit codes explicitly
+set +e
+
+# Configuration
+# Read port from config file (written by vagrant trigger), default to 29325
+if [ -f "/agent-workspace/.vagrant-notification-port" ]; then
+    HOST_PORT=$(cat /agent-workspace/.vagrant-notification-port)
+else
+    HOST_PORT=29325
+fi
+NOTIFICATION_TIMEOUT=1
+
+# Colors for terminal output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Usage information
+usage() {
+    cat << EOF
+Usage: claude-notify [OPTIONS] TITLE [MESSAGE]
+
+Send a notification from Claude Code to the host machine.
+
+OPTIONS:
+    -u, --url URL              Add clickable URL to notification
+    -s, --session ID           Add session/conversation ID
+    -p, --project PATH         Project path (default: current directory)
+    -t, --timeout SECONDS      How long notification stays visible (default: from config)
+    --type TYPE                Notification type (default: auto-detect)
+    -h, --help                 Show this help message
+
+NOTIFICATION TYPES:
+    info           - General information (default)
+    success        - Success messages
+    error          - Error messages (high priority)
+    warning        - Warning messages (high priority)
+    needs_input    - Claude needs user input (high priority)
+    task_complete  - Task completed (default shown)
+    task_start     - Task started (default filtered)
+
+DEFAULT BEHAVIOR:
+    - Only task_complete, needs_input, error, warning shown
+    - Notifications are permanent (stay until dismissed)
+    - Configure in ~/.vagrant-claude-sandbox/notification_config.yml
+
+EXAMPLES:
+    # Task completion (shown by default)
+    claude-notify "Build Complete" "All tests passed!"
+
+    # Task completion with URL
+    claude-notify --type task_complete -u "https://claude.ai/chat/abc" "Done" "Ready for review"
+
+    # Needs input (shown by default)
+    claude-notify --type needs_input "Input Required" "Which API endpoint to use?"
+
+    # Task start (filtered by default)
+    claude-notify --type task_start "Building" "Starting build process..."
+
+    # Error (shown by default, permanent)
+    claude-notify --type error "Build Failed" "Check line 42"
+
+ENVIRONMENT VARIABLES:
+    CLAUDE_SESSION_ID       Current Claude conversation ID
+    CLAUDE_SESSION_URL      Direct URL to current conversation
+    CLAUDE_PROJECT_PATH     Current project directory
+
+EOF
+    exit 0
+}
+
+# Parse arguments
+TITLE=""
+MESSAGE=""
+URL=""
+SESSION_ID=""
+TIMEOUT=""
+TYPE=""
+
+# Default to workspace directory if we're in /home/vagrant
+if [ "$PWD" = "/home/vagrant" ] && [ -d "/agent-workspace" ]; then
+    PROJECT_PATH="${CLAUDE_PROJECT_PATH:-/agent-workspace}"
+else
+    PROJECT_PATH="${CLAUDE_PROJECT_PATH:-$PWD}"
+fi
+
+while [[ $# -gt 0 ]]; do
+    case $1 in
+        -h|--help)
+            usage
+            ;;
+        -u|--url)
+            URL="$2"
+            shift 2
+            ;;
+        -s|--session)
+            SESSION_ID="$2"
+            shift 2
+            ;;
+        -p|--project)
+            PROJECT_PATH="$2"
+            shift 2
+            ;;
+        -t|--timeout)
+            TIMEOUT="$2"
+            shift 2
+            ;;
+        --type)
+            TYPE="$2"
+            shift 2
+            ;;
+        *)
+            if [ -z "$TITLE" ]; then
+                TITLE="$1"
+            elif [ -z "$MESSAGE" ]; then
+                MESSAGE="$1"
+            else
+                echo -e "${RED}Error: Too many arguments${NC}" >&2
+                echo "Run 'claude-notify --help' for usage information" >&2
+                exit 1
+            fi
+            shift
+            ;;
+    esac
+done
+
+# Validate required arguments
+if [ -z "$TITLE" ]; then
+    echo -e "${RED}Error: TITLE is required${NC}" >&2
+    echo "Run 'claude-notify --help' for usage information" >&2
+    exit 1
+fi
+
+# Use title as message if no message provided
+if [ -z "$MESSAGE" ]; then
+    MESSAGE="$TITLE"
+fi
+
+# Try to get session info from environment if not provided
+if [ -z "$URL" ]; then
+    if [ -n "$CLAUDE_SESSION_URL" ]; then
+        URL="$CLAUDE_SESSION_URL"
+    elif [ -n "$SESSION_ID" ]; then
+        # Construct URL from session ID
+        URL="https://claude.ai/chat/${SESSION_ID}"
+    elif [ -n "$CLAUDE_SESSION_ID" ]; then
+        URL="https://claude.ai/chat/${CLAUDE_SESSION_ID}"
+    fi
+fi
+
+# Detect project name intelligently
+detect_project_name() {
+    local path="$1"
+    local name=""
+
+    # Try git remote first
+    if [ -d "$path/.git" ]; then
+        name=$(cd "$path" && git remote get-url origin 2>/dev/null | sed -E 's/.*\/(.+)(\.git)?$/\1/' | sed 's/\.git$//')
+    fi
+
+    # Try package.json
+    if [ -z "$name" ] && [ -f "$path/package.json" ]; then
+        name=$(grep -o '"name"[[:space:]]*:[[:space:]]*"[^"]*"' "$path/package.json" 2>/dev/null | head -1 | sed 's/"name"[[:space:]]*:[[:space:]]*"\([^"]*\)"/\1/')
+    fi
+
+    # Try Cargo.toml
+    if [ -z "$name" ] && [ -f "$path/Cargo.toml" ]; then
+        name=$(grep -o 'name[[:space:]]*=[[:space:]]*"[^"]*"' "$path/Cargo.toml" 2>/dev/null | head -1 | sed 's/name[[:space:]]*=[[:space:]]*"\([^"]*\)"/\1/')
+    fi
+
+    # Fall back to directory name
+    if [ -z "$name" ]; then
+        name=$(basename "$path")
+    fi
+
+    echo "$name"
+}
+
+# Auto-detect notification type from message content
+detect_type() {
+    local title="$1"
+    local message="$2"
+    local combined="$title $message"
+
+    # Check for needs input keywords
+    if echo "$combined" | grep -qiE "(input|choose|select|confirm|approve|review|check|question)"; then
+        echo "needs_input"
+        return
+    fi
+
+    # Check for error keywords
+    if echo "$combined" | grep -qiE "(error|fail|failed|exception|critical|crash)"; then
+        echo "error"
+        return
+    fi
+
+    # Check for warning keywords
+    if echo "$combined" | grep -qiE "(warning|warn|deprecated|caution|alert)"; then
+        echo "warning"
+        return
+    fi
+
+    # Check for task complete keywords
+    if echo "$combined" | grep -qiE "(complete|completed|done|finished|success|passed|ready)"; then
+        echo "task_complete"
+        return
+    fi
+
+    # Check for task start keywords
+    if echo "$combined" | grep -qiE "(start|starting|begin|beginning|running|processing)"; then
+        echo "task_start"
+        return
+    fi
+
+    # Check for success keywords
+    if echo "$combined" | grep -qiE "(success|successful|ok|okay)"; then
+        echo "success"
+        return
+    fi
+
+    # Default to info
+    echo "info"
+}
+
+# Enhance message with project context
+PROJECT_NAME=$(detect_project_name "$PROJECT_PATH")
+# Don't use newlines - they don't render properly
+# Add project name to the title instead
+ENHANCED_TITLE="[${PROJECT_NAME}] ${TITLE}"
+ENHANCED_MESSAGE="${MESSAGE}"
+
+# Auto-detect type if not specified
+if [ -z "$TYPE" ]; then
+    TYPE=$(detect_type "$TITLE" "$MESSAGE")
+fi
+
+# Timeout defaults to empty (server will use configured default)
+if [ -z "$TIMEOUT" ]; then
+    TIMEOUT=""
+fi
+
+# Determine host IP (Docker vs VirtualBox)
+detect_host() {
+    # Try host.docker.internal first (Docker)
+    if getent hosts host.docker.internal > /dev/null 2>&1; then
+        echo "host.docker.internal"
+        return 0
+    fi
+    # Fall back to VirtualBox gateway
+    echo "10.0.2.2"
+}
+
+HOST_IP=$(detect_host)
+
+# Send notification
+send_notification() {
+    local payload="NOTIFY|${ENHANCED_TITLE}|${ENHANCED_MESSAGE}|${URL:-}|${TIMEOUT}|${TYPE}"
+
+    local response=$(echo "$payload" | nc -w "$NOTIFICATION_TIMEOUT" "$HOST_IP" "$HOST_PORT" 2>&1)
+
+    if [ "$response" = "OK" ]; then
+        return 0
+    elif [ "$response" = "FILTERED" ]; then
+        return 2  # Filtered by server config
+    else
+        return 1  # Connection failed
+    fi
+}
+
+# Try to send notification
+send_notification
+result=$?
+
+if [ $result -eq 0 ]; then
+    echo -e "${GREEN}✓${NC} Notification sent to host [${TYPE}]"
+    [ -n "$URL" ] && echo -e "  ${YELLOW}🔗${NC} Clickable URL: $URL"
+    [ -n "$TIMEOUT" ] && echo -e "  ⏱  Timeout: ${TIMEOUT}s"
+    exit 0
+elif [ $result -eq 2 ]; then
+    echo -e "${YELLOW}○${NC} Notification filtered by server config [${TYPE}]"
+    exit 0
+else
+    echo -e "${YELLOW}⚠${NC} Could not reach notification server on host" >&2
+    echo -e "  Make sure ${GREEN}vagrant-notify-server${NC} is running on your host machine" >&2
+    echo -e "  Notification: ${TITLE} - ${MESSAGE}" >&2
+
+    # Fall back to local notification if available
+    if [ -f /usr/bin/notify-send.real ]; then
+        /usr/bin/notify-send.real "$TITLE" "$MESSAGE" 2>/dev/null || true
+    fi
+
+    # Log to syslog as last resort
+    logger "Claude Notification: $TITLE - $MESSAGE"
+    exit 1
+fi

data/lib/vagrant-claude-sandbox/version.rb

@@ -1,5 +1,5 @@
 module VagrantPlugins
   module ClaudeSandbox
-    VERSION = "0.2.0"
+    VERSION = "0.3.1"
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: vagrant-claude-sandbox
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Bero
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-01-26 00:00:00.000000000 Z
+date: 2026-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -41,18 +41,23 @@ dependencies:
 description: Provides a pre-configured sandbox environment for running Claude Code
   in an isolated VM with full plugin and skills support
 email: 
-executables: []
+executables:
+- vagrant-notify-server
 extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
+- bin/vagrant-notify-server
 - lib/docker/Dockerfile
 - lib/vagrant-claude-sandbox.rb
 - lib/vagrant-claude-sandbox/command.rb
 - lib/vagrant-claude-sandbox/config.rb
+- lib/vagrant-claude-sandbox/notification_config.yml.example
+- lib/vagrant-claude-sandbox/notification_server.rb
 - lib/vagrant-claude-sandbox/path_fixer.rb
 - lib/vagrant-claude-sandbox/plugin.rb
+- lib/vagrant-claude-sandbox/scripts/claude-notify
 - lib/vagrant-claude-sandbox/version.rb
 homepage: https://github.com/bgrgicak/vagrant-claude-sandbox
 licenses: