@agent-native/core 0.122.3 → 0.123.0

package/dist/cli/skills-content/design-visual-edit-skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"design-visual-edit-skill.js","sourceRoot":"","sources":["../../../src/cli/skills-content/design-visual-edit-skill.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmO1C,CAAC","sourcesContent":["export const DESIGN_VISUAL_EDIT_SKILL_MD = `---\nname: visual-edit\ndescription: >-\n  Open a running local app in Design overview mode as URL-backed iframe screens\n  for visual editing, flow review, duplication, and route-state exploration.\n  Use when the user asks to inspect, compare, or edit a real local app visually\n  in Design.\nmetadata:\n  visibility: exported\n---\n\n# Visual Edit\n\nUse \\`/visual-edit\\` when the user wants to inspect or edit a real local app\nvisually instead of generating standalone Alpine HTML. The source of truth is\nthe running localhost app plus its route URLs. Design shows those routes as\niframe-backed screens on the infinite canvas.\n\n## Core Model\n\n- Each screen is a URL-backed iframe, not copied HTML.\n- Each screen keeps URL metadata: \\`connectionId\\`, \\`routeId\\`, \\`path\\`,\n  \\`url\\`, \\`bridgeUrl\\`, title, and viewport size.\n- Start in Design's screen overview mode. In overview, screens are static\n  design frames; full-screen focus is for scrolling and app interaction.\n- Alt-drag duplicates a screen. For localhost screens, duplication copies the\n  iframe frame and URL metadata; change the copy's path/query for a new state.\n- Flow visualization is multiple URL states: \\`/checkout?step=shipping\\`,\n  \\`/checkout?step=payment\\`, \\`/checkout?step=done\\`, etc.\n- When the user gives a named flow or numbered screen list, preserve that order\n  and create one screen per URL/path. Shorthand like\n  \\`localhost:1234/onboarding/1\\` means\n  \\`http://localhost:1234/onboarding/1\\`.\n\n## Review Quality\n\n- Treat the running app as the truth. Preserve its component language, tokens,\n  route state, and real content unless the user explicitly asks for a new visual\n  direction.\n- Use multiple URL states to reveal meaningful UX moments: empty/loading/error\n  states, focused panels, modals, responsive breakpoints, and completed flow\n  steps when those matter to the review.\n- For visual edits, compare before/after at the relevant viewport sizes and\n  check key hover/focus/scroll states when the app exposes them.\n\n## Account And Sharing Model\n\n- The \\`/visual-edit\\` entry route can open before the viewer signs in. Public\n  \\`/design/:id\\` editor links can also render read-only public designs without a\n  session.\n- Prefer links returned by Design actions or \\`/_agent-native/open\\` deep links.\n  Do not surface URLs with \\`_session=\\` tokens. Query sessions are only a\n  fallback after normal cookie resolution, so an existing browser session can\n  still open the design as a different user and show \"Design not found\".\n- Do not attempt anonymous write actions. Bridge registration, design creation,\n  screen placement, generation, saving, and sharing are account-backed. If a\n  signed-out visitor wants to save or share, send them through the framework\n  sign-in return flow, then save or copy the design into that account before\n  opening the share dialog.\n\n## Required Local Bridge\n\nThe live-edit bridge is unlocked by a shared secret (the \"bridge token\") that\nmust match on two sides: the local bridge process, and the user's connection row\nin Design (which the browser reads to authorize \\`/live-edit-bridge\\`,\n\\`/read-file\\`, \\`/write-file\\`). Get them to match by letting the\n**authenticated** \\`open-visual-edit\\` action mint the token, then starting the\nbridge with it. This is the only ordering that works for the remote-MCP flow —\nthe bridge cannot push its own token to the server without a CLI auth token, so\nthe server mints instead and the bridge adopts.\n\nFrom the target app repo, make sure its dev server is running, then:\n\n**1. Discover routes without starting a durable bridge** (one-shot, exits):\n\n\\`\\`\\`bash\nnpx @agent-native/core@latest design connect --url http://localhost:5173 --root . --json\n\\`\\`\\`\n\nThis prints the manifest (routes + capabilities). Parse it to build\n\\`routeManifest\\` for the next step. (Skip this if the user already gave explicit\npaths/URLs to place.)\n\n**2. Call \\`open-visual-edit\\`** (see Action Flow below) with NO \\`bridgeToken\\`.\nThe server mints one, stores it on the user's connection row, copies it into the\nplaced screens' metadata, and returns it to you as \\`bridgeToken\\`. Capture it.\n\n**3. Start the persistent bridge adopting that token** (single line; prefer the\nenv var so the secret does not appear in \\`ps\\`):\n\n\\`\\`\\`bash\nAGENT_NATIVE_BRIDGE_TOKEN=\"<bridgeToken from step 2>\" npx @agent-native/core@latest design connect --url http://localhost:5173 --root . --daemon\n\\`\\`\\`\n\n(Equivalently, pass \\`--bridge-token <token>\\`.) This starts a detached bridge on\n\\`http://127.0.0.1:7331\\`, adopts the server-minted token — so bridge and row\nagree and live-edit authorizes with no self-registration — and stays alive after\nthe command exits.\n\nFor a manual health/manifest check on the running bridge:\n\n\\`\\`\\`bash\ncurl http://127.0.0.1:7331/manifest.json\n\\`\\`\\`\n\nOnly use \\`--json\\` for the step-1 route probe. Never use \\`--json\\`, \\`--once\\`,\nor \\`--dry-run\\` for the durable step-3 bridge: they print the manifest and exit,\nso Design falls back to a non-editable live iframe.\n\n## Action Flow\n\nPrefer the single authenticated \\`open-visual-edit\\` action. It registers or\nrefreshes the localhost bridge connection, mints and stores the bridge token,\ncreates or reuses a Design project, places URL-backed screens, stores the active\nvisual-edit context, and navigates to overview mode in one call. This avoids\ncreating a private design under a synthetic CLI user and then handing the browser\na tokenized URL that may be shadowed by an existing session.\n\nCall it BEFORE starting the durable bridge (step 3 above): it does not contact\nthe bridge, so the bridge need not be running yet, and you need its returned\n\\`bridgeToken\\` to start the bridge with a matching secret. Omit \\`bridgeToken\\`\non the call so the server mints one.\n\n\\`\\`\\`bash\npnpm action open-visual-edit '{\n  \"title\": \"Docs homepage visual edit\",\n  \"devServerUrl\": \"http://localhost:5173\",\n  \"bridgeUrl\": \"http://127.0.0.1:7331\",\n  \"rootPath\": \"/absolute/path/to/app\",\n  \"routeManifest\": { \"...\": \"from /manifest.json\" },\n  \"paths\": [\"/\", \"/pricing\", \"/checkout?step=payment\"]\n}'\n\\`\\`\\`\n\nThe action returns \\`designId\\`, \\`connectionId\\`, \\`bridgeToken\\`, \\`screens\\`,\n\\`urlPath\\`, and \\`openUrl\\`. Keep \\`designId\\`/\\`connectionId\\` in the chat context\nfor follow-ups, and pass \\`bridgeToken\\` to \\`design connect\\` (step 3) to start\nthe bridge. On follow-up calls reusing an existing \\`connectionId\\`, the same\ntoken is returned (it is minted once and reused), so the running bridge stays\nvalid.\n\nFor a numbered flow the user describes in chat, keep the labels and order:\n\n\\`\\`\\`bash\npnpm action open-visual-edit '{\n  \"designId\": \"<existing-design-id>\",\n  \"connectionId\": \"<existing-connection-id>\",\n  \"devServerUrl\": \"http://localhost:1234\",\n  \"routes\": [\n    { \"url\": \"localhost:1234/onboarding/1\", \"title\": \"Screen 1\" },\n    { \"url\": \"localhost:1234/onboarding/2\", \"title\": \"Screen 2\" },\n    { \"url\": \"localhost:1234/onboarding/3\", \"title\": \"Screen 3\" }\n  ]\n}'\n\\`\\`\\`\n\nFor responsive follow-ups, call \\`open-visual-edit\\` again with the same\n\\`designId\\` and \\`connectionId\\`, plus explicit viewport dimensions:\n\n\\`\\`\\`bash\npnpm action open-visual-edit '{\n  \"designId\": \"<existing-design-id>\",\n  \"connectionId\": \"<existing-connection-id>\",\n  \"devServerUrl\": \"http://localhost:5173\",\n  \"paths\": [\"/\"],\n  \"defaultWidth\": 390,\n  \"defaultHeight\": 844,\n  \"startX\": 1600,\n  \"startY\": 0\n}'\n\\`\\`\\`\n\nIf no \\`routes\\` or \\`paths\\` are supplied, \\`open-visual-edit\\` uses every route\nfrom the localhost manifest.\n\nFallback, only when \\`open-visual-edit\\` is unavailable:\n\n1. Register or refresh the bridge with \\`connect-localhost\\`, passing the\n   \\`/manifest.json\\` result as \\`routeManifest\\` and \\`capabilities\\`.\n2. Create or reuse a Design project with \\`create-design\\`.\n3. Place URL-backed screens with \\`add-localhost-screens\\`.\n4. Navigate to overview mode with \\`navigate\\`.\n\n## Open The Design Surface\n\n- Use the \\`link\\`, \\`deepLink\\`, or MCP App embed returned by Design actions so\n  the user sees the canvas. In Codex Desktop or VS Code, prefer opening that\n  Design URL in the available preview/webview panel; otherwise surface the\n  \"Open design\" link.\n- Return or open the \\`openUrl\\` / action link, not a hand-built\n  \\`/design/:id?_session=...\\` URL.\n- If the user is working in VS Code, the Agent Native extension can open the\n  same URL via\n  \\`vscode://builder.agent-native/open?url=<encoded-design-url>\\`. Its\n  \\`Agent Native: Open Design Canvas\\` command also starts the local bridge and\n  opens hosted Design in the VS Code side panel.\n- After \\`add-localhost-screens\\`, confirm the Design editor is in overview mode\n  with the requested URL-backed frames visible. Do not stop at \"screens added\"\n  when the user asked to inspect or edit visually.\n\n## Editing URLs\n\nKeep localhost screens as URL files plus \\`screenMetadata[fileId]\\`. Do not\nreplace them with copied \\`srcdoc\\` HTML unless the user explicitly asks for a\nfrozen snapshot. To change a state, rerun \\`add-localhost-screens\\` with the new\npath/query or duplicate the screen and update the copy's URL metadata.\n\n## React Source Writeback\n\n- Use compiler/debug provenance (project-relative file, line, column,\n  component, and runtime multiplicity) to locate React/TSX source. Treat it as\n  evidence, not as permission for a generic AST structural transform.\n- Reparenting, grouping/ungrouping, wrappers, dynamic expressions, repeated\n  \\`.map()\\` instances, shared components, and cross-file changes go through the\n  coding agent with exact subject/target anchors and their runtime\n  relationship.\n- Before each write, read the file and pass its exact \\`versionHash\\` to\n  \\`write-local-file\\` with \\`requireExpectedVersionHash: true\\`; on conflict,\n  re-read and re-plan. Keep the optimistic preview until HMR/runtime confirms\n  the result. Human write consent remains mandatory and agents cannot grant it.\n\n## Verification\n\n- \\`list-localhost-connections\\` returns the expected connection and routes.\n- The Design editor opens in overview mode.\n- Every requested screen renders the intended localhost URL.\n- Alt-dragging a screen copies the URL-backed frame, not an inline HTML clone.\n`;\n"]}
+{"version":3,"file":"design-visual-edit-skill.js","sourceRoot":"","sources":["../../../src/cli/skills-content/design-visual-edit-skill.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoX1C,CAAC","sourcesContent":["export const DESIGN_VISUAL_EDIT_SKILL_MD = `---\nname: visual-edit\ndescription: >-\n  Open a running local app in Design overview mode as URL-backed iframe screens\n  for visual editing, flow review, duplication, and route-state exploration.\n  Use when the user asks to inspect, compare, or edit a real local app visually\n  in Design.\nmetadata:\n  visibility: exported\n---\n\n# Visual Edit\n\nUse \\`/visual-edit\\` when the user wants to inspect or edit a real local app\nvisually instead of generating standalone Alpine HTML. The source of truth is\nthe running localhost app plus its route URLs. Design shows those routes as\niframe-backed screens on the infinite canvas.\n\n## Installing this skill for an external MCP host\n\nThe hosted install path\n(\\`npx @agent-native/core@latest skills add visual-edit\\`, or \\`design\\` for the\nfull Design bundle) installs the exported instructions and registers the\nhosted Design MCP connector together. The open Skills CLI path\n(\\`npx skills@latest add BuilderIO/agent-native --skill visual-edit\\`) installs\nexported instructions only, with no MCP connector registration.\n\n## Core Model\n\n- Each screen is a URL-backed iframe, not copied HTML.\n- Each screen keeps URL metadata: \\`connectionId\\`, \\`routeId\\`, \\`path\\`,\n  \\`url\\`, \\`bridgeUrl\\`, title, and viewport size.\n- Localhost Edit mode renders the running app through the local bridge as a live\n  iframe with the same editor bridge used by HTML designs. It is not a frozen\n  static DOM snapshot.\n- The live editor is same-origin through the local bridge proxy. This boots\n  CSR apps and root-relative assets, but it is still a localhost editing proxy:\n  app-origin cookies, WebSockets/HMR, SSE, and non-GET app API calls may need a\n  future dev-server/plugin integration for perfect parity with the app's own\n  origin.\n- Interact mode renders the app's normal URL so app navigation, scrolling,\n  links, and form controls behave as they would in the browser.\n- While a localhost screen has pending live visual edits, do not switch back to\n  Interact until the user either applies the edits to source or explicitly\n  aborts/discards the preview.\n- Start in Design's screen overview mode. In overview, screens are static\n  design frames; full-screen focus is for scrolling and app interaction.\n- Alt-drag duplicates a screen. For localhost screens, duplication copies the\n  iframe frame and URL metadata; change the copy's path/query for a new state.\n- Flow visualization is multiple URL states: \\`/checkout?step=shipping\\`,\n  \\`/checkout?step=payment\\`, \\`/checkout?step=done\\`, etc.\n- When the user gives a named flow or numbered screen list, preserve that order\n  and create one screen per URL/path. Shorthand like\n  \\`localhost:1234/onboarding/1\\` means\n  \\`http://localhost:1234/onboarding/1\\`.\n\n## Select And Reprompt\n\nWhen a chat message begins with \\`[Reprompt selection]\\`, the selected subtree is\na hard write boundary. The only mutation path is \\`propose-node-rewrite\\` with\nthe exact \\`repromptId\\`, target, and \\`baseVersionHash\\` captured in\n\\`design-reprompt-pending:<designId>:<fileId>\\`. Never use \\`apply-visual-edit\\`,\n\\`apply-source-edit\\`, \\`write-source\\`, \\`write-local-file\\`, \\`edit-design\\`, or any\nother content-writing action for that request. Clarifying questions are allowed,\nbut a requested change must remain a proposal.\n\nProduce one variant by default. Produce two or three only when the instruction\nasks for options. A retry includes \\`priorProposalId\\`; keep the same target and\nbase version, incorporate the feedback, and call \\`propose-node-rewrite\\` again.\nThe UI previews the returned subtree without persisting it.\n\nUse \\`resolve-node-rewrite\\` for the accept/reject lifecycle. Accept applies the\nchosen variant as one version-checked inline/Yjs content transaction so one\nundo restores the prior structure; reject clears the proposal without changing\ncontent. For conversational resolution such as \"apply the second one,\" call\n\\`view-screen\\`, read the active \\`design.reprompt.proposal\\`, and pass its\n\\`proposalId\\` plus the zero-based \\`variantIndex\\` to \\`resolve-node-rewrite\\`.\n\n## Review Quality\n\n- Treat the running app as the truth. Preserve its component language, tokens,\n  route state, and real content unless the user explicitly asks for a new visual\n  direction.\n- Use multiple URL states to reveal meaningful UX moments: empty/loading/error\n  states, focused panels, modals, responsive breakpoints, and completed flow\n  steps when those matter to the review.\n- For visual edits, compare before/after at the relevant viewport sizes and\n  check key hover/focus/scroll states when the app exposes them.\n\n## Account And Sharing Model\n\n- The \\`/visual-edit\\` entry route can open before the viewer signs in. Public\n  \\`/design/:id\\` editor links can also render read-only public designs without a\n  session.\n- Prefer links returned by Design actions or \\`/_agent-native/open\\` deep links.\n  Do not surface URLs with \\`_session=\\` tokens. Query sessions are only a\n  fallback after normal cookie resolution, so an existing browser session can\n  still open the design as a different user and show \"Design not found\".\n- Do not attempt anonymous write actions. Bridge registration, design creation,\n  screen placement, generation, saving, and sharing are account-backed. If a\n  signed-out visitor wants to save or share, send them through the framework\n  sign-in return flow, then save or copy the design into that account before\n  opening the share dialog.\n\n## Required Local Bridge\n\nThe live-edit bridge is unlocked by a shared secret (the \"bridge token\") that\nmust match on two sides: the local bridge process, and the user's connection row\nin Design (which the browser reads to authorize \\`/live-edit-bridge\\`,\n\\`/read-file\\`, \\`/write-file\\`). Get them to match by letting the\n**authenticated** \\`open-visual-edit\\` action mint the token, then starting the\nbridge with it. This is the only ordering that works for the remote-MCP flow —\nthe bridge cannot push its own token to the server without a CLI auth token, so\nthe server mints instead and the bridge adopts.\n\nFrom the target app repo, make sure its dev server is running, then:\n\n**1. Discover routes without starting a durable bridge** (one-shot, exits):\n\n\\`\\`\\`bash\nnpx @agent-native/core@latest design connect --url http://localhost:5173 --root . --json\n\\`\\`\\`\n\nThis prints the manifest (routes + capabilities). Parse it to build\n\\`routeManifest\\` for the next step. (Skip this if the user already gave explicit\npaths/URLs to place.)\n\nInside the agent-native monorepo itself, use the workspace CLI instead of\n\\`npx\\` — \\`npx\\` installs the last published \\`@agent-native/core\\`, which will not\ncontain local changes and costs a slow install on every call:\n\n\\`\\`\\`bash\npnpm dev:cli design connect --url http://localhost:5173 --root templates/<app> --json\n\\`\\`\\`\n\n**2. Call \\`open-visual-edit\\`** (see Action Flow below) with NO \\`bridgeToken\\`.\nThe server mints one, stores it on the user's connection row, copies it into the\nplaced screens' metadata, and returns it to you as \\`bridgeToken\\`. Capture it.\n\n**3. Start the persistent bridge adopting that token** (single line; prefer the\nenv var so the secret does not appear in \\`ps\\`):\n\n\\`\\`\\`bash\nAGENT_NATIVE_BRIDGE_TOKEN=\"<bridgeToken from step 2>\" npx @agent-native/core@latest design connect --url http://localhost:5173 --root . --daemon\n\\`\\`\\`\n\n(Equivalently, pass \\`--bridge-token <token>\\`.) This starts a detached bridge on\n\\`http://127.0.0.1:7331\\`, adopts the server-minted token — so bridge and row\nagree and live-edit authorizes with no self-registration — and stays alive after\nthe command exits.\n\nFor a manual health/manifest check on the running bridge:\n\n\\`\\`\\`bash\ncurl http://127.0.0.1:7331/health\n\\`\\`\\`\n\n\\`/health\\` needs no token. The full manifest at \\`/manifest.json\\` is\npreview-token protected, so an unauthenticated \\`curl\\` of it returns\n\\`{\"ok\":false,\"error\":\"invalid or missing preview token\"}\\` — that response means\nthe bridge is up, not that it is broken.\n\nOnly use \\`--json\\` for the step-1 route probe. Never use \\`--json\\`, \\`--once\\`,\nor \\`--dry-run\\` for the durable step-3 bridge: they print the manifest and exit,\nso Design falls back to a non-editable live iframe.\n\nThe bridge listens on a single fixed port (7331) and refuses to start for a\nsecond, different app. It is detached with no log file, so if \\`--daemon\\` reports\na timeout, check for a stale process (\\`lsof -ti:7331\\`) before retrying.\n\n## Action Flow\n\nPrefer the single authenticated \\`open-visual-edit\\` action. It registers or\nrefreshes the localhost bridge connection, mints and stores the bridge token,\ncreates or reuses a Design project, places URL-backed screens, stores the active\nvisual-edit context, and navigates to overview mode in one call. This avoids\ncreating a private design under a synthetic CLI user and then handing the browser\na tokenized URL that may be shadowed by an existing session.\n\nCall it BEFORE starting the durable bridge (step 3 above): it does not contact\nthe bridge, so the bridge need not be running yet, and you need its returned\n\\`bridgeToken\\` to start the bridge with a matching secret. Omit \\`bridgeToken\\`\non the call so the server mints one.\n\n\\`\\`\\`bash\npnpm action open-visual-edit '{\n  \"title\": \"Docs homepage visual edit\",\n  \"devServerUrl\": \"http://localhost:5173\",\n  \"bridgeUrl\": \"http://127.0.0.1:7331\",\n  \"rootPath\": \"/absolute/path/to/app\",\n  \"routeManifest\": { \"...\": \"from /manifest.json\" },\n  \"paths\": [\"/\", \"/pricing\", \"/checkout?step=payment\"]\n}'\n\\`\\`\\`\n\nThe action returns \\`designId\\`, \\`connectionId\\`, \\`bridgeToken\\`, \\`screens\\`,\n\\`urlPath\\`, and \\`openUrl\\`. Keep \\`designId\\`/\\`connectionId\\` in the chat context\nfor follow-ups, and pass \\`bridgeToken\\` to \\`design connect\\` (step 3) to start\nthe bridge. On follow-up calls reusing an existing \\`connectionId\\`, the same\ntoken is returned (it is minted once and reused), so the running bridge stays\nvalid.\n\n### Desktop and mobile side by side\n\nPass \\`viewports\\` to place every requested route once per viewport. Frames lay\nout as a grid: one row per route, one column per viewport. Presets are\n\\`desktop\\` (1280x900), \\`laptop\\` (1440x900), \\`tablet\\` (834x1112), and \\`mobile\\`\n(390x844); an explicit \\`{ \"label\": \"...\", \"width\": N, \"height\": N }\\` also works.\n\n\\`\\`\\`bash\npnpm action open-visual-edit '{\n  \"title\": \"Tasks responsive visual edit\",\n  \"devServerUrl\": \"http://localhost:5173\",\n  \"bridgeUrl\": \"http://127.0.0.1:7331\",\n  \"rootPath\": \"/absolute/path/to/app\",\n  \"paths\": [\"/tasks\", \"/inbox\"],\n  \"viewports\": [\"desktop\", \"mobile\"]\n}'\n\\`\\`\\`\n\nPrefer this over two separate calls with \\`defaultWidth\\`/\\`defaultHeight\\`: it\nkeeps each route's viewports aligned in a row and titles them\n\\`Tasks — Desktop\\` / \\`Tasks — Mobile\\` so the canvas reads clearly. \\`viewports\\`\noverrides \\`defaultWidth\\`/\\`defaultHeight\\`. With no \\`routes\\`/\\`paths\\`, it expands\nevery route in the localhost manifest, which is usually far more frames than\nthe user wants — name the paths.\n\n### Adding more page frames later\n\nCall \\`open-visual-edit\\` again with the same \\`designId\\` and \\`connectionId\\` and\nonly the new paths. Existing frames for the same route and viewport are\nrefreshed in place rather than duplicated, and a frame the user has dragged or\nresized keeps its position unless you explicitly pass \\`x\\`/\\`y\\`/\\`width\\`/\\`height\\`.\n\n\\`\\`\\`bash\npnpm action open-visual-edit '{\n  \"designId\": \"<existing-design-id>\",\n  \"connectionId\": \"<existing-connection-id>\",\n  \"devServerUrl\": \"http://localhost:5173\",\n  \"paths\": [\"/settings\", \"/team\"],\n  \"startY\": 2200\n}'\n\\`\\`\\`\n\nDo NOT add \\`defaultWidth\\`/\\`defaultHeight\\` just to restate the default size:\nsupplying either one marks the viewport as explicitly requested, which\noverwrites frame sizes the user has already adjusted on the canvas.\n\nFor a numbered flow the user describes in chat, keep the labels and order:\n\n\\`\\`\\`bash\npnpm action open-visual-edit '{\n  \"designId\": \"<existing-design-id>\",\n  \"connectionId\": \"<existing-connection-id>\",\n  \"devServerUrl\": \"http://localhost:1234\",\n  \"routes\": [\n    { \"url\": \"localhost:1234/onboarding/1\", \"title\": \"Screen 1\" },\n    { \"url\": \"localhost:1234/onboarding/2\", \"title\": \"Screen 2\" },\n    { \"url\": \"localhost:1234/onboarding/3\", \"title\": \"Screen 3\" }\n  ]\n}'\n\\`\\`\\`\n\nIf no \\`routes\\` or \\`paths\\` are supplied, \\`open-visual-edit\\` uses every route\nfrom the localhost manifest.\n\nFallback, only when \\`open-visual-edit\\` is unavailable:\n\n1. Register or refresh the bridge with \\`connect-localhost\\`, passing the\n   \\`/manifest.json\\` result as \\`routeManifest\\` and \\`capabilities\\`.\n2. Create or reuse a Design project with \\`create-design\\`.\n3. Place URL-backed screens with \\`add-localhost-screens\\`.\n4. Navigate to overview mode with \\`navigate\\`.\n\n## Open The Design Surface\n\n- Use the \\`link\\`, \\`deepLink\\`, or MCP App embed returned by Design actions so\n  the user sees the canvas. In Codex Desktop or VS Code, prefer opening that\n  Design URL in the available preview/webview panel; otherwise surface the\n  \"Open design\" link.\n- Return or open the \\`openUrl\\` / action link, not a hand-built\n  \\`/design/:id?_session=...\\` URL.\n- If the user is working in VS Code, the Agent Native extension can open the\n  same URL via\n  \\`vscode://builder.agent-native/open?url=<encoded-design-url>\\`. Its\n  \\`Agent Native: Open Design Canvas\\` command also starts the local bridge and\n  opens hosted Design in the VS Code side panel.\n- After \\`open-visual-edit\\`, confirm the Design editor is in overview mode\n  with the requested URL-backed frames visible, and that they render the app\n  rather than a spinner. Do not stop at \"screens added\" when the user asked to\n  inspect or edit visually.\n\n## Applying Visual Edits Back To Source\n\nCanvas edits on a localhost screen do not write source as you make them. They\naccumulate as pending edits and the editor shows an \"Apply with Design agent\"\nbutton in the bottom-right corner of the canvas. Clicking it hands a structured\nprompt to the Design agent chat, which performs the real source write.\n\n- Style, text, and drag/drop structure edits all collect into the same pending\n  batch, so the user can make several changes and apply once.\n- After the write lands, the target app's own dev-server HMR refreshes the\n  frames — no manual reload. If frames do not refresh, the write did not land;\n  say so rather than assuming.\n- The separate disk-icon \"Apply to source\" button is the deterministic\n  whole-file HTML/CSS writer. It is intentionally disabled for compiled\n  \\`.jsx\\`/\\`.tsx\\` routes — those must go through the agent path above.\n\n## Editing URLs\n\nKeep localhost screens as URL files plus \\`screenMetadata[fileId]\\`. Do not\nreplace them with copied \\`srcdoc\\` HTML unless the user explicitly asks for a\nfrozen snapshot. To change a state, rerun \\`open-visual-edit\\` with the new\npath/query or duplicate the screen and update the copy's URL metadata.\n\n## Local Files in the Code Tab\n\nOnce a connection is registered, the design editor's Code panel (left rail →\nCode, or \\`navigate --view editor --designId <id> --leftPanel code\\`) shows a\nlocal-files workspace root for that connection next to the design's own files.\nTreat that root like VS Code opened at the connected project directory: file\ntree, search, open/edit, and save are backed by the real local files. It lists\nthe connected app's text/code files through the bridge\n(\\`list-local-files\\` / \\`read-local-file\\`); build output, \\`node_modules\\`,\n\\`.git\\`, and secret-looking paths (\\`.env*\\`, key files) are always excluded.\n\n- Browsing and reading need only editor access on the design plus the running\n  bridge.\n- Saving goes through \\`write-local-file\\`: the first save opens the\n  write-consent dialog (an 8-hour, folder-scoped grant) and retries\n  automatically once granted. Only text/code files are writable; secret paths\n  are always blocked.\n- If the agent calls \\`write-local-file\\` directly (not through a UI save) and it\n  fails with \"no write-consent grant\", call \\`request-localhost-write-consent\\`.\n  It opens the write-consent dialog in the editor, or reports \\`alreadyGranted\\`\n  if one already exists. Granting is human-only —\n  \\`grant-localhost-write-consent\\` is hidden from agents, so you cannot approve\n  it yourself. Tell the user to click \"Allow writes\", then retry\n  \\`write-local-file\\` once. Do not keep retrying blindly: the write stays\n  blocked until the user approves.\n- Saves are conflict-checked against the file's on-disk version — a file that\n  changed since it was read fails with a version conflict instead of being\n  overwritten.\n\n## React Source Writeback\n\n- Use compiler/debug provenance (project-relative file, line, column,\n  component, and runtime multiplicity) to locate React/TSX source. Treat it as\n  evidence, not as permission for a generic AST structural transform.\n- A single-instance leaf text edit, literal \\`className\\`/\\`class\\` edit, or flat\n  literal \\`style={{ ... }}\\` property may use \\`apply-visual-edit\\` with a\n  \\`local-file\\` source and exact \\`target.sourceAnchor\\`. Preview first (omit\n  \\`persist\\`), inspect \\`proposedDiff\\`, then call with \\`persist: true\\`.\n- Reparenting, grouping/ungrouping, wrappers, dynamic expressions, repeated\n  \\`.map()\\` instances, shared components, breakpoint-scoped edits, and\n  cross-file changes go through the coding agent with exact subject/target\n  anchors and their runtime relationship. \\`apply-visual-edit\\` refuses these\n  with \\`status: \"needsAgent\"\\` rather than guessing.\n- Before each write, read the file and pass its exact \\`versionHash\\` to\n  \\`write-local-file\\` with \\`requireExpectedVersionHash: true\\`; on conflict,\n  re-read and re-plan. Keep the optimistic preview until HMR/runtime confirms\n  the result. Human write consent remains mandatory and agents cannot grant it.\n\n## Verification\n\n- \\`list-localhost-connections\\` returns the expected connection and routes.\n- The Design editor opens in overview mode.\n- Every requested screen renders the intended localhost URL, showing real app\n  content rather than an endless loading spinner.\n- Alt-dragging a screen copies the URL-backed frame, not an inline HTML clone.\n- A query/path edit changes only the target screen's URL metadata and iframe.\n- The Code tab shows a local-files root for the connection and opens its files.\n`;\n"]}

package/dist/cli/skills-content/rewind-skill.d.ts

@@ -1,2 +1,2 @@
-export declare const REWIND_SKILL_MD = "---\nname: rewind\ndescription: >-\n  Retrieve recent local Clips Rewind context when the user says \"Look at\n  Rewind,\" asks what just happened, or refers to something they recently said\n  or saw.\nmetadata:\n  visibility: exported\n---\n\n# Rewind\n\nUse Clips Rewind as local screen memory. Start broad enough to find the right\nmoment, then read only the smallest relevant range.\n\n## Retrieval Flow\n\n1. Call `screen_memory_status` first. If the newest segment is still open,\n   wait for it to finalize rather than substituting an older segment.\n2. Search `screen_memory_search_chapters` before requesting raw recent\n   context. Use the user's words, the visible app or project, and the likely\n   time range as clues.\n3. If several chapters plausibly match, show the candidates and ask which one\n   the user means. Do not blend separate workstreams together.\n4. Read the smallest useful range with `screen_memory_recent_context`.\n   Restate what you recovered before acting, and flag transcription or coverage\n   uncertainty.\n5. Use `screen_memory_frame_at` for one exact visual moment or\n   `screen_memory_contact_sheet` to scan a bounded range. Prefer local frames\n   before escalating to cloud processing.\n6. Request the smallest relevant timestamp range through Clips' bounded private\n   Clip handoff only when local text and frames are insufficient, such as\n   garbled speech, important motion, dense analysis, or a Clip the user wants\n   to keep and query later.\n\n## Boundaries\n\n- Rewind recordings, screenshots, audio, transcripts, OCR, and indexes remain\n  local unless the user explicitly asks for a bounded Clip handoff.\n- Do not reveal archive filesystem paths, crawl Clips' app-data folders, or\n  bypass the Screen Memory MCP broker.\n- Do not upload frames returned by local Screen Memory tools.\n- Treat foreground apps and chapter labels as evidence, not proof of intent.\n- If the Screen Memory MCP is missing, explain that the one-time setup needs to\n  be repaired with:\n\n  `npx -y @agent-native/core@latest skills add rewind --client <client> --scope user --yes`\n\n  Replace `<client>` with the current compatible host: `codex`,\n  `claude-code`, `cursor`, `opencode`, `github-copilot`, or `cowork`.\n  Ask the user to restart the host if it cannot reload MCP servers in place.\n";
+export declare const REWIND_SKILL_MD = "---\nname: rewind\ndescription: >-\n  Retrieve recent local Clips Rewind context when the user says \"Look at\n  Rewind,\" asks what just happened, or refers to something they recently said\n  or saw.\nmetadata:\n  visibility: exported\n---\n\n# Rewind\n\nUse Clips Rewind as local screen memory. Start broad enough to find the right\nmoment, then read only the smallest relevant range.\n\n## First-Run Setup\n\nCall `screen_memory_status` before assuming Rewind is ready. If the tool is\nunavailable, do not stop at a missing-tool error and do not silently install\nanything:\n\n1. Explain that Rewind requires the signed Clips Desktop app on macOS plus a\n   local agent connection.\n2. Ask whether Clips is installed, or use a non-mutating native application\n   lookup when the host supports one. Do not inspect Clips' app-data folders.\n   If Clips is absent or its presence cannot be confirmed, ask permission\n   before opening or downloading anything: \u201CClips Desktop is required for\n   Rewind. Would you like me to open the official installer and guide you\n   through setup?\u201D\n3. Only after affirmative permission, open\n   `https://clips.agent-native.com/download` in the user's browser. Complete\n   native installation steps only when the current host can safely do so and\n   the user explicitly permitted them. Never bypass Gatekeeper, accept macOS\n   permission prompts, or enable screen/audio capture on the user's behalf.\n4. If native UI control is unavailable, return the download link and wait for\n   the user to confirm that Clips is installed and running.\n5. Ask the user to enable Rewind in the Clips tray and choose the intended\n   capture mode. Then configure the local connection with:\n\n   `npx -y @agent-native/core@latest skills add rewind --client <client> --scope user --yes`\n\n   Replace `<client>` with the current compatible host: `codex`,\n   `claude-code`, `cursor`, `opencode`, `github-copilot`, or `cowork`.\n6. Restart the host only if it cannot reload MCP servers in place, then retry\n   `screen_memory_status`. Do not claim setup succeeded until it reports\n   Rewind enabled and unpaused.\n\n## Retrieval Flow\n\n1. Call `screen_memory_status` first. If the newest segment is still open,\n   wait for it to finalize rather than substituting an older segment.\n2. Search `screen_memory_search_chapters` before requesting raw recent\n   context. Use the user's words, the visible app or project, and the likely\n   time range as clues.\n3. If several chapters plausibly match, show the candidates and ask which one\n   the user means. Do not blend separate workstreams together.\n4. Read the smallest useful range with `screen_memory_recent_context`.\n   Restate what you recovered before acting, and flag transcription or coverage\n   uncertainty.\n5. Use `screen_memory_frame_at` for one exact visual moment or\n   `screen_memory_contact_sheet` to scan a bounded range. Prefer local frames\n   before escalating to cloud processing.\n6. Request the smallest relevant timestamp range through Clips' bounded private\n   Clip handoff only when local text and frames are insufficient, such as\n   garbled speech, important motion, dense analysis, or a Clip the user wants\n   to keep and query later.\n\n## Boundaries\n\n- Rewind recordings, screenshots, audio, transcripts, OCR, and indexes remain\n  local unless the user explicitly asks for a bounded Clip handoff.\n- Do not reveal archive filesystem paths, crawl Clips' app-data folders, or\n  bypass the Screen Memory MCP broker.\n- Do not upload frames returned by local Screen Memory tools.\n- Treat foreground apps and chapter labels as evidence, not proof of intent.\n- If Clips is installed and Rewind is enabled but the Screen Memory MCP is\n  missing, explain that only the agent connection needs repair with:\n\n  `npx -y @agent-native/core@latest skills add rewind --client <client> --scope user --yes`\n\n  Ask the user to restart the host if it cannot reload MCP servers in place.\n- Never conflate installing Clips Desktop with installing the skill/MCP\n  connection, and never claim either succeeded without direct evidence.\n";
 //# sourceMappingURL=rewind-skill.d.ts.map

package/dist/cli/skills-content/rewind-skill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rewind-skill.d.ts","sourceRoot":"","sources":["../../../src/cli/skills-content/rewind-skill.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,myEAmD3B,CAAC"}
+{"version":3,"file":"rewind-skill.d.ts","sourceRoot":"","sources":["../../../src/cli/skills-content/rewind-skill.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,2jIAmF3B,CAAC"}

package/dist/cli/skills-content/rewind-skill.js

@@ -13,6 +13,38 @@ metadata:
 Use Clips Rewind as local screen memory. Start broad enough to find the right
 moment, then read only the smallest relevant range.
 
+## First-Run Setup
+
+Call \`screen_memory_status\` before assuming Rewind is ready. If the tool is
+unavailable, do not stop at a missing-tool error and do not silently install
+anything:
+
+1. Explain that Rewind requires the signed Clips Desktop app on macOS plus a
+   local agent connection.
+2. Ask whether Clips is installed, or use a non-mutating native application
+   lookup when the host supports one. Do not inspect Clips' app-data folders.
+   If Clips is absent or its presence cannot be confirmed, ask permission
+   before opening or downloading anything: “Clips Desktop is required for
+   Rewind. Would you like me to open the official installer and guide you
+   through setup?”
+3. Only after affirmative permission, open
+   \`https://clips.agent-native.com/download\` in the user's browser. Complete
+   native installation steps only when the current host can safely do so and
+   the user explicitly permitted them. Never bypass Gatekeeper, accept macOS
+   permission prompts, or enable screen/audio capture on the user's behalf.
+4. If native UI control is unavailable, return the download link and wait for
+   the user to confirm that Clips is installed and running.
+5. Ask the user to enable Rewind in the Clips tray and choose the intended
+   capture mode. Then configure the local connection with:
+
+   \`npx -y @agent-native/core@latest skills add rewind --client <client> --scope user --yes\`
+
+   Replace \`<client>\` with the current compatible host: \`codex\`,
+   \`claude-code\`, \`cursor\`, \`opencode\`, \`github-copilot\`, or \`cowork\`.
+6. Restart the host only if it cannot reload MCP servers in place, then retry
+   \`screen_memory_status\`. Do not claim setup succeeded until it reports
+   Rewind enabled and unpaused.
+
 ## Retrieval Flow
 
 1. Call \`screen_memory_status\` first. If the newest segment is still open,
@@ -41,13 +73,13 @@ moment, then read only the smallest relevant range.
   bypass the Screen Memory MCP broker.
 - Do not upload frames returned by local Screen Memory tools.
 - Treat foreground apps and chapter labels as evidence, not proof of intent.
-- If the Screen Memory MCP is missing, explain that the one-time setup needs to
-  be repaired with:
+- If Clips is installed and Rewind is enabled but the Screen Memory MCP is
+  missing, explain that only the agent connection needs repair with:
 
   \`npx -y @agent-native/core@latest skills add rewind --client <client> --scope user --yes\`
 
-  Replace \`<client>\` with the current compatible host: \`codex\`,
-  \`claude-code\`, \`cursor\`, \`opencode\`, \`github-copilot\`, or \`cowork\`.
   Ask the user to restart the host if it cannot reload MCP servers in place.
+- Never conflate installing Clips Desktop with installing the skill/MCP
+  connection, and never claim either succeeded without direct evidence.
 `;
 //# sourceMappingURL=rewind-skill.js.map

package/dist/cli/skills-content/rewind-skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"rewind-skill.js","sourceRoot":"","sources":["../../../src/cli/skills-content/rewind-skill.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmD9B,CAAC","sourcesContent":["export const REWIND_SKILL_MD = `---\nname: rewind\ndescription: >-\n  Retrieve recent local Clips Rewind context when the user says \"Look at\n  Rewind,\" asks what just happened, or refers to something they recently said\n  or saw.\nmetadata:\n  visibility: exported\n---\n\n# Rewind\n\nUse Clips Rewind as local screen memory. Start broad enough to find the right\nmoment, then read only the smallest relevant range.\n\n## Retrieval Flow\n\n1. Call \\`screen_memory_status\\` first. If the newest segment is still open,\n   wait for it to finalize rather than substituting an older segment.\n2. Search \\`screen_memory_search_chapters\\` before requesting raw recent\n   context. Use the user's words, the visible app or project, and the likely\n   time range as clues.\n3. If several chapters plausibly match, show the candidates and ask which one\n   the user means. Do not blend separate workstreams together.\n4. Read the smallest useful range with \\`screen_memory_recent_context\\`.\n   Restate what you recovered before acting, and flag transcription or coverage\n   uncertainty.\n5. Use \\`screen_memory_frame_at\\` for one exact visual moment or\n   \\`screen_memory_contact_sheet\\` to scan a bounded range. Prefer local frames\n   before escalating to cloud processing.\n6. Request the smallest relevant timestamp range through Clips' bounded private\n   Clip handoff only when local text and frames are insufficient, such as\n   garbled speech, important motion, dense analysis, or a Clip the user wants\n   to keep and query later.\n\n## Boundaries\n\n- Rewind recordings, screenshots, audio, transcripts, OCR, and indexes remain\n  local unless the user explicitly asks for a bounded Clip handoff.\n- Do not reveal archive filesystem paths, crawl Clips' app-data folders, or\n  bypass the Screen Memory MCP broker.\n- Do not upload frames returned by local Screen Memory tools.\n- Treat foreground apps and chapter labels as evidence, not proof of intent.\n- If the Screen Memory MCP is missing, explain that the one-time setup needs to\n  be repaired with:\n\n  \\`npx -y @agent-native/core@latest skills add rewind --client <client> --scope user --yes\\`\n\n  Replace \\`<client>\\` with the current compatible host: \\`codex\\`,\n  \\`claude-code\\`, \\`cursor\\`, \\`opencode\\`, \\`github-copilot\\`, or \\`cowork\\`.\n  Ask the user to restart the host if it cannot reload MCP servers in place.\n`;\n"]}
+{"version":3,"file":"rewind-skill.js","sourceRoot":"","sources":["../../../src/cli/skills-content/rewind-skill.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmF9B,CAAC","sourcesContent":["export const REWIND_SKILL_MD = `---\nname: rewind\ndescription: >-\n  Retrieve recent local Clips Rewind context when the user says \"Look at\n  Rewind,\" asks what just happened, or refers to something they recently said\n  or saw.\nmetadata:\n  visibility: exported\n---\n\n# Rewind\n\nUse Clips Rewind as local screen memory. Start broad enough to find the right\nmoment, then read only the smallest relevant range.\n\n## First-Run Setup\n\nCall \\`screen_memory_status\\` before assuming Rewind is ready. If the tool is\nunavailable, do not stop at a missing-tool error and do not silently install\nanything:\n\n1. Explain that Rewind requires the signed Clips Desktop app on macOS plus a\n   local agent connection.\n2. Ask whether Clips is installed, or use a non-mutating native application\n   lookup when the host supports one. Do not inspect Clips' app-data folders.\n   If Clips is absent or its presence cannot be confirmed, ask permission\n   before opening or downloading anything: “Clips Desktop is required for\n   Rewind. Would you like me to open the official installer and guide you\n   through setup?”\n3. Only after affirmative permission, open\n   \\`https://clips.agent-native.com/download\\` in the user's browser. Complete\n   native installation steps only when the current host can safely do so and\n   the user explicitly permitted them. Never bypass Gatekeeper, accept macOS\n   permission prompts, or enable screen/audio capture on the user's behalf.\n4. If native UI control is unavailable, return the download link and wait for\n   the user to confirm that Clips is installed and running.\n5. Ask the user to enable Rewind in the Clips tray and choose the intended\n   capture mode. Then configure the local connection with:\n\n   \\`npx -y @agent-native/core@latest skills add rewind --client <client> --scope user --yes\\`\n\n   Replace \\`<client>\\` with the current compatible host: \\`codex\\`,\n   \\`claude-code\\`, \\`cursor\\`, \\`opencode\\`, \\`github-copilot\\`, or \\`cowork\\`.\n6. Restart the host only if it cannot reload MCP servers in place, then retry\n   \\`screen_memory_status\\`. Do not claim setup succeeded until it reports\n   Rewind enabled and unpaused.\n\n## Retrieval Flow\n\n1. Call \\`screen_memory_status\\` first. If the newest segment is still open,\n   wait for it to finalize rather than substituting an older segment.\n2. Search \\`screen_memory_search_chapters\\` before requesting raw recent\n   context. Use the user's words, the visible app or project, and the likely\n   time range as clues.\n3. If several chapters plausibly match, show the candidates and ask which one\n   the user means. Do not blend separate workstreams together.\n4. Read the smallest useful range with \\`screen_memory_recent_context\\`.\n   Restate what you recovered before acting, and flag transcription or coverage\n   uncertainty.\n5. Use \\`screen_memory_frame_at\\` for one exact visual moment or\n   \\`screen_memory_contact_sheet\\` to scan a bounded range. Prefer local frames\n   before escalating to cloud processing.\n6. Request the smallest relevant timestamp range through Clips' bounded private\n   Clip handoff only when local text and frames are insufficient, such as\n   garbled speech, important motion, dense analysis, or a Clip the user wants\n   to keep and query later.\n\n## Boundaries\n\n- Rewind recordings, screenshots, audio, transcripts, OCR, and indexes remain\n  local unless the user explicitly asks for a bounded Clip handoff.\n- Do not reveal archive filesystem paths, crawl Clips' app-data folders, or\n  bypass the Screen Memory MCP broker.\n- Do not upload frames returned by local Screen Memory tools.\n- Treat foreground apps and chapter labels as evidence, not proof of intent.\n- If Clips is installed and Rewind is enabled but the Screen Memory MCP is\n  missing, explain that only the agent connection needs repair with:\n\n  \\`npx -y @agent-native/core@latest skills add rewind --client <client> --scope user --yes\\`\n\n  Ask the user to restart the host if it cannot reload MCP servers in place.\n- Never conflate installing Clips Desktop with installing the skill/MCP\n  connection, and never claim either succeeded without direct evidence.\n`;\n"]}

package/dist/cli/skills.d.ts

@@ -5,6 +5,7 @@
  */
 import { type AppSkillManifest } from "./app-skill.js";
 import { type ClientId } from "./mcp-config-writers.js";
+import { installScreenMemoryForClient } from "./mcp.js";
 import { CANVAS_REFERENCE_MD, CONNECTION_REFERENCE_MD, DOCUMENT_QUALITY_REFERENCE_MD, EXEMPLAR_REFERENCE_MD, LOCAL_FILES_REFERENCE_MD, VISUAL_PLANS_SKILL_MD, VISUAL_RECAP_SKILL_MD, VISUALIZE_REPO_SKILL_MD, WIREFRAME_REFERENCE_MD } from "./skills-content/index.js";
 import { type CliTelemetry } from "./telemetry.js";
 export { CANVAS_REFERENCE_MD, CONNECTION_REFERENCE_MD, DOCUMENT_QUALITY_REFERENCE_MD, EXEMPLAR_REFERENCE_MD, LOCAL_FILES_REFERENCE_MD, VISUAL_PLANS_SKILL_MD, VISUAL_RECAP_SKILL_MD, VISUALIZE_REPO_SKILL_MD, WIREFRAME_REFERENCE_MD, };
@@ -225,6 +226,7 @@ export interface RunSkillsOptions {
      * browser/device OAuth round-trip.
      */
     runConnect?: (args: string[]) => Promise<void>;
+    installScreenMemory?: typeof installScreenMemoryForClient;
     /**
      * Best-effort install-funnel telemetry. Created once per `runSkills` run and
      * threaded through resolution/install/connect so each `track` is fire-and-

package/dist/cli/skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/cli/skills.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/cli/skills.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,OAAO,EAKL,KAAK,gBAAgB,EAEtB,MAAM,gBAAgB,CAAC;AAUxB,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EACL,4BAA4B,EAE7B,MAAM,UAAU,CAAC;AAGlB,OAAO,EAEL,mBAAmB,EACnB,uBAAuB,EAIvB,6BAA6B,EAC7B,qBAAqB,EAErB,wBAAwB,EAExB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EACL,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,EAC7B,qBAAqB,EACrB,wBAAwB,EACxB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,sBAAsB,GACvB,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuU/B,CAAC;AAKF,eAAO,MAAM,gCAAgC,4BAA4B,CAAC;AAsG1E,KAAK,wBAAwB,GAAG,QAAQ,GAAG,IAAI,CAAC;AAoDhD,KAAK,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AACnE,KAAK,eAAe,GAAG,QAAQ,GAAG,aAAa,GAAG,aAAa,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,wBAAwB,EAAE,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,OAAO,CAAC;IACvB,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,GAAG,EAAE,OAAO,CAAC;IACb;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAkED,UAAU,iBAAiB;IACzB,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACzC;AAED,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,KAAK,CAAC;AAEvD,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,cAAc;IACtB,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,uBAAuB,EAAE,CAAC;IAC/C;;;OAGG;IACH,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC;IAC9B,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC;;;OAGG;IACH,oBAAoB,CAAC,EAAE,MAAM,cAAc,GAAG,SAAS,CAAC;IACxD,aAAa,CAAC,EAAE,CACd,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,wBAAwB,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,YAAY,CAAC,EAAE,CACb,OAAO,EAAE,yBAAyB,KAC/B,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9B,kBAAkB,CAAC,EAAE,CACnB,OAAO,EAAE,+BAA+B,KACrC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,CACZ,OAAO,EAAE,wBAAwB,KAC9B,OAAO,CAAC,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,cAAc,CAAC,EAAE,CACf,OAAO,EAAE,2BAA2B,KACjC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IACrC,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChD,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IACzD,UAAU,CAAC,EAAE,CACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,CAAC,EAAE,iBAAiB,KACxB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,mBAAmB,CAAC,EAAE,OAAO,4BAA4B,CAAC;IAC1D;;;;;OAKG;IACH,SAAS,CAAC,EAAE,YAAY,CAAC;CAC1B;AAED,UAAU,yBAAyB;IACjC,cAAc,EAAE,wBAAwB,EAAE,CAAC;IAC3C,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,wBAAwB,CAAC;QAChC,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,UAAU,yBAAyB;IACjC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChE;AAED,UAAU,+BAA+B;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,wBAAwB;IAChC,YAAY,EAAE,SAAS,GAAG,MAAM,CAAC;CAClC;AAED,UAAU,2BAA2B;IACnC,WAAW,EAAE,eAAe,CAAC;CAC9B;AA46DD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,CA8GhE;AAyiBD,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAyd1B;AAoTD,wBAAsB,SAAS,CAC7B,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CA8af"}

package/dist/cli/skills.js

@@ -13,7 +13,7 @@ import { MCP_LEGACY_ROUTE_PREFIX, MCP_PUBLIC_ROUTE_PREFIX, } from "../mcp/route-
 import { buildAppSkillPack, ensureAppSkill, loadAppSkillManifest, normalizeAppSkillManifest, } from "./app-skill.js";
 import { resolveClients, runConnect, writeConnectClientPreferences, } from "./connect.js";
 import { CONTEXT_XRAY_SKILL_MD, installLocalContextXray, } from "./context-xray-local.js";
-import { CLIENTS } from "./mcp-config-writers.js";
+import { CLIENTS, configPathFor } from "./mcp-config-writers.js";
 import { installScreenMemoryForClient, resolveScreenMemoryStoreDir, } from "./mcp.js";
 import { PR_VISUAL_RECAP_SETUP, writePrVisualRecapWorkflow } from "./recap.js";
 import { setupAgentSymlinks } from "./setup-agents.js";
@@ -466,6 +466,34 @@ function normalizeKnownSkillTarget(value) {
 function isKnownSkill(value) {
     return Boolean(normalizeKnownSkillTarget(value));
 }
+function explicitlyTargetsRewind(parsed) {
+    return (normalizeKnownSkillTarget(parsed.target ?? "assets") === "rewind" ||
+        Boolean(parsed.plainSkillNames?.some((skillName) => normalizeKnownSkillTarget(skillName) === "rewind")));
+}
+const REWIND_MISSING_STORE_ERROR = "No local Clips Screen Memory store was found. Clips Desktop is required for Rewind. Download and launch the signed app from https://clips.agent-native.com/download, turn Rewind on, then run the setup again. Clips Desktop was not installed or enabled automatically.";
+function preflightRewindStore(parsed) {
+    if (parsed.command !== "add" || !explicitlyTargetsRewind(parsed))
+        return undefined;
+    if (!parsed.mcp) {
+        throw new Error("Rewind requires the local Clips Screen Memory MCP and cannot be installed with --no-mcp.");
+    }
+    if (parsed.mcpUrl) {
+        throw new Error("Rewind uses the local Clips Screen Memory MCP and does not accept --mcp-url.");
+    }
+    if (parsed.dryRun)
+        return undefined;
+    const screenMemoryDir = resolveScreenMemoryStoreDir();
+    if (!screenMemoryDir)
+        throw new Error(REWIND_MISSING_STORE_ERROR);
+    return screenMemoryDir;
+}
+function preflightResolvedRewindTargets(parsed, targets) {
+    preflightRewindStore({
+        ...parsed,
+        target: undefined,
+        plainSkillNames: [...(parsed.plainSkillNames ?? []), ...targets],
+    });
+}
 function isLocalOnlyBuiltInSkill(entry) {
     return Boolean(entry && "localOnly" in entry && entry.localOnly);
 }
@@ -895,13 +923,7 @@ $ARGUMENTS
     }
     return null;
 }
-/**
- * Write a built-in skill's instruction folders straight into each client's
- * skills directory. Built-in skills ship their SKILL.md inside this package, so
- * there is no need to shell out to the separate @agent-native/skills installer
- * (which would have to be published to npm first). Returns the written folders.
- */
-function installBuiltInInstructions(input) {
+function builtInInstructionPaths(input) {
     const bundles = Object.values(skillFilesForBuiltIn(input.appSkillId, {
         planMode: input.planMode,
         mcpUrl: input.mcpUrl,
@@ -912,22 +934,72 @@ function installBuiltInInstructions(input) {
         const commandsRoot = builtInCommandsRootForAgent(agent, input.scope, input.baseDir);
         for (const bundle of bundles) {
             const dir = path.join(root, bundle.skillName);
-            if (!input.dryRun)
-                writeSkillFolder(dir, bundle);
             written.push(dir);
             const command = slashCommandForBuiltInSkill(bundle.skillName);
             if (command) {
                 const commandPath = path.join(commandsRoot, `${bundle.skillName}.md`);
-                if (!input.dryRun) {
-                    fs.mkdirSync(path.dirname(commandPath), { recursive: true });
-                    fs.writeFileSync(commandPath, command, "utf-8");
-                }
                 written.push(commandPath);
             }
         }
     }
     return written;
 }
+function installBuiltInInstructions(input) {
+    const bundles = Object.values(skillFilesForBuiltIn(input.appSkillId, {
+        planMode: input.planMode,
+        mcpUrl: input.mcpUrl,
+    })).filter((bundle) => !input.onlySkillNames || input.onlySkillNames.includes(bundle.skillName));
+    const written = builtInInstructionPaths(input);
+    if (input.dryRun)
+        return written;
+    for (const agent of input.skillsAgents) {
+        const root = builtInSkillsRootForAgent(agent, input.scope, input.baseDir);
+        const commandsRoot = builtInCommandsRootForAgent(agent, input.scope, input.baseDir);
+        for (const bundle of bundles) {
+            writeSkillFolder(path.join(root, bundle.skillName), bundle);
+            const command = slashCommandForBuiltInSkill(bundle.skillName);
+            if (command) {
+                const commandPath = path.join(commandsRoot, `${bundle.skillName}.md`);
+                fs.mkdirSync(path.dirname(commandPath), { recursive: true });
+                fs.writeFileSync(commandPath, command, "utf-8");
+            }
+        }
+    }
+    return written;
+}
+function snapshotInstallPaths(targets, backupRoot) {
+    return [...new Set(targets)].map((target, index) => {
+        const backup = path.join(backupRoot, `snapshot-${index}`);
+        const existed = fs.existsSync(target);
+        if (existed)
+            fs.cpSync(target, backup, { recursive: true });
+        return { target, backup, existed };
+    });
+}
+function removeEmptyParents(start, boundary) {
+    let current = path.resolve(start);
+    const stop = path.resolve(boundary);
+    while (current !== stop && current.startsWith(`${stop}${path.sep}`)) {
+        if (!fs.existsSync(current) || fs.readdirSync(current).length > 0)
+            return;
+        fs.rmdirSync(current);
+        current = path.dirname(current);
+    }
+}
+function restoreInstallPaths(snapshots, boundary) {
+    for (const snapshot of snapshots.toReversed()) {
+        fs.rmSync(snapshot.target, { recursive: true, force: true });
+        if (snapshot.existed) {
+            fs.mkdirSync(path.dirname(snapshot.target), { recursive: true });
+            fs.cpSync(snapshot.backup, snapshot.target, { recursive: true });
+        }
+    }
+    for (const snapshot of snapshots) {
+        if (!snapshot.existed) {
+            removeEmptyParents(path.dirname(snapshot.target), boundary);
+        }
+    }
+}
 function listSkillFolderFiles(dir) {
     const out = {};
     const walk = (current, prefix = "") => {
@@ -2558,6 +2630,9 @@ export async function addAgentNativeSkill(parsed, options = {}) {
     const knownBuiltIn = knownTarget ? BUILT_IN_APP_SKILLS[knownTarget] : null;
     const installsScreenMemoryMcp = isScreenMemoryMcpBuiltInSkill(knownBuiltIn);
     const baseDir = options.baseDir ?? process.cwd();
+    if (installsScreenMemoryMcp && !parsed.mcp) {
+        throw new Error("Rewind requires the local Clips Screen Memory MCP and cannot be installed with --no-mcp.");
+    }
     if (installsScreenMemoryMcp && parsed.mcpUrl) {
         throw new Error("Rewind uses the local Clips Screen Memory MCP and does not accept --mcp-url.");
     }
@@ -2652,7 +2727,7 @@ export async function addAgentNativeSkill(parsed, options = {}) {
     }
     installTarget = preserveMcpUrlAppPathOverride(installTarget, parsed.mcpUrl);
     const skillsAgents = installsScreenMemoryMcp
-        ? clients
+        ? clients.filter((client) => client !== "cowork")
         : skillsAgentsForClients(clients);
     if (parsed.dryRun) {
         try {
@@ -2698,6 +2773,7 @@ export async function addAgentNativeSkill(parsed, options = {}) {
         }
     }
     const commands = [];
+    const screenMemoryDir = preflightRewindStore(parsed);
     const tmpRoot = fs.mkdtempSync(path.join(os.tmpdir(), "an-skills-add-"));
     let instructionSource;
     let instructionsWritten;
@@ -2705,6 +2781,29 @@ export async function addAgentNativeSkill(parsed, options = {}) {
     let connectCommand;
     let registeredMcpClients = shouldRegisterMcp ? mcpClients : [];
     let localManifestPath;
+    const builtInInstructionInput = knownTarget
+        ? {
+            appSkillId: knownTarget,
+            onlySkillNames,
+            skillsAgents,
+            scope: parsed.scope,
+            baseDir,
+            dryRun: parsed.dryRun,
+            planMode,
+            mcpUrl: installTarget.loaded.manifest.hosted.mcpUrl,
+        }
+        : undefined;
+    const rewindSnapshots = installsScreenMemoryMcp
+        ? snapshotInstallPaths([
+            ...(parsed.instructions && builtInInstructionInput
+                ? builtInInstructionPaths(builtInInstructionInput)
+                : []),
+            ...(shouldRegisterMcp
+                ? mcpClients.map((client) => configPathFor(client, baseDir, parsed.scope))
+                : []),
+        ], tmpRoot)
+        : undefined;
+    const rollbackBoundary = parsed.scope === "user" ? os.homedir() : path.resolve(baseDir);
     try {
         if (parsed.instructions) {
             if (skillsAgents.length === 0) {
@@ -2712,21 +2811,12 @@ export async function addAgentNativeSkill(parsed, options = {}) {
                     throw new Error("Skill instructions use shared .agents for Codex, Pi, Cursor, OpenCode, Copilot, and similar agents, or Claude Code's native files. Use an MCP-capable client or omit --instructions-only.");
                 }
             }
-            else if (knownTarget) {
+            else if (knownTarget && builtInInstructionInput) {
                 // Built-in skills ship their instructions inside this package, so copy
                 // the skill folders straight into each client's skills directory. This
                 // avoids shelling out to the separate @agent-native/skills installer
                 // (which would need to be published to npm to run via npx).
-                instructionsWritten = installBuiltInInstructions({
-                    appSkillId: knownTarget,
-                    onlySkillNames,
-                    skillsAgents,
-                    scope: parsed.scope,
-                    baseDir,
-                    dryRun: parsed.dryRun,
-                    planMode,
-                    mcpUrl: installTarget.loaded.manifest.hosted.mcpUrl,
-                });
+                instructionsWritten = installBuiltInInstructions(builtInInstructionInput);
                 instructionSource = instructionsWritten[0];
                 commands.push(...instructionsWritten.map((dir) => `write ${dir}`));
             }
@@ -2767,27 +2857,30 @@ export async function addAgentNativeSkill(parsed, options = {}) {
             localManifestPath = writeContentLocalFilesManifest(baseDir);
             commands.push(`write ${localManifestPath}`);
         }
-        // Skill instructions are now on disk (built-in folders copied or external
-        // pack materialized) — record the install before MCP registration/connect.
-        options.telemetry?.track("skills_cli install completed", {
-            skills: installTarget.skillNames.join(","),
-            clients: clients.join(","),
-            scope: parsed.scope,
-            dryRun: Boolean(parsed.dryRun),
-        });
+        // Rewind reports completion only after both local writes succeed.
+        if (!installsScreenMemoryMcp) {
+            options.telemetry?.track("skills_cli install completed", {
+                skills: installTarget.skillNames.join(","),
+                clients: clients.join(","),
+                scope: parsed.scope,
+                dryRun: Boolean(parsed.dryRun),
+            });
+        }
         if (shouldRegisterMcp && installsScreenMemoryMcp) {
-            const screenMemoryDir = resolveScreenMemoryStoreDir();
-            if (!screenMemoryDir) {
-                throw new Error("No local Clips Screen Memory store was found. Turn Rewind on in Clips, then run the setup again.");
-            }
             registeredMcpClients = mcpClients.map((client) => {
                 commands.push(`npx @agent-native/core@latest mcp install-screen-memory --client ${client} --scope ${parsed.scope}`);
-                installScreenMemoryForClient(client, screenMemoryDir, baseDir, parsed.scope);
+                (options.installScreenMemory ?? installScreenMemoryForClient)(client, screenMemoryDir, baseDir, parsed.scope);
                 return client;
             });
             options.telemetry?.track("skills_cli mcp registered", {
                 skills: installTarget.skillNames.join(","),
             });
+            options.telemetry?.track("skills_cli install completed", {
+                skills: installTarget.skillNames.join(","),
+                clients: clients.join(","),
+                scope: parsed.scope,
+                dryRun: false,
+            });
         }
         else if (shouldRegisterMcp) {
             commands.push(`npx @agent-native/core@latest app-skill ensure --manifest ${installTarget.loaded.file} --client ${parsed.client} --scope ${parsed.scope} --yes`);
@@ -2898,6 +2991,17 @@ export async function addAgentNativeSkill(parsed, options = {}) {
             githubActionSuggestedCommand,
         };
     }
+    catch (error) {
+        if (rewindSnapshots) {
+            try {
+                restoreInstallPaths(rewindSnapshots, rollbackBoundary);
+            }
+            catch (rollbackError) {
+                throw new AggregateError([error, rollbackError], "Rewind setup failed and its partial installation could not be fully rolled back.");
+            }
+        }
+        throw error;
+    }
     finally {
         fs.rmSync(tmpRoot, { recursive: true, force: true });
         installTarget.cleanup?.();
@@ -3121,11 +3225,48 @@ function readCliVersion() {
         return "unknown";
     }
 }
+function deferCliTelemetry(target) {
+    const trackCalls = [];
+    const exceptionCalls = [];
+    let committed = false;
+    return {
+        telemetry: {
+            track(...args) {
+                if (committed)
+                    target.track(...args);
+                else
+                    trackCalls.push(args);
+            },
+            captureException(...args) {
+                if (committed)
+                    target.captureException(...args);
+                else
+                    exceptionCalls.push(args);
+            },
+            async flush() {
+                if (committed)
+                    await target.flush();
+            },
+        },
+        commit() {
+            if (committed)
+                return;
+            committed = true;
+            for (const args of trackCalls)
+                target.track(...args);
+            for (const args of exceptionCalls)
+                target.captureException(...args);
+            trackCalls.length = 0;
+            exceptionCalls.length = 0;
+        },
+    };
+}
 export async function runSkills(argv, options = {}) {
     const parsed = parseSkillsArgs(argv);
     if (parsed.baseDir) {
         options = { ...options, baseDir: path.resolve(parsed.baseDir) };
     }
+    preflightRewindStore(parsed);
     const clackForLog = parsed.printJson
         ? undefined
         : await import("@clack/prompts");
@@ -3157,13 +3298,20 @@ export async function runSkills(argv, options = {}) {
     // finally so events send on success, error, and cancellation — the CLI is
     // short-lived, so flushing before exit is essential or the events never send.
     const startedAt = Date.now();
-    const telemetry = options.telemetry ??
+    const telemetryTarget = options.telemetry ??
         createCliTelemetry({
             cli: "core",
             cliVersion: readCliVersion(),
             command: parsed.command,
             interactive: shouldPrompt(parsed, options),
         });
+    const deferredTelemetry = deferCliTelemetry(telemetryTarget);
+    const telemetry = deferredTelemetry.telemetry;
+    const deferUntilSkillSelection = parsed.command === "add" &&
+        !parsed.target &&
+        !(parsed.plainSkillNames?.length ?? 0);
+    if (!deferUntilSkillSelection)
+        deferredTelemetry.commit();
     const optionsWithTelemetry = {
         ...options,
         telemetry,
@@ -3198,9 +3346,12 @@ export async function runSkills(argv, options = {}) {
         }
         const targets = await resolveSkillTargets(parsed, optionsWithTelemetry);
         if (!targets) {
+            deferredTelemetry.commit();
             telemetry.track("skills_cli cancelled", { step: "skills" });
             return;
         }
+        preflightResolvedRewindTargets(parsed, targets);
+        deferredTelemetry.commit();
         const preselected = Boolean(parsed.target);
         telemetry.track("skills_cli skills selected", {
             selected: targets.join(","),