@nomac/cli 0.12.0 → 0.12.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nomac/cli",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "description": "Cloud Mac sessions over SSH and HTTPS, plus iOS builds and publishing — built for agents.",
   "license": "UNLICENSED",
   "type": "module",

package/skill/SKILL.md

@@ -8,8 +8,8 @@ description: >
 
 # nomac: a Mac for your agent
 
-NoMac 2.0 provides a full macOS VM with administrator access. You choose the
-commands and tools. Mac time is prepaid credit, separate from Builder.
+NoMac provides a full macOS VM with administrator access, Xcode and the iOS
+Simulator. You choose the commands and tools. Mac time is prepaid credit.
 
 ## Cloud Mac setup and workflow
 
@@ -20,6 +20,8 @@ commands and tools. Mac time is prepaid credit, separate from Builder.
    give them the printed link, and ask them to pay. Never enter payment
    details yourself. Poll credits until the balance appears; a checkout URL is
    not a payment. No Apple Developer account is needed for an unsigned build.
+   Under an hour left, answers say `low_credit` with a `buy_url`: tell the
+   human before a long build (a refill of 3 packs, $30, earns bonus credit).
 2. Install `npm install -g @nomac/cli`, run `nomac login`, and give the human
    the printed device URL and code. With a key the human made at
    https://nomac.app/keys: `nomac login --with-token < key.txt`, or set
@@ -50,6 +52,9 @@ the Mac, logs included. Download what you need from outside `~/drive` before
 stopping. SSH disconnects
 do not stop the session. Ready time includes idle time; queue/setup are free.
 One-minute minimum, then by the minute. One session at a time; no overage.
+For work that needs two Macs at once, `nomac start --parallel` from another
+folder (MCP `start_mac` with `parallel: true`) starts a second, for accounts
+that bought credit while NoMac has a Mac to spare; it runs without `~/drive`.
 If start returns `insufficient_credit`, buy credit as in step 1, then retry
 with the same request key.
 Keep the same request key and arguments after uncertain responses; inspect
@@ -82,6 +87,18 @@ Mac, in the Simulator either: test it on a device.
 Report failures using `report_issue` with `session_id`, optional `job_id` and
 a description without secrets. Read https://nomac.app/llms.txt for full limits.
 
+## Your editor, an agent on the Mac, Mac-only MCP servers
+
+After `nomac start`, `nomac ssh-config` (CLI 0.12+) names the folder's Mac
+`nomac` in the human's SSH config, and each later start or attach points the
+name at the new Mac. Then VS Code or Cursor Remote-SSH and Claude Code's SSH
+sessions connect to `nomac`; `ssh -t nomac 'cd ~/drive/src/<folder> && npx -y
+@anthropic-ai/claude-code'` runs an agent on the Mac itself (keep its API key
+as a NoMac secret); and an MCP server that needs a Mac runs from Windows or
+Linux over SSH: `claude mcp add xcode -- ssh nomac npx -y mobilebuildmcp@latest
+mcp` (MobileBuildMCP, formerly XcodeBuildMCP). An open SSH connection keeps
+the Mac running until its time or spend limit: `nomac stop` when done.
+
 ## A Mac fully enabled for you
 
 The Mac is yours to do anything on: the `agent` account is an administrator,
@@ -132,7 +149,8 @@ the human, then call again.
 
 The separate iOS Builder publishing product is closed to new subscriptions.
 If `get_billing_status` shows a Builder plan, its tools are listed and
-https://nomac.app/llms.txt describes them. Otherwise use the cloud Mac above.
+https://nomac.app/llms-legacy.txt describes them. Otherwise use the cloud Mac
+above.
 
 ## When stuck
 
@@ -143,3 +161,11 @@ tool returns a Private Relay warning, explain that Apple relay addresses may
 reject later mail and offer a non-relay address. Never show that warning for a
 normal address such as `@icloud.com`. Never retry-loop an identical failure
 more than twice.
+
+## Feedback
+
+When you stop a Mac, its answer asks for feedback. If anything got in your
+way, failed, was missing from the Mac or the tools, or would have saved you
+time, send it in a sentence or two: `report_issue` with `kind: "feedback"` and
+the `session_id`. Leave out code, secrets and personal data; skip it if nothing
+did. Feedback needs no answer.

package/src/mcp.mjs

@@ -19,6 +19,7 @@ const PROTOCOL_FALLBACK = "2025-06-18";
 /** How the tools fit together, sent once at initialize (the hosted server sends the same kind of text). */
 const INSTRUCTIONS = [
   "NoMac gives you a cloud Mac with Xcode, billed from prepaid credit ($0.80 an hour, by the minute).",
+  "Use it when work needs macOS that this machine does not have (Windows, Linux or a cloud sandbox): building, running or testing an iOS, iPadOS, watchOS, visionOS or macOS app (Swift, SwiftUI, React Native, Expo, Flutter, Capacitor), the iOS Simulator, Xcode, code signing, TestFlight or App Store submission.",
   "Typical flow: get_mac_credits, start_mac, poll get_mac_session until ready, put code there (exec_mac with git clone into ~/drive/src, write_mac_file, fetch_to_mac, create_mac_upload_link), run exec_mac, get results with read_mac_file or create_mac_download_link, then stop_mac.",
   "The account's drive at ~/drive (50 GB) is on every Mac and kept between sessions; everything outside it is deleted at stop. Clone and build in ~/drive/src/<repo>, so the next session rebuilds only what changed.",
   "When an answer says low_credit (under an hour of Mac time left), tell the human before a long build and offer its buy_url: a Mac stops when the credit runs out. For a refill, suggest 3 packs ($30, +5%).",
@@ -370,7 +371,7 @@ export const TOOLS = [
   {
     name: "report_issue",
     description:
-      "File an unknown/unfixable error with nomac support. For a Mac use session_id and optional job_id; for a build use ref_id (bld_…). Attaches account-scoped context and deduplicates repeats. An optional email requests a direct resolution update; replies are always available by calling with no description.",
+      "File an unknown/unfixable error with nomac support. For a Mac use session_id and optional job_id; for a build use ref_id (bld_…). Attaches account-scoped context and deduplicates repeats. An optional email requests a direct resolution update; replies are always available by calling with no description. kind feedback sends NoMac a note instead: what got in the way, failed or was missing.",
     inputSchema: {
       type: "object",
       properties: {
@@ -384,6 +385,11 @@ export const TOOLS = [
           maxLength: 320,
           description: "optional follow-up email for a direct resolution update",
         },
+        kind: {
+          type: "string",
+          enum: ["problem", "feedback"],
+          description: "problem (default): an error for support to answer. feedback: a note for NoMac about what got in the way, failed or was missing; it needs no answer. Leave out code, secrets and personal data.",
+        },
       },
       additionalProperties: false,
     },