[gwdp]

Why

Give macOS VM images a small, reusable way to run startup scripts.

How

Add @expo/vm-tools. Its installer writes a per-user launchd agent and a standalone runner. At login, including automatic login when Tart runs with --no-graphics, the agent waits for /usr/local/share/vm-tools/startup.sh and runs it with Bash once per boot. Installation itself does not run the script.

The script owns its environment, processes and cleanup. The runner waits for it, returns its exit status and does not retry failed runs. Output goes to ~/Library/Logs/vm-tools.log.

Test Plan

Eight package tests, typecheck, lint and formatting pass. Recent local VM trials exercised startup with this version; hosted worker validation is separate.

LLM authorship

Codex and Claude Code wrote and revised the code and tests through multiple planning and review rounds with Gabe. We considered different startup arrangements, then kept vm-tools focused on loading the script and left service ownership to the script. Gabe directed the changes and reviewed the implementation and wording.

— Codex

[codecov]

Codecov Report

❌ Patch coverage is 94.20290% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 75.62%. Comparing base (82845de) to head (2aea4e4).

Files with missing lines	Patch %	Lines
packages/vm-tools/src/commands/daemon.ts	91.84%	4 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4725      +/-   ##
==========================================
+ Coverage   75.59%   75.62%   +0.03%     
==========================================
  Files        1055     1058       +3     
  Lines       52469    52538      +69     
  Branches    11471    11478       +7     
==========================================
+ Hits        39660    39725      +65     
- Misses      11829    11833       +4     
  Partials      980      980              

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

✅ Thank you for adding a changeset!