Repository navigation
Add experimental macOS guest backend with Linux as default - #45
Merged
Merged
Conversation
Run CodeRunner inside a Tart-managed macOS guest with private credentials, a localhost SSH tunnel, persistent storage, and optional host-only networking. Keep the existing Linux installer path intact. Validated on an M1 Pro with macOS 15.7.7 guest: REST and MCP execution, Chromium, authentication, session state, reboot persistence, and offline networking.
mkagenius
marked this pull request as ready for review
November 20, 2026 20:27
abhishek-anand
approved these changes
Nov 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
CodeRunner currently runs Linux guests through Apple's container CLI. This adds an experimental macOS guest backend using Tart and Apple Virtualization.framework, serving the existing REST and MCP APIs from inside the guest.
Linux remains the default. macOS is explicitly selected with
./install.sh --guest macos; no separate primary CLI is introduced.Changes
Validation
Tested locally on an Apple M1 Pro with macOS 27.2, running a macOS 15.7.7 arm64 guest with 2 CPUs and 4 GiB RAM.
kern.hv_vmm_present=1, confirming execution inside the VM.Limits
This is a local development pilot with an external Tart dependency, not a hardened multitenant service. The guest runtime does not include every Linux image package or Linux-specific utility. Clipboard sharing is disabled, and the generated desktop login password currently needs manual entry. See
macos/README.mdfor the full setup and boundaries.