manzanas: Skill for Claude Code

Lease and drive a simulator

Talk to the daemon over HTTP (default port :7433). Every mutating op needs an active lease; the lease ID is the capability token — never share it.

1. Find a target and acquire a lease

D=http://<mac-tailnet-ip>:7433
curl -s $D/v0/healthz                     # {"ok":true,"version":"v0"}
curl -s $D/v0/targets | jq '.targets[] | {udid,name,state,labels}'

Acquire by label (preferred — pins reset policy to a device class, not someone else's sim). reset:"erase" guarantees the NEXT holder gets a clean target:

L=$(curl -s -X POST $D/v0/leases -d '{
  "labels":["iphone-air"], "agent_id":"<caller-identity>",
  "purpose":"<task>", "ttl_seconds":900, "reset":"erase"}')
LID=$(echo "$L" | jq -r .id); UDID=$(echo "$L" | jq -r .target_udid)

agent_id is the canonical caller-identity field (a session ID is a fine value for it); the API also accepts session_id as an alias that fills agent_id when it is empty. Omitting both is 400 bad_request.

• 201 + state:"active" → proceed. 202 + state:"queued" → poll GET /v0/leases/$LID until active (polling keeps your queue slot; queued leases that go unpolled for 30 min are dropped).
• 409 no_match → no target carries those labels; re-check /v0/targets.
• Renew at ~half TTL for long tasks: POST /v0/leases/$LID/renew.
• Interop: other (non-manzanasd) agents coordinate via /tmp/manzanas_locks/ file locks on the Mac — also write sim-<udid> there for the lease's duration and remove it when done.

2. Boot (asynchronous, gated)

curl -s -X POST $D/v0/targets/$UDID/boot -d "{\"lease_id\":\"$LID\"}"   # 202
# poll until Booted:
curl -s $D/v0/targets | jq -r ".targets[] | select(.udid==\"$UDID\").state"

503 {"code":"overloaded"} means a host safety gate refused the boot (running sim cap, load > 2x cores, or <5 GiB free disk) — back off and retry, or use another host. Do NOT bypass with raw simctl boot.

3. Act — prefer composite + batch (fewer round trips)