Lima
One dedicated Linux VM on a Mac, owned and driven through Lima. Renders the whole configuration from pinned inputs instead of inheriting Lima's default template, so the guest gets no host home, no agent or X11 forwarding, no host keys, no proxy environment, and no port that was not listed. Ownership is a marker this model wrote; a VM that merely shares the name is left alone. Drift is reported as replacement-required and never repaired in place, a failed create deletes nothing, and destroy is a separate door that wants the exact name, a stopped VM, and a preservation decision.
Bound owned limactl timeout/cancellation cleanup: SIGTERM, SIGKILL after 250 ms when needed, cancelled output readers, and child exit before mutation-lock release. Preserve the caller cancellation reason. Retain macOS/architecture, ownership, path and drift guards. This does not roll back VM activity or stop detached descendants; inspect before retrying interrupted mutations. Includes runtime-major Zod alignment and corrected public docs.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| name | string | Lima instance name; also the ownership key |
| limaHome | string | Dedicated LIMA_HOME for this instance; never the default ~/.lima |
| limactlPath? | string | |
| limaVersion | string | Exact approved limactl version, e.g. 2.2.0 |
| arch? | enum | |
| vmType? | literal | v1 supports the Virtualization.framework backend only |
| cpus | number | |
| memory | string | |
| disk | string | |
| mounts? | array | |
| portForwards? | array | |
| provision? | array | Reviewed credential-free provisioning scripts; full bodies persist in config artifacts |
| sshLocalPort? | number | |
| startTimeoutSec? | number | |
| commandTimeoutSec? | number | |
| lockStaleSec? | number | Deprecated compatibility input; lock age never permits takeover. OS locks release on process exit. |
| Argument | Type | Description |
|---|---|---|
| configHash | string | The plan's configHash, as reviewed |
| Argument | Type | Description |
|---|---|---|
| confirmName | string | Must equal the instance name |
| preservation | enum | Why deleting the disk is acceptable |
| backupRef? | string | Where the verified backup lives; required with backup-verified |
Resources
Files
First public release from preserved Lima work. Hardened VM ownership and isolation, current Swamp schema/identity compatibility, real Lima 2.3.0 inspect and configuration validation. 39 offline tests pass. Guest creation/start/stop/destruction have not been exercised live.
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Docs keep secrets in a vault1/1earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License2/2earned
- Verified public repository2/2earned