@xano/sdk 1.0.6 → 1.0.7

package/dist/{workspace-command-FC4IMLAE.js → workspace-command-MHIIY352.js}

@@ -1,125 +1,126 @@
 import {
   printMicroserviceSection,
   readMicroservices
-} from "./chunk-QXYMDARD.js";
+} from "./chunk-M3NEK3LT.js";
 import {
   fetchWorkspaceBundle
-} from "./chunk-RIN4YY34.js";
-import "./chunk-ATJ2W7DC.js";
-import "./chunk-A7MRZ4GF.js";
-import "./chunk-KPFS3RGM.js";
+} from "./chunk-DXZTL7NA.js";
+import "./chunk-SGK3PTTM.js";
+import "./chunk-B3P25SDP.js";
+import "./chunk-IPNN2KRW.js";
 import "./chunk-LBJA7IEM.js";
+import "./chunk-JI3BLXWQ.js";
+import "./chunk-NV37YGOV.js";
 import {
   confirm
-} from "./chunk-JXVJGF3Y.js";
+} from "./chunk-7M6JP3FS.js";
 import "./chunk-FNLTFOUD.js";
 import {
   listTables
-} from "./chunk-MBDFH7XB.js";
-import "./chunk-NDWVJ2QZ.js";
-import "./chunk-JI3BLXWQ.js";
-import "./chunk-Z4ZGTCCD.js";
-import "./chunk-GOLFAEUV.js";
+} from "./chunk-H2K4GFUS.js";
+import "./chunk-VAGSKUWC.js";
+import "./chunk-2SD4LA22.js";
 import "./chunk-3DRXWLJ5.js";
 import "./chunk-X4DVXBFY.js";
 import {
   listBranches
-} from "./chunk-NPODGBVJ.js";
+} from "./chunk-M2C54ZBC.js";
 import {
   reachableWorkspaces,
   refuseUnreachableWorkspace,
   unreachableWorkspaceMessage
-} from "./chunk-2WBH5HUY.js";
-import "./chunk-QZEAANWP.js";
-import "./chunk-LD6ARK3A.js";
+} from "./chunk-U5M7T6CI.js";
+import "./chunk-GHMLRFRX.js";
+import "./chunk-JOOKM7AH.js";
 import "./chunk-2TFRR6JV.js";
 import {
   resolveOutputTarget,
   secretsPhrase,
   writeExportFile
-} from "./chunk-ENMBEXOP.js";
+} from "./chunk-2ACWDSAQ.js";
 import {
   secretsCarriedBy
 } from "./chunk-IYXL5NYU.js";
-import "./chunk-UD2Z7K6W.js";
+import "./chunk-BZ6WTG3E.js";
 import {
   assertBundleFile,
   assertBundleInput,
   assertEntryFile,
   assertValueFiles,
   loadBundleText
-} from "./chunk-XFBGXB7X.js";
-import "./chunk-WBH4KJWM.js";
-import "./chunk-HCG7NDIL.js";
-import "./chunk-I3VHW6XM.js";
-import "./chunk-WZHLMU6T.js";
-import "./chunk-CCU5CCRX.js";
-import "./chunk-3II44CUJ.js";
-import "./chunk-GWTFI3GA.js";
-import "./chunk-BL3AZ3AP.js";
+} from "./chunk-DG3APBUJ.js";
+import "./chunk-VIJ5D3RC.js";
+import "./chunk-PV25BDCH.js";
+import "./chunk-B2URJBC4.js";
+import "./chunk-S46ODQRA.js";
+import "./chunk-TWVUYS63.js";
+import "./chunk-26LHXLD3.js";
+import "./chunk-ZJOAWRED.js";
+import "./chunk-MBL7CXJ7.js";
 import {
   getAccessToken
-} from "./chunk-YGLMRH5U.js";
-import "./chunk-ITC2R2OT.js";
-import "./chunk-IXFJORNH.js";
-import "./chunk-VW4CWVYX.js";
+} from "./chunk-YH2JVJAO.js";
+import "./chunk-VNDR2T35.js";
+import "./chunk-EPFDY5JU.js";
+import "./chunk-A4R5CAY4.js";
+import "./chunk-LCOCRJ4K.js";
+import "./chunk-WNCW2RNB.js";
+import "./chunk-QGIZLFAS.js";
 import "./chunk-2MNLRIOX.js";
