Guest agent for Tart VMs
Go to file
dependabot[bot] f514d06201
Bump the all-updates group with 5 updates (#19)
Bumps the all-updates group with 5 updates:

| Package | From | To |
| --- | --- | --- |
| [github.com/samber/lo](https://github.com/samber/lo) | `1.49.1` | `1.51.0` |
| [golang.design/x/clipboard](https://github.com/golang-design/clipboard) | `0.7.0` | `0.7.1` |
| [golang.org/x/sync](https://github.com/golang/sync) | `0.12.0` | `0.15.0` |
| [golang.org/x/sys](https://github.com/golang/sys) | `0.32.0` | `0.33.0` |
| [google.golang.org/grpc](https://github.com/grpc/grpc-go) | `1.72.1` | `1.74.2` |


Updates `github.com/samber/lo` from 1.49.1 to 1.51.0
- [Release notes](https://github.com/samber/lo/releases)
- [Commits](https://github.com/samber/lo/compare/v1.49.1...v1.51.0)

Updates `golang.design/x/clipboard` from 0.7.0 to 0.7.1
- [Release notes](https://github.com/golang-design/clipboard/releases)
- [Commits](https://github.com/golang-design/clipboard/compare/v0.7.0...v0.7.1)

Updates `golang.org/x/sync` from 0.12.0 to 0.15.0
- [Commits](https://github.com/golang/sync/compare/v0.12.0...v0.15.0)

Updates `golang.org/x/sys` from 0.32.0 to 0.33.0
- [Commits](https://github.com/golang/sys/compare/v0.32.0...v0.33.0)

Updates `google.golang.org/grpc` from 1.72.1 to 1.74.2
- [Release notes](https://github.com/grpc/grpc-go/releases)
- [Commits](https://github.com/grpc/grpc-go/compare/v1.72.1...v1.74.2)

---
updated-dependencies:
- dependency-name: github.com/samber/lo
  dependency-version: 1.51.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: all-updates
- dependency-name: golang.design/x/clipboard
  dependency-version: 0.7.1
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: all-updates
- dependency-name: golang.org/x/sync
  dependency-version: 0.15.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: all-updates
- dependency-name: golang.org/x/sys
  dependency-version: 0.33.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: all-updates
- dependency-name: google.golang.org/grpc
  dependency-version: 1.74.2
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: all-updates
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2025-07-23 17:06:32 +04:00
.github Enable weekly Dependabot updates for "gomod" ecosystem (#18) 2025-07-23 17:02:46 +04:00
cmd Automatic disk resizing for macOS VMs (#1) 2025-04-07 22:54:19 +04:00
internal tart-guest-agent --run-agent: make errors non-fatal (#15) 2025-06-19 19:12:30 +04:00
proto/rpc RPC: introduce ResolveIP() method to support "tart ip --resolver=agent" (#14) 2025-06-19 13:06:26 +04:00
.cirrus.yml RPC: introduce ResolveIP() method to support "tart ip --resolver=agent" (#14) 2025-06-19 13:06:26 +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 Build universal binary instead of architecture dependent (#7) 2025-05-12 23:42:45 +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 with 5 updates (#19) 2025-07-23 17:06:32 +04:00
go.sum Bump the all-updates group with 5 updates (#19) 2025-07-23 17:06:32 +04: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: