vagrant-claude-sandbox 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0b41524c843f1c62cda68ca45015a524bfbdade5bd81d5fba9ca1b9d700cae84
+  data.tar.gz: dea52ec2514c2f0fdafa87374b5ff25b4b82381d2673d96968c72c6ee0e0b5ef
+SHA512:
+  metadata.gz: 5df48ce7440d827876072a884ae460e4b4fdf25e88b0455799fa3ce1ab7272c30a1b2ad6f2055b36dee52acbc328c74e4dc73a822b2e2af0066b9dec453c0265
+  data.tar.gz: b6af4d17d0f8260223250ebbbf8ee5bd38dcf6f84bd929cbbdf3e0a72f6275d09fb97619a0ca9dfa94cf0c99ef38c822917fc9d17b51f86cf27425d6d78b1875

data/LICENSE

@@ -0,0 +1,19 @@
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,87 @@
+# Vagrant Claude Sandbox
+
+A Vagrant plugin for running Claude Code in an isolated VM sandbox.
+
+## Features
+
+- Ubuntu 24.04 LTS with Docker, Node.js, git pre-installed
+- Automatic Claude Code CLI installation
+- Synced workspace folder and Claude config
+- **Full Claude plugins and skills support** - automatically loads your installed plugins and skills with fixed paths
+- `claude-yolo` wrapper (runs Claude with `--dangerously-skip-permissions`)
+- Customizable VM resources
+
+## Prerequisites
+
+- [Vagrant](https://www.vagrantup.com/downloads) >= 2.2.0
+- [VirtualBox](https://www.virtualbox.org/wiki/Downloads) >= 6.1
+
+## Installation
+
+```bash
+vagrant plugin install vagrant-claude-sandbox
+```
+
+## Usage
+
+Create a `Vagrantfile`:
+
+```ruby
+Vagrant.configure("2") do |config|
+  config.claude_sandbox.apply_to!(config)
+end
+```
+
+Start the VM:
+
+```bash
+vagrant up
+vagrant ssh
+claude-yolo  # Inside VM
+```
+
+### Custom Configuration
+
+```ruby
+Vagrant.configure("2") do |config|
+  config.claude_sandbox.apply_to!(config) do |sandbox|
+    sandbox.memory = 8192
+    sandbox.cpus = 4
+    sandbox.additional_packages = ["vim", "htop"]
+  end
+end
+```
+
+### Options
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `memory` | `4096` | RAM in MB |
+| `cpus` | `2` | Number of CPUs |
+| `box` | `"bento/ubuntu-24.04"` | Vagrant box |
+| `workspace_path` | `"/agent-workspace"` | Workspace path in VM |
+| `claude_config_path` | `"~/.claude/"` | Host Claude config path |
+| `skip_claude_cli_install` | `false` | Skip Claude CLI installation |
+| `additional_packages` | `[]` | Extra apt packages |
+
+## Plugin and Skills Support
+
+This plugin automatically copies your `~/.claude/` directory to the VM and fixes absolute paths in plugin configuration files. This means:
+
+- All your installed Claude plugins will work in the VM
+- All your custom skills will be available
+- Plugin paths are automatically updated from host paths to VM paths
+
+The plugin configuration files that are updated:
+- `~/.claude/plugins/installed_plugins.json`
+- `~/.claude/plugins/known_marketplaces.json`
+
+This ensures that plugins and skills that reference local file paths will work correctly inside the VM environment.
+
+## Credits
+
+Original idea by [@emilburzo](https://github.com/emilburzo) - [blog post](https://blog.emilburzo.com/2026/01/running-claude-code-dangerously-safely/)
+
+## License
+
+MIT License - see [LICENSE](LICENSE)

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

@@ -0,0 +1,174 @@
+module VagrantPlugins
+  module ClaudeSandbox
+    class Config < Vagrant.plugin("2", :config)
+      attr_accessor :memory
+      attr_accessor :cpus
+      attr_accessor :box
+      attr_accessor :workspace_path
+      attr_accessor :claude_config_path
+      attr_accessor :skip_claude_cli_install
+      attr_accessor :additional_packages
+
+      def initialize
+        @memory = UNSET_VALUE
+        @cpus = UNSET_VALUE
+        @box = UNSET_VALUE
+        @workspace_path = UNSET_VALUE
+        @claude_config_path = UNSET_VALUE
+        @skip_claude_cli_install = UNSET_VALUE
+        @additional_packages = UNSET_VALUE
+      end
+
+      def finalize!
+        @memory = 4096 if @memory == UNSET_VALUE
+        @cpus = 2 if @cpus == UNSET_VALUE
+        @box = "bento/ubuntu-24.04" if @box == UNSET_VALUE
+        @workspace_path = "/agent-workspace" if @workspace_path == UNSET_VALUE
+        @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
+      end
+
+      def validate(machine)
+        errors = _detected_errors
+
+        if @memory && !@memory.is_a?(Integer)
+          errors << "memory must be an integer"
+        end
+
+        if @cpus && !@cpus.is_a?(Integer)
+          errors << "cpus must be an integer"
+        end
+
+        if @additional_packages && !@additional_packages.is_a?(Array)
+          errors << "additional_packages must be an array"
+        end
+
+        { "Claude Sandbox" => errors }
+      end
+
+      # Apply all Claude Sandbox configuration to the Vagrant config
+      def apply_to!(root_config)
+        # Ensure values are finalized before use
+        finalize!
+
+        # Set the box
+        root_config.vm.box = @box
+
+        # Configure synced folder for workspace
+        root_config.vm.synced_folder ".", @workspace_path,
+          create: true,
+          owner: "vagrant",
+          group: "vagrant"
+
+        # Copy Claude config if it exists (using file provisioner to fix plugin paths)
+        if File.directory?(@claude_config_path)
+          root_config.vm.provision "file",
+            source: @claude_config_path,
+            destination: "/tmp/claude-config"
+        end
+
+        # Configure provider (VirtualBox)
+        root_config.vm.provider "virtualbox" do |vb|
+          vb.memory = @memory
+          vb.cpus = @cpus
+          vb.customize ["modifyvm", :id, "--audio", "none"]
+          vb.customize ["modifyvm", :id, "--usb", "off"]
+        end
+
+        # Provision the VM
+        unless @skip_claude_cli_install
+          root_config.vm.provision "shell",
+            inline: generate_provision_script,
+            env: {"HOST_CLAUDE_PATH" => @claude_config_path}
+        end
+
+        # Configure SSH to auto-cd to workspace
+        root_config.ssh.extra_args = ["-t", "cd #{@workspace_path}; bash --login"]
+      end
+
+      private
+
+      def generate_provision_script
+        additional_packages = @additional_packages.join(" ")
+
+        script = <<-SHELL
+          set -e
+
+          echo "Updating package lists..."
+          apt-get update
+
+          echo "Installing base packages..."
+          apt-get install -y \
+            apt-transport-https \
+            ca-certificates \
+            curl \
+            gnupg \
+            lsb-release \
+            git \
+            unzip \
+            #{additional_packages}
+
+          # Install Docker
+          if ! command -v docker &> /dev/null; then
+            echo "Installing Docker..."
+            curl -fsSL https://get.docker.com -o get-docker.sh
+            sh get-docker.sh
+            usermod -aG docker vagrant
+            rm get-docker.sh
+          else
+            echo "Docker already installed"
+          fi
+
+          # Install Node.js and npm
+          if ! command -v node &> /dev/null; then
+            echo "Installing Node.js..."
+            curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
+            apt-get install -y nodejs
+          else
+            echo "Node.js already installed"
+          fi
+
+          # Install Claude Code CLI
+          if ! command -v claude &> /dev/null; then
+            echo "Installing Claude Code CLI..."
+            npm install -g @anthropic-ai/claude-code --no-audit
+          else
+            echo "Claude Code CLI already installed"
+          fi
+
+          # Move Claude configuration from /tmp and fix plugin paths
+          if [ -d "/tmp/claude-config" ]; then
+            echo "Setting up Claude configuration with plugins and skills..."
+            rm -rf /home/vagrant/.claude
+            mv /tmp/claude-config /home/vagrant/.claude
+
+            # Fix absolute paths in plugin configuration files to point to VM paths
+            if [ -f "/home/vagrant/.claude/plugins/installed_plugins.json" ]; then
+              sed -i "s|${HOST_CLAUDE_PATH}|/home/vagrant/.claude|g" /home/vagrant/.claude/plugins/installed_plugins.json
+            fi
+            if [ -f "/home/vagrant/.claude/plugins/known_marketplaces.json" ]; then
+              sed -i "s|${HOST_CLAUDE_PATH}|/home/vagrant/.claude|g" /home/vagrant/.claude/plugins/known_marketplaces.json
+            fi
+
+            chown -R vagrant:vagrant /home/vagrant/.claude
+            echo "Claude plugins and skills loaded successfully!"
+          fi
+
+          # Create claude-yolo wrapper
+          echo "Creating claude-yolo command..."
+          cat > /usr/local/bin/claude-yolo << 'EOF'
+#!/bin/bash
+claude --dangerously-skip-permissions "$@"
+EOF
+          chmod +x /usr/local/bin/claude-yolo
+
+          echo "Claude sandbox environment setup complete!"
+          echo "You can now run 'claude-yolo' to start Claude Code with permissions disabled"
+        SHELL
+
+        script
+      end
+    end
+  end
+end

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

@@ -0,0 +1,13 @@
+module VagrantPlugins
+  module ClaudeSandbox
+    class Plugin < Vagrant.plugin("2")
+      name "Claude Sandbox"
+      description "Provides a pre-configured sandbox environment for running Claude Code in an isolated VM"
+
+      config "claude_sandbox" do
+        require_relative "config"
+        Config
+      end
+    end
+  end
+end

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

@@ -0,0 +1,5 @@
+module VagrantPlugins
+  module ClaudeSandbox
+    VERSION = "0.1.0"
+  end
+end

data/lib/vagrant-claude-sandbox.rb

@@ -0,0 +1,11 @@
+require "vagrant-claude-sandbox/version"
+require "vagrant-claude-sandbox/plugin"
+
+module VagrantPlugins
+  module ClaudeSandbox
+    # This returns the path to the source of this plugin.
+    def self.source_root
+      @source_root ||= Pathname.new(File.expand_path("../../", __FILE__))
+    end
+  end
+end

metadata

@@ -0,0 +1,79 @@
+--- !ruby/object:Gem::Specification
+name: vagrant-claude-sandbox
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Bero
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-01-22 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: Provides a pre-configured sandbox environment for running Claude Code
+  in an isolated VM with full plugin and skills support
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/vagrant-claude-sandbox.rb
+- lib/vagrant-claude-sandbox/config.rb
+- lib/vagrant-claude-sandbox/plugin.rb
+- lib/vagrant-claude-sandbox/version.rb
+homepage: https://github.com/bgrgicak/vagrant-claude-sandbox
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/bgrgicak/vagrant-claude-sandbox
+  bug_tracker_uri: https://github.com/bgrgicak/vagrant-claude-sandbox/issues
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.6.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Vagrant plugin for Claude Code sandbox environment
+test_files: []