openai/tart-guest-agent

openai/tart-guest-agent

Description: Guest agent for Tart VMs

Language: Go

License: NOASSERTION

Stars: 22

Forks: 6

Open issues: 4

Created: 2025-04-07T13:20:23Z

Pushed: 2026-06-09T10:43:42Z

Default branch: main

Fork: no

Archived: no

README:

Guest agent for Tart VMs

A guest agent for Tart VMS is a lightweight background service that runs inside the virtual machine and enables enhanced communication between the host and guest and other useful features, such as automatic disk resizing.

Currently implemented features:

• Automatic disk resizing for macOS VMs with recovery partition removed (--resize-disk)
• needs to be invoked as a launchd global daemon
• Clipboard sharing for macOS VMs using our in-house SPICE vdagent implementation (--run-vdagent)
• needs to be invoked as a launchd global agent
• tart exec support (--run-rpc)
• it's recommended to invoke it as a launchd global agent because fewer privileges will be available to commands started via tart exec
• however, you can also invoke it as a launchd global daemon if running commands started via tart exec as root is desired
• tart ip --resolver=agent support (--run-rpc)
• allows resolving VM's IP address without relying on DHCP leases and/or an ARP table

To run all features appropriate for a given context, use component groups:

• --run-daemon
• implies --resize-disk
• example usage: `tart-guest-daemon.plist`
• --run-agent
• implies --run-vdagent --run-rpc
• example usage: `tart-guest-agent.plist`