vm

JUCE Dev VM Management

Configure and manage SSH-accessible VMs for cross-platform build testing.

Usage

/juce-dev:vm add <name> <ssh-alias> <platform>    # Add a VM
/juce-dev:vm remove <name>                          # Remove a VM
/juce-dev:vm list                                   # List all VMs
/juce-dev:vm test [name]                            # Test VM connectivity

Arguments

• add <name> <ssh-alias> <platform>: Register a new VM
  • name: Friendly name (e.g., "win11", "ubuntu24", "win10-arm64")
  • ssh-alias: SSH config alias (e.g., "win" for ssh win)
  • platform: One of windows, linux, macos
• remove <name>: Remove a registered VM
• list: Show all registered VMs and their status
• test [name]: Test SSH connectivity (all VMs if no name given)

Examples

/juce-dev:vm add win11 win windows
/juce-dev:vm add ubuntu24 linux linux
/juce-dev:vm add win10-arm win-arm windows
/juce-dev:vm list
/juce-dev:vm test win11
/juce-dev:vm remove ubuntu24

Implementation

Storage

VM configs are stored in .claude/juce-dev.local.md in the project root.

YAML frontmatter format:

---
vms:
  win11:
    ssh: win
    platform: windows
    project_path: C:\Users\daniel\Code\JUCE-Plugin-Starter
    shell: powershell
  ubuntu24:
    ssh: linux
    platform: linux
    project_path: /home/daniel/Code/JUCE-Plugin-Starter
    shell: bash
---

Action: add

1. Parse $ARGUMENTS for name, ssh-alias, platform.
2. If any are missing, use AskUserQuestion:

   question: "What SSH alias connects to this VM? (e.g., 'win' if you use 'ssh win')"
   header: "SSH Alias"
   

3. Verify SSH connectivity:

   ssh -o ConnectTimeout=5 <ssh-alias> "echo connected" 2>&1
   

4. If connected, detect the remote home/project directory:

   # Windows
   ssh <ssh-alias> "echo %USERPROFILE%"
   # Linux/macOS
   ssh <ssh-alias> "echo $HOME"
   

5. Ask where the project should live on the VM:

   question: "Where should projects live on this VM?"
   header: "Project Path"
   options:
     - label: "{detected_home}/Code"
       description: "Standard location"
     - label: "Other"
       description: "Specify a custom path"
   

6. Write/update .claude/juce-dev.local.md with the new VM entry.
7. Confirm:

   VM 'win11' added:
   - SSH: ssh win
   - Platform: windows
   - Project path: C:\Users\daniel\Code
   - Shell: powershell