Skip to content

Comments

feat: add UTM plugin for virtual machine management#17

Draft
luke wants to merge 1 commit intomainfrom
agent-plugin-utm-main
Draft

feat: add UTM plugin for virtual machine management#17
luke wants to merge 1 commit intomainfrom
agent-plugin-utm-main

Conversation

@luke
Copy link
Contributor

@luke luke commented Jul 9, 2025

Summary

  • Adds a new plugin for managing UTM virtual machines on macOS
  • Integrates with utmctl CLI to control VMs
  • Provides a clean UI for VM management

Features

UTM Installation Detection

  • Checks for UTM.app and utmctl CLI
  • Shows installation guide if not found
  • Displays version information

VM Management

  • List all virtual machines with status
  • Start, stop, and suspend operations
  • Shows VM architecture and backend type (QEMU/Apple)

TypeScript API

  • Full type definitions for all operations
  • Clean async/await interface
  • Comprehensive error handling

Professional UI

  • Follows Agent54 design system
  • Responsive VM cards with status indicators
  • Smooth loading and error states

Technical Details

  • Uses Tauri's shell plugin to execute utmctl commands
  • Supports multiple UTM installation paths
  • Generic type parameters for Tauri runtime compatibility
  • Includes comprehensive test scripts

Testing

The plugin includes test scripts in test-scripts/ that can be run from the dev console:

const tests = await import('@agent54/plugin-utm/test-scripts/test-utm.js')
await tests.default.runAllTests()

Phase 2 Features (Future)

  • VM creation wizard
  • Live screenshots
  • Resource monitoring
  • USB passthrough
  • Snapshot management

🤖 Generated with Claude Code

Implements a comprehensive UTM (Universal Turing Machine) plugin that enables
management of virtual machines on macOS through the utmctl CLI interface.

Key features:
- Detect UTM installation and version
- List all virtual machines with their states
- Start, stop, and suspend VM operations
- TypeScript API with full type definitions
- Professional UI with installation guidance
- Support for both QEMU and Apple Virtualization backends

The plugin includes comprehensive error handling, test scripts, and follows
the project's plugin architecture patterns.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant