public_git
/
tart-guest-agent
mirror of https://github.com/cirruslabs/tart-guest-agent.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
Guest agent for Tart VMs
42 Commits 6 Branches 14 Tags 302 KiB
Go 96.7%
Shell 3.3%
Go to file
Fedor Korotkov a1ac589a72 Migrate CI to GitHub Actions 2026-06-03 14:02:20 -07:00
.github Migrate CI to GitHub Actions 2026-06-03 14:02:20 -07:00
cmd Automatically install and start a systemd service (#21) 2025-08-04 16:33:59 +04:00
internal Add more options to `exec` (#47) 2026-05-04 15:36:20 -04:00
packaging Automatically install and start a systemd service (#21) 2025-08-04 16:33:59 +04:00
proto/rpc Add more options to `exec` (#47) 2026-05-04 15:36:20 -04:00
.gitignore Build universal binary instead of architecture dependent (#7) 2025-05-12 23:42:45 +04:00
.golangci.yml Automatic disk resizing for macOS VMs (#1) 2025-04-07 22:54:19 +04:00
.goreleaser.yml Automatically install and start a systemd service (#21) 2025-08-04 16:33:59 +04:00
LICENSE Add LICENSE and publish to our tap (#2) 2025-04-07 23:41:27 +04:00
README.md RPC: introduce ResolveIP() method to support "tart ip --resolver=agent" (#14) 2025-06-19 13:06:26 +04:00
buf.gen.yaml "tart exec" support (--run-rpc) and component groups (e.g. --run-daemon) (#10) 2025-05-19 18:53:16 +04:00
buf.yaml "tart exec" support (--run-rpc) and component groups (e.g. --run-daemon) (#10) 2025-05-19 18:53:16 +04:00
go.mod Bump the all-updates group across 1 directory with 5 updates (#46) 2026-05-12 22:27:32 +02:00
go.sum Bump the all-updates group across 1 directory with 5 updates (#46) 2026-05-12 22:27:32 +02:00

README.md

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)
  • Clipboard sharing for macOS VMs using our in-house SPICE vdagent implementation (--run-vdagent)
  • 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: