feat: add a cli task

Author: paolomainardi

.claude/agents/swift-macos-engineer.md

@@ -7,6 +7,8 @@ color: purple
 
 You are an elite Swift macOS software engineer with 10+ years of experience building production macOS applications. You possess deep expertise in Swift, SwiftUI, AppKit, Cocoa frameworks, and macOS system integration.
 
+Before writing code, **ALWAYS** propose a plan and ask for confirmation, you are not allowed to write code without a plan. Do not propose plan in weekly or monthly format, just propose a plan for the next task.
+
 Your core competencies include:
 
 - Modern Swift patterns, protocols, generics, and async/await

.github/copilot-instructions.md

@@ -71,6 +71,50 @@ All shell scripts must follow these patterns:
 - Use `${variable}` syntax with braces (never `$variable`)
 - Use `local` for function variables to avoid namespace pollution
 - Pass `shellcheck` validation before committing
+- When implementing commands, when things exist, do not use `else` branches unless necessary, for example:
+
+Prefer to do this:
+
+```bash
+#!/usr/bin/env bash
+if ! tart list | grep -q "sparkdock-test"; then
+    tart clone {{IMAGE}} sparkdock-test
+    echo "✅ VM 'sparkdock-test' created successfully"
+fi
+```
+Instead of this:
+
+Do not do this:
+
+```bash
+#!/usr/bin/env bash
+ if ! tart list | grep -q "sparkdock-test"; then
+        tart clone {{IMAGE}} sparkdock-test
+        echo "✅ VM 'sparkdock-test' created successfully"
+    else
+        echo "VM 'sparkdock-test' already exists"
+    fi
+````
+
+Instead of this:
+
+```bash
+    if ! command -v cirrus >/dev/null 2>&1; then
+        echo "Installing Cirrus CLI via Homebrew..."
+        brew install cirruslabs/cli/cirrus
+    else
+        echo "Cirrus CLI is already installed"
+    fi
+```
+
+Do this:
+
+```bash
+    if ! command -v cirrus >/dev/null 2>&1; then
+        echo "Installing Cirrus CLI via Homebrew..."
+        brew install cirruslabs/cli/cirrus
+    fi
+```
 
 **Critical: No Trailing Whitespace**
 

.github/prompts/swift-macos-engineer.prompt.md

@@ -35,8 +35,6 @@ description: "Elite Swift macOS engineer with access to latest Swift documentati
 
 You are an elite Swift macOS software engineer. For comprehensive expertise and guidelines, reference: #file:../../.claude/agents/swift-macos-engineer.md
 
-Before writing code, **ALWAYS** propose a plan and ask for confirmation, you are not allowed to write code without a plan. Do not propose plan in weekly or monthly format, just propose a plan for the next task.
-
 ## VS Code-Specific Enhancements
 
 ### Context7 Integration

Justfile

@@ -1,3 +1,6 @@
+_default:
+    @just --list
+
 run-ansible-macos TAGS="all":
     #!/usr/bin/env bash
     TAGS={{TAGS}}
@@ -6,3 +9,47 @@ run-ansible-macos TAGS="all":
     else
         ansible-playbook ./ansible/macos.yml -i ./ansible/inventory.ini --ask-become-pass --tags=${TAGS} -v
     fi
+
+# Create macOS VM with Tart (installs Tart if needed)
+# Available VM images: https://tart.run/quick-start/#vm-images
+tart-create-vm IMAGE="ghcr.io/cirruslabs/macos-sequoia-base:latest":
+    #!/usr/bin/env bash
+    if ! command -v tart >/dev/null 2>&1; then
+        echo "Installing Tart via Homebrew..."
+        brew install cirruslabs/cli/tart
+    fi
+    echo "Creating macOS VM with Tart using image: {{IMAGE}}..."
+    if ! tart list | grep -q "sparkdock-test"; then
+        tart clone {{IMAGE}} sparkdock-test
+        echo "✅ VM 'sparkdock-test' created successfully"
+    fi
+
+# Start VM and connect via SSH
+tart-ssh: tart-create-vm
+    #!/usr/bin/env bash
+    echo "Starting VM and connecting via SSH..."
+    echo "Note: This will start the VM in the background and connect via SSH"
+    echo "VM credentials: admin/admin"
+    echo "Sparkdock source will be mounted at /opt/sparkdock-src"
+    tart run  --dir=sparkdock-src:$PWD sparkdock-test &
+    echo "Waiting for VM to boot..."
+    sleep 30
+    VM_IP=$(tart ip sparkdock-test 2>/dev/null || echo "")
+    if [ -n "$VM_IP" ]; then
+        echo "Connecting to VM at $VM_IP..."
+        ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null admin@$VM_IP
+    else
+        echo "❌ Could not get VM IP address. Make sure the VM is running."
+        echo "You can manually check with: tart list"
+        exit 1
+    fi
+
+# Run end-to-end sparkdock test using Cirrus CLI
+test-e2e-with-cirrus:
+    #!/usr/bin/env bash
+    if ! command -v cirrus >/dev/null 2>&1; then
+        echo "Installing Cirrus CLI via Homebrew..."
+        brew install cirruslabs/cli/cirrus
+    fi
+    echo "Running sparkdock end-to-end test with Cirrus CLI..."
+    cirrus run --output simple

ansible/macos/macos/base.yml

@@ -395,6 +395,15 @@
           become: yes
           become_method: sudo
 
+        - name: Verify menu bar app works
+          command: /usr/local/bin/sparkdock-manager --status
+          register: sparkdock_status
+          changed_when: false
+
+        - name: Display menu bar app status
+          debug:
+            msg: "{{ sparkdock_status.stdout_lines }}"
+
         - name: Check CI environment
           debug:
             msg:

src/menubar-app/Sources/SparkdockManager/main.swift

@@ -463,8 +463,49 @@ class SparkdockMenubarApp: NSObject, NSApplicationDelegate {
     }
 }
 
+// MARK: - CLI Handling
+private func handleCLIArguments() -> Bool {
+    let arguments = CommandLine.arguments
+
+    if arguments.contains("--help") || arguments.contains("-h") {
+        print("""
+        Sparkdock Manager - macOS menu bar application for development environment management
+
+        Usage: sparkdock-manager [options]
+
+        Options:
+          --help, -h       Show this help message
+          --status         Show application status
+
+        When run without arguments, launches as a menu bar application.
+        """)
+        return true
+    }
+
+    if arguments.contains("--status") {
+        print("Sparkdock Manager - Status: OK")
+        print("Executable path: /opt/sparkdock/bin/sparkdock.macos")
+        print("Config file: Sources/SparkdockManager/Resources/menu.json")
+
+        // Check if sparkdock executable exists
+        if FileManager.default.fileExists(atPath: AppConstants.sparkdockExecutablePath) {
+            print("Sparkdock executable: ✅ Found")
+        } else {
+            print("Sparkdock executable: ❌ Not found")
+        }
+
+        return true
+    }
+
+    return false
+}
+
 // MARK: - Main Entry Point
+if handleCLIArguments() {
+    exit(0)
+}
+
 let app = NSApplication.shared
 let delegate = SparkdockMenubarApp()
 app.delegate = delegate
-app.run()
+app.run()