-import "./chunk-Q22BMRPF.js";
-import "./chunk-PL7AIAWS.js";
-import "./chunk-FU3VCE5A.js";
-import "./chunk-VDHA5SSQ.js";
-import "./chunk-PFBXSVZF.js";
-import "./chunk-U6MTGB46.js";
+import "./chunk-AKERAUNH.js";
+import "./chunk-CJDPSCMX.js";
+import "./chunk-ZXRDD3Q2.js";
+import "./chunk-PY722CHR.js";
+import "./chunk-ZGLNHA7T.js";
+import "./chunk-ORGNLQN6.js";
 import "./chunk-ZYJP6BOO.js";
 import "./chunk-QO6BVGS5.js";
-import "./chunk-5TVFLG3C.js";
-import "./chunk-SPKA2LV6.js";
-import "./chunk-7GAIJW62.js";
+import "./chunk-PEX4QZVI.js";
+import "./chunk-MYZRMSPM.js";
 import {
   yesRerun
-} from "./chunk-6X3MY2JP.js";
+} from "./chunk-UYFUIHH3.js";
 import "./chunk-622HUCZT.js";
 import {
   contextFlags
-} from "./chunk-N5I37JFB.js";
-import "./chunk-TTEIDD5Q.js";
-import "./chunk-LL7SGTRC.js";
-import "./chunk-YYC2DZMG.js";
-import "./chunk-PMMHSX4H.js";
+} from "./chunk-3FRGNBOC.js";
+import "./chunk-NDJAKSE7.js";
+import "./chunk-EUUUMY7J.js";
+import "./chunk-5SCPRXFB.js";
+import "./chunk-DIWF7L33.js";
+import "./chunk-D5OZRJ3T.js";
+import "./chunk-EF4MHLEW.js";
 import "./chunk-ZFDZKNGG.js";
 import "./chunk-FWD7AL6N.js";
-import "./chunk-QJM5XZ4K.js";
+import "./chunk-47XT6WQL.js";
 import "./chunk-DXUICABI.js";
+import {
+  bindingFor,
+  fetchOrExplain,
+  httpFailure,
+  parseJsonAnswer
+} from "./chunk-L6HZ67P6.js";
 import {
   describeWrite
 } from "./chunk-4KHEMC32.js";
-import "./chunk-3BBIDW3Y.js";
-import "./chunk-ROY4YAEQ.js";
-import "./chunk-CJDPSCMX.js";
+import "./chunk-FDTET7FZ.js";
 import "./chunk-MFWF2NZJ.js";
 import "./chunk-DNBP4GJN.js";
-import "./chunk-763M6LX3.js";
+import "./chunk-CNZASQPL.js";
 import "./chunk-WAVNUTMT.js";
-import "./chunk-M5CSVB23.js";
-import {
-  writeData
-} from "./chunk-AWQ7BQTQ.js";
-import "./chunk-EUUUMY7J.js";
-import {
-  bindingFor,
-  fetchOrExplain,
-  httpFailure,
-  parseJsonAnswer
-} from "./chunk-YR2I5HGE.js";
-import "./chunk-26MOFAJT.js";
+import "./chunk-ARWMVNDJ.js";
 import "./chunk-LLNZGEFK.js";
+import "./chunk-HU7F56VF.js";
 import "./chunk-MF4W6FHU.js";
 import "./chunk-X2NL4KUO.js";
+import {
+  writeData
+} from "./chunk-4GPIOIAC.js";
 import "./chunk-SKEG3V2V.js";
 import "./chunk-E763QI3G.js";
-import "./chunk-EQFYOOO6.js";
-import "./chunk-M6ZFSTIZ.js";
-import "./chunk-3EDSPMXN.js";
+import "./chunk-BRANWM4U.js";
+import "./chunk-5GIOCDUM.js";
+import "./chunk-LJM5CIY4.js";
 import "./chunk-7THDHQ4R.js";
 import "./chunk-3YW23UFH.js";
 import "./chunk-7REDHC4N.js";
@@ -142,7 +143,7 @@ import {
   warn,
   writeJson,
   writeTargetPayload
-} from "./chunk-D7BUMOKU.js";
+} from "./chunk-CH23ONYG.js";
 import "./chunk-FQ53GTII.js";
 import "./chunk-VJFMUJWZ.js";
 import "./chunk-6JAEMMZ7.js";
@@ -172,8 +173,8 @@ import "./chunk-UDZX2ZL4.js";
 import "./chunk-ZY55DO5P.js";
 import "./chunk-A2AOUBJS.js";
 import "./chunk-TFFGOFVZ.js";
-import "./chunk-EHP3WPEG.js";
 import "./chunk-7VR4IO5B.js";
+import "./chunk-EHP3WPEG.js";
 import "./chunk-D3KEPRRN.js";
 import "./chunk-Q7DGTQ5G.js";
 import "./chunk-4XHAT7C5.js";
@@ -202,7 +203,7 @@ async function runWorkspaceCommand(args) {
     case "reset-tables":
       return runResetTables(args);
     case "branch": {
-      const { runBranchCommand } = await import("./branch-commands-KTKAXBAN.js");
+      const { runBranchCommand } = await import("./branch-commands-EGY7ZEZE.js");
       return runBranchCommand(args);
     }
     default:
@@ -231,7 +232,7 @@ async function runDetails(args) {
   const auth = await getAccessToken(args);
   const workspaceId = auth.workspaceId;
   const all = await fetchWorkspaces(auth).catch(async (err) => {
-    const { unansweredRead } = await import("./source-resolve-MKLNYFWG.js");
+    const { unansweredRead } = await import("./source-resolve-BBHYTOXI.js");
     throw unansweredRead(err, "read the workspace list", "workspace");
   });
   const match = all.find((w) => w.id === workspaceId);
@@ -291,7 +292,7 @@ async function runExport(args) {
 var EXIT_DIFF_MISMATCH = 2;
 async function runDiff(args) {
   if (args.file === void 0 && args.bundle === void 0) {
-    const { resolveProjectEntry } = await import("./deploy-source-YLQ7WMYR.js");
+    const { resolveProjectEntry } = await import("./deploy-source-HYVZEYXV.js");
     const entry = resolveProjectEntry(process.cwd());
     if (entry !== void 0) args = { ...args, file: entry };
   }
@@ -304,11 +305,11 @@ async function runDiff(args) {
   try {
     live = await fetchWorkspaceBundle(auth, args.branch);
   } catch (err) {
-    const { unansweredRead } = await import("./source-resolve-MKLNYFWG.js");
+    const { unansweredRead } = await import("./source-resolve-BBHYTOXI.js");
     throw unansweredRead(err, "read the workspace to compare", "workspace");
   }
   const { compareToLive, SETTINGS_LABEL } = await import("./live-diff-5E2BQWQ7.js");
-  const { codePinnedCanonicals, releaseCanonicalLock } = await import("./release-command-BQ6OHS3P.js");
+  const { codePinnedCanonicals, releaseCanonicalLock } = await import("./release-command-7F5TBKO2.js");
   const pinned = codePinnedCanonicals(local.bundle, releaseCanonicalLock(args), args.file !== void 0);
   const result = compareToLive(
     JSON.parse(local.bundle),
@@ -327,8 +328,8 @@ async function runDiff(args) {
   const liveLabel = listed?.find((b) => b.live)?.label;
   const comparedLabel = args.branch ?? liveLabel;
   const comparedIsLive = args.branch === void 0 ? true : liveLabel === void 0 ? null : args.branch === liveLabel;
-  const { landingLockPath } = await import("./landing-record-MWXFIRCP.js");
-  const { readSyncBaseline, storedBranchLabel } = await import("./sync-record-PRXHLK4S.js");
+  const { landingLockPath } = await import("./landing-record-TPPYFQAS.js");
+  const { readSyncBaseline, storedBranchLabel } = await import("./sync-record-RGHK7EAL.js");
   const { syncDirection } = await import("./sync-baseline-DOV5AGIO.js");
   const syncLabel = storedBranchLabel(listed, args.branch);
   const baseline = syncLabel === void 0 ? void 0 : readSyncBaseline(landingLockPath(args, args.file !== void 0 ? { entryFile: args.file } : {}), {
@@ -438,7 +439,7 @@ Pass the entry file: \`xanosdk workspace reset-tables ./index.ts --table <guid>
   const local = await loadBundleText(args.write === true && !willRefuse ? args : { ...args, lockReadOnly: true }, target, {
     withSeed: true
   });
-  const { seedRowsByTableGuid } = await import("./seed-SZ6OS5DQ.js");
+  const { seedRowsByTableGuid } = await import("./seed-FRKMDN2Z.js");
   const seeds = seedRowsByTableGuid(local.content);
   const declared = projectTables(local.bundle);
   const unknown = guids.filter((guid) => !declared.some((t) => t.guid === guid));
@@ -475,7 +476,7 @@ ${declared.map((t) => `  ${t.guid}  ${t.name}${seeds.has(t.guid) ? "  (seeded)"
     );
   }
   const destination = credentialWriteTarget(auth);
-  const { countTableRows } = await import("./table-DC36QA4Y.js");
+  const { countTableRows } = await import("./table-OAYGFGEN.js");
   const planned = await Promise.all(
     guids.map(async (guid) => {
       const table = byGuid.get(guid);
@@ -514,7 +515,7 @@ ${declared.map((t) => `  ${t.guid}  ${t.name}${seeds.has(t.guid) ? "  (seeded)"
       return;
     }
   }
-  const { truncateTable, insertTableRows } = await import("./table-DC36QA4Y.js");
+  const { truncateTable, insertTableRows } = await import("./table-OAYGFGEN.js");
   const done = [];
   for (const t of planned) {
     step(`Resetting ${t.name}`);
@@ -564,4 +565,4 @@ export {
   EXIT_DIFF_MISMATCH,
   runWorkspaceCommand
 };
-//# sourceMappingURL=workspace-command-FC4IMLAE.js.map
+//# sourceMappingURL=workspace-command-MHIIY352.js.map

package/dist/{workspace-env-N4ZPFT6A.js → workspace-env-LLRWCHSA.js}

@@ -14,29 +14,29 @@ import {
   renderWorkspaceEnvFile,
   valueProblem,
   workspaceEnvPathIn
-} from "./chunk-HCG7NDIL.js";
-import "./chunk-TTEIDD5Q.js";
-import "./chunk-LL7SGTRC.js";
-import "./chunk-YYC2DZMG.js";
-import "./chunk-PMMHSX4H.js";
+} from "./chunk-PV25BDCH.js";
+import "./chunk-5SCPRXFB.js";
+import "./chunk-DIWF7L33.js";
+import "./chunk-D5OZRJ3T.js";
+import "./chunk-EF4MHLEW.js";
 import "./chunk-ZFDZKNGG.js";
 import "./chunk-FWD7AL6N.js";
-import "./chunk-QJM5XZ4K.js";
+import "./chunk-47XT6WQL.js";
 import "./chunk-DXUICABI.js";
+import "./chunk-L6HZ67P6.js";
 import "./chunk-4KHEMC32.js";
-import {
-  projectRootFrom
-} from "./chunk-ROY4YAEQ.js";
 import "./chunk-DNBP4GJN.js";
-import "./chunk-763M6LX3.js";
+import "./chunk-CNZASQPL.js";
 import "./chunk-WAVNUTMT.js";
-import "./chunk-YR2I5HGE.js";
 import "./chunk-LLNZGEFK.js";
+import {
+  projectRootFrom
+} from "./chunk-HU7F56VF.js";
 import "./chunk-MF4W6FHU.js";
 import "./chunk-X2NL4KUO.js";
-import "./chunk-M6ZFSTIZ.js";
-import "./chunk-3EDSPMXN.js";
-import "./chunk-D7BUMOKU.js";
+import "./chunk-5GIOCDUM.js";
+import "./chunk-LJM5CIY4.js";
+import "./chunk-CH23ONYG.js";
 import {
   isRepresentableName,
   safeNames
@@ -68,4 +68,4 @@ export {
   valueProblem,
   workspaceEnvPathIn
 };
-//# sourceMappingURL=workspace-env-N4ZPFT6A.js.map
+//# sourceMappingURL=workspace-env-LLRWCHSA.js.map

package/dist/{workspace-export-3A5BZTPS.js → workspace-export-BIKAYHWJ.js}

@@ -1,13 +1,13 @@
 import {
   assertBranchReadSupported,
   exportWorkspaceBundle
-} from "./chunk-GOLFAEUV.js";
+} from "./chunk-2SD4LA22.js";
 import "./chunk-3DRXWLJ5.js";
 import "./chunk-X4DVXBFY.js";
-import "./chunk-YR2I5HGE.js";
+import "./chunk-L6HZ67P6.js";
 import "./chunk-MF4W6FHU.js";
 import "./chunk-X2NL4KUO.js";
-import "./chunk-D7BUMOKU.js";
+import "./chunk-CH23ONYG.js";
 import "./chunk-YHB34BN6.js";
 import "./chunk-UTI5G6OJ.js";
 import "./chunk-5ZSO4T2G.js";
@@ -18,4 +18,4 @@ export {
   assertBranchReadSupported,
   exportWorkspaceBundle
 };
-//# sourceMappingURL=workspace-export-3A5BZTPS.js.map
+//# sourceMappingURL=workspace-export-BIKAYHWJ.js.map

package/dist/{writable-D7KCZI5N.js → writable-UOTO4WWC.js}

@@ -5,9 +5,9 @@ import {
   unreadableError,
   unwritableBlocker,
   unwritableError
-} from "./chunk-5TVFLG3C.js";
+} from "./chunk-PEX4QZVI.js";
 import "./chunk-FWD7AL6N.js";
-import "./chunk-D7BUMOKU.js";
+import "./chunk-CH23ONYG.js";
 import "./chunk-YHB34BN6.js";
 import "./chunk-UTI5G6OJ.js";
 import "./chunk-5ZSO4T2G.js";
@@ -22,4 +22,4 @@ export {
   unwritableBlocker,
   unwritableError
 };
-//# sourceMappingURL=writable-D7KCZI5N.js.map
+//# sourceMappingURL=writable-UOTO4WWC.js.map

package/dist/{xanosdk-import-P2A2KSXM.js → xanosdk-import-S7A3CVBN.js}

@@ -13,15 +13,15 @@ import {
   resetXanoSdkImportDetection,
   withDefaultBranchPointer,
   xanosdkImport
-} from "./chunk-ND43ZOS3.js";
+} from "./chunk-567KK6XF.js";
 import "./chunk-3DRXWLJ5.js";
 import "./chunk-X4DVXBFY.js";
-import "./chunk-BL3AZ3AP.js";
+import "./chunk-MBL7CXJ7.js";
+import "./chunk-L6HZ67P6.js";
 import "./chunk-4KHEMC32.js";
-import "./chunk-YR2I5HGE.js";
 import "./chunk-MF4W6FHU.js";
 import "./chunk-X2NL4KUO.js";
-import "./chunk-D7BUMOKU.js";
+import "./chunk-CH23ONYG.js";
 import "./chunk-7FIMUFBP.js";
 import "./chunk-H2V3N23D.js";
 import "./chunk-3JDU4VRL.js";
@@ -53,4 +53,4 @@ export {
   withDefaultBranchPointer,
   xanosdkImport
 };
-//# sourceMappingURL=xanosdk-import-P2A2KSXM.js.map
+//# sourceMappingURL=xanosdk-import-S7A3CVBN.js.map

package/dist/{xanosdk-project-6AGMW2SL.js → xanosdk-project-J4VCFRHP.js}

@@ -3,29 +3,29 @@ import {
   enterProjectRoot,
   isProjectDir,
   projectDirFrom
-} from "./chunk-CCU5CCRX.js";
-import "./chunk-TTEIDD5Q.js";
-import "./chunk-LL7SGTRC.js";
-import "./chunk-YYC2DZMG.js";
-import "./chunk-PMMHSX4H.js";
+} from "./chunk-ZJOAWRED.js";
+import "./chunk-EUUUMY7J.js";
+import "./chunk-5SCPRXFB.js";
+import "./chunk-DIWF7L33.js";
+import "./chunk-D5OZRJ3T.js";
+import "./chunk-EF4MHLEW.js";
 import "./chunk-ZFDZKNGG.js";
 import "./chunk-FWD7AL6N.js";
-import "./chunk-QJM5XZ4K.js";
+import "./chunk-47XT6WQL.js";
 import "./chunk-DXUICABI.js";
+import "./chunk-L6HZ67P6.js";
 import "./chunk-4KHEMC32.js";
-import "./chunk-ROY4YAEQ.js";
 import "./chunk-DNBP4GJN.js";
-import "./chunk-763M6LX3.js";
+import "./chunk-CNZASQPL.js";
 import "./chunk-WAVNUTMT.js";
-import "./chunk-EUUUMY7J.js";
-import "./chunk-YR2I5HGE.js";
-import "./chunk-26MOFAJT.js";
+import "./chunk-ARWMVNDJ.js";
 import "./chunk-LLNZGEFK.js";
+import "./chunk-HU7F56VF.js";
 import "./chunk-MF4W6FHU.js";
 import "./chunk-X2NL4KUO.js";
-import "./chunk-M6ZFSTIZ.js";
-import "./chunk-3EDSPMXN.js";
-import "./chunk-D7BUMOKU.js";
+import "./chunk-5GIOCDUM.js";
+import "./chunk-LJM5CIY4.js";
+import "./chunk-CH23ONYG.js";
 import "./chunk-YHB34BN6.js";
 import "./chunk-UTI5G6OJ.js";
 import "./chunk-5ZSO4T2G.js";
@@ -39,4 +39,4 @@ export {
   isProjectDir,
   projectDirFrom
 };
-//# sourceMappingURL=xanosdk-project-6AGMW2SL.js.map
+//# sourceMappingURL=xanosdk-project-J4VCFRHP.js.map

package/guides/README.md

@@ -6,13 +6,13 @@ typed, so your editor's autocomplete is usually the faster lookup — tab-comple
 
 | Guide | What's in it |
 |---|---|
-| [The scaffolded project](scaffold.md) | What `xanosdk init` writes, the two frontend presets, add-ons, SvelteKit rules |
+| [The scaffolded project](scaffold.md) | What `xanosdk init` writes, the two frontend presets, no frontend, existing apps, add-ons, SvelteKit rules |
 | [Project structure](project-structure.md) | How a `xano/` project is laid out, and why registration is explicit |
 | [The marketplace](marketplace.md) | Finding add-ons, the two kinds of module, and the install/reinstall/remove lifecycle |
 | [The module contract](module-contract.md) | Building an add-on: the manifest fields, the plugin types, every hook, and what is refused |
 | [Object kinds](object-kinds.md) | Every authorable kind, and splitting a workspace across microservices |
 | [Authoring reference](authoring.md) | Tables and fields, statements, values, inputs, middleware, request history |
-| [CLI](cli.md) | Every command, shell completion, and what failures look like |
+| [CLI](cli.md) | Every command, the agent skill, shell completion, and what failures look like |
 | [Warning and error codes](codes.md) | Every code the CLI and the build emit, with what it means (generated) |
 | [Signing in & deploying](deploying.md) | Auth, ephemerals, `--static`, releasing to production, `xanosdk preflight` |
 | [Environment & identity](environment.md) | Every environment variable, and how `xano.lock` pins identity |

package/guides/cli.md

@@ -9,6 +9,8 @@ with `@xano/sdk` installed, run them as `npx xanosdk …`; anywhere else, `npx @
 ```bash
 xanosdk init my-app                         # scaffold a full project (frontend/ + xano/)
 xanosdk init my-app --framework svelte      # SvelteKit instead of the default React
+xanosdk init my-api --framework none        # a new project with the backend only (no frontend/)
+xanosdk init                                # inside an existing app: add xano/ and the xano:* scripts, no frontend (lists clashes and writes nothing; --force overwrites)
 xanosdk init my-app --no-agents-md --no-install  # skip AGENTS.md and npm install
 xanosdk init my-app --theme zinc-blue --dark toggle --icons tabler  # the look
 xanosdk init my-app --marketplace @xano-sdk/auth,@xano-sdk/vector  # install add-ons AND register them
@@ -62,6 +64,8 @@ xanosdk deploy ./xano/index.ts --local=~/Downloads/engine.tar.gz   # override: r
 XANOSDK_ENGINE_OVERRIDE=v0.1.8 npm run xano:deploy   # the same override for every deploy in the shell
 xanosdk local list                   # Xano Engines on this machine, marking the ones xanosdk started
 xanosdk local token                  # print its meta API bearer: XANO_META_TOKEN=$(xanosdk local token)
+xanosdk local mcp                    # how a coding agent connects to its MCP server (url, command, config); never the bearer
+xanosdk local mcp --stdio            # the bridge an agent's .mcp.json launches: follows restarts, brings the current bearer
 xanosdk local stop <name>            # stop one (--all: every one xanosdk started, and what a crashed one left running)
 xanosdk local update                 # move this project's pinned engine to the latest (--version <v>: that one) and restart it — commit package.json
 xanosdk local cache list             # each cached engine version, its size, and the engines running on it
@@ -133,6 +137,9 @@ xanosdk logout                              # revoke the active profile and remo
 xanosdk version                             # print the installed @xano/sdk version
 xanosdk upgrade --check                     # is a newer @xano/sdk published? exits 7 if so, 0 if current
 xanosdk upgrade                             # install it: globally (npm i -g) for a global CLI; in a project, into the block that lists it (--save-prod or --save-dev)
+xanosdk agent-skill install                 # put the xano-backend skill into each coding agent detected on this machine (--agent <id> to pick)
+xanosdk agent-skill status                  # each copy: current, stale, edited or absent
+xanosdk agent-skill uninstall               # remove the copies install wrote (an edited copy is kept)
 xanosdk help                                # grouped command reference (also the no-arg default)
 xanosdk <command> --help                    # that command's usage, subcommands, and flags (`xanosdk deploy --help`)
 xanosdk <noun> <verb> --help                # scoped to one verb (`xanosdk workspace export --help`)
@@ -320,6 +327,68 @@ caret) and restamps the managed blocks in your
 outside a project, it installs nothing (`status: "not-installed"`): that copy is temporary,
 and `npx @xano/sdk@latest` already runs the newest release.
 
+## Adding the backend to an existing app
+
+`init` decides what to write from its target directory. An empty or missing directory is a
+**new** project: a full app, `react` unless `--framework` says otherwise, with a framework
+prompt on a terminal whose choices include "No frontend" (`--framework none`, the backend
+alone). Any other directory is an **existing** project: `init` writes `xano/` and merges the
+`xano:*` scripts and the backend's dependencies into its `package.json`, with no prompt and no
+frontend. [The scaffolded project](scaffold.md#no-frontend-and-existing-apps) lists exactly
+what each mode writes and merges.
+
+Each of these is a **clash**: an existing `xano/`, any other file `init` would write that is
+already there, and a `xano:*` script the project defines with another command. `init` lists
+every clash and writes nothing. `--force` lists what it would overwrite and asks first
+(`--yes` answers without a terminal).
+
+`--framework react` or `--framework svelte` is refused in an existing project, and the
+frontend-only flags (`--theme`, `--radius`, `--dark`, `--font`, `--font-mono`,
+`--font-heading`, `--icons`) are refused wherever no frontend is written, rather than
+silently ignored. `init --from` follows the same two modes
+([Pulling an existing workspace](codegen.md#running-it)).
+
+```bash
+xanosdk init --json   # inside the app; then run the command in `next`
+```
+
+`init --json` reports `mode` (`new` or `existing`), `files` (every file it wrote or merged
+into, relative to the project) and `next` (the command to run next: the install when one is
+still needed, then `xano:deploy`).
+
+## The agent skill
+
+`xano-backend` is an agent skill for coding agents such as Claude Code, Codex and Cursor: it
+tells the agent when to set up a Xano backend and hands it to `init`, then to the project's
+`AGENTS.md` and `llms.txt`. It is not a `knowledge()` def; those are docs your workspace's own
+AI agents read. The package ships it at `skills/xano-backend/SKILL.md`.
+
+```bash
+xanosdk agent-skill install                       # every coding agent detected on this machine
+xanosdk agent-skill install --agent claude-code   # …or name one (repeatable)
+xanosdk agent-skill install --dry-run             # report what would change, write nothing
+xanosdk agent-skill status --json                 # each copy, as data
+xanosdk agent-skill uninstall
+```
+
+It writes at most two copies. Claude Code reads `~/.claude/skills/xano-backend/SKILL.md`
+(under `$CLAUDE_CONFIG_DIR` when that is set). Codex, Cursor, Copilot, Gemini CLI, Amp and
+OpenCode read the shared `~/.agents/skills/xano-backend/SKILL.md`. An agent is detected by its
+home config directory; `--agent` takes `claude-code`, `agents` (the shared directory),
+`codex`, `cursor`, `copilot`, `gemini`, `amp` or `opencode` instead. When no agent is detected
+and none is named, `install` refuses.
+
+Each copy carries the SDK version and a digest. `status` reports a copy as **current**,
+**stale** (an older version, unedited), **edited** (changed since it was installed) or
+**absent**. `install` writes a missing or stale copy and leaves a current one unchanged; it
+leaves an edited copy alone unless `--force`. `uninstall` removes only unedited copies. A
+symlinked skill directory belongs to another installer, and neither command touches it.
+Nothing prompts, so both run unattended; `--json` reports one entry per target.
+
+The skill also installs without the CLI, from the public repository:
+`npx skills add xano-sdk/sdk`, or in Claude Code `/plugin marketplace add xano-sdk/sdk`
+followed by `/plugin install xano@xano-sdk`.
+
 ## Checking what an installed SDK can do
 
 A tool that drives the CLI, such as an editor extension or a CI step, should check that the

package/guides/codegen.md

@@ -18,10 +18,27 @@ xanosdk init my-app --from ./ws.json          # a bundle already on disk — off
 `workspace`, `ephemeral[:<name>]`, `local[:<name>]`, `tenant:<name>`, `release:<name>` —
 or a bundle path. Unlike most commands it has no default: a pull names its source.
 
-Everything else about the project is unchanged: `--framework`, the theme flags, `--no-agents-md` and
-`--web` mean the same thing here as they do without `--from`. The three flags that describe
-the pull itself — `--report`, `--skip-roundtrip` and `--branch` — are refused without it rather
-than silently ignored.
+Everything else about the project is unchanged: `--framework` (`react`, `svelte` or `none`), the
+theme flags, `--no-agents-md` and `--web` mean the same thing here as they do without `--from`.
+The three flags that describe the pull itself — `--report`, `--skip-roundtrip` and `--branch` —
+are refused without it rather than silently ignored.
+
+The target directory decides what is written around `xano/`, as it does for a plain
+[`init`](scaffold.md#no-frontend-and-existing-apps):
+
+- **Empty or missing:** a new project, with the frontend `--framework` names (`none` for the
+  backend alone).
+- **A previous pull** (`xano/.xanosdk-codegen.json` is there): `xano/` is refreshed in place —
+  see [Verification, and the decode report](#verification-and-the-decode-report) below.
+- **Anything else:** an existing app, which gets the backend only. The decoded `xano/` is
+  written, and the `xano:*` scripts and the backend's dependencies are merged into its
+  `package.json`. An existing `xano/`, a file the pull would write, or a `xano:*` script with
+  another command is a clash: all of them are listed and nothing is read or written unless
+  `--force`. `--framework react|svelte` and the frontend-only flags are refused.
+
+```bash
+cd my-existing-app && npx @xano/sdk init --from workspace   # add the pulled backend to this app
+```
 
 ### Just the tree: `generate`
 
@@ -168,7 +185,8 @@ are listed), then updated from the new tree, so `export --check` passes after it
 over a `xano/` no decode wrote follows the same rules.
 
 > ⚠️ **`xano/` is your source once pulled — commit it.** A refresh overwrites the files it
-> decodes, so commit before one (a directory that isn't a previous pull still needs `--force`).
+> decodes, so commit before one (an existing `xano/` that isn't a previous pull is a clash, and
+> needs `--force`).
 > It carries schema only — no table rows or stored files.
 > `xanosdk deploy` sends it to the Xano Engine on this machine (`--ephemeral`: a disposable
 > ephemeral environment) as a *full replace*;

package/guides/codes.md

@@ -133,6 +133,7 @@ Printed as `! …` on stderr, and as `{ code, message }` in a `--json` document'
 | `logout.revoke-failed` | Did not revoke …: … The token was not sent. |
 | `logout.shared-file` | Clearing … in the shared credential file … — this affects every project that reuses it. |
 | `logout.unreadable` | Could not read … (…). |
+| `merge.symlink` | … is a symlink — left it and its target untouched. |
 | `microservice.failed` | Some microservices failed to start: |
 | `microservice.starting` | Microservices are still starting (…/… ready) — they should come up shortly: |
 | `microservice.status-unreadable` | Could not read microservice status (the backend deployed fine): |

package/guides/coverage.md

@@ -72,3 +72,8 @@ can learn the SDK without reading source:
 Both derive from the SDK's own sources of truth (so they can't drift), regenerate with
 `npm run manifest`, and are available at runtime via `buildManifest()` / `renderLlmsTxt()`,
 both exported from `@xano/sdk/internal`.
+
+The package also ships the `xano-backend` agent skill at `skills/xano-backend/SKILL.md`. It
+carries no reference of its own: it tells a coding agent when to set up a Xano backend, runs it
+through `init` and the first deploy, and hands it to the project's `AGENTS.md` and `llms.txt`.
+Installing it is in the [CLI guide](cli.md#the-agent-skill).