@xano/sdk 1.0.13 → 1.0.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (246) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/README.md +28 -28
  3. package/dist/.build-fingerprint +1 -1
  4. package/dist/{agent-file-refresh-DAFGNMQX.js → agent-file-refresh-ZRGNOA6Q.js} +12 -11
  5. package/dist/{agent-skill-command-6M46ZGOL.js → agent-skill-command-DV26SDA2.js} +51 -50
  6. package/dist/{answer-shape-CBUQRSXI.js → answer-shape-AVZSKBR6.js} +4 -4
  7. package/dist/{backend-dir-J2J7JNS6.js → backend-dir-NTMXWE5R.js} +11 -10
  8. package/dist/{backend-slot-X5AUX2TT.js → backend-slot-DZAUHLTS.js} +3 -3
  9. package/dist/bin.js +47 -46
  10. package/dist/{branch-YS2K3VOB.js → branch-IJTBZZFO.js} +8 -8
  11. package/dist/{branch-commands-BUKVE637.js → branch-commands-4PJEBNRK.js} +26 -25
  12. package/dist/{chunk-PCHIHVX6.js → chunk-2LF734YB.js} +4 -4
  13. package/dist/{chunk-ENBGJJJH.js → chunk-3GZMP7II.js} +9 -9
  14. package/dist/{chunk-R7XZW4SB.js → chunk-3H7R4ISR.js} +2 -2
  15. package/dist/{chunk-DB7P2SSK.js → chunk-45K2QZBR.js} +3 -3
  16. package/dist/{chunk-C2SAVXAB.js → chunk-4MX5LMPQ.js} +2 -2
  17. package/dist/{chunk-IZI3SYXH.js → chunk-5FJ4M4HB.js} +38 -38
  18. package/dist/{chunk-FBWMKHLO.js → chunk-5SJQAJLF.js} +3 -3
  19. package/dist/{chunk-E763QI3G.js → chunk-5SKWGCAJ.js} +2 -2
  20. package/dist/{chunk-JKGRQW6D.js → chunk-5W7S2SCA.js} +4 -4
  21. package/dist/{chunk-KICERNAP.js → chunk-66ZU2CD5.js} +4 -4
  22. package/dist/{chunk-F2NFNYCB.js → chunk-6EFXPTHT.js} +3 -3
  23. package/dist/{chunk-CTUIMNEM.js → chunk-6X73VFCX.js} +2 -2
  24. package/dist/{chunk-VTMTIBKP.js → chunk-74OPNM2Z.js} +2 -2
  25. package/dist/{chunk-DZUNF7IH.js → chunk-75QC66XI.js} +2 -2
  26. package/dist/{chunk-U4BGBU3R.js → chunk-7AKH4QDJ.js} +44 -44
  27. package/dist/{chunk-CGZSF756.js → chunk-7ZQ73AHJ.js} +28 -28
  28. package/dist/{chunk-5SMUND4J.js → chunk-A2N2C2WD.js} +6 -6
  29. package/dist/{chunk-XL7EA62X.js → chunk-AE5CRAKS.js} +5 -5
  30. package/dist/{chunk-5ONWBQ2C.js → chunk-ASQX477B.js} +7 -7
  31. package/dist/{chunk-JFPLHK6Y.js → chunk-AXMUYBWQ.js} +2 -2
  32. package/dist/{chunk-5XDKKE5Y.js → chunk-B6AFJVG4.js} +4 -4
  33. package/dist/{chunk-4CS4DKQC.js → chunk-BEKEOXNG.js} +2 -2
  34. package/dist/{chunk-ZSMHS7BU.js → chunk-CJGLAQRD.js} +4 -4
  35. package/dist/{chunk-M7DIIJPW.js → chunk-DBDTQR23.js} +4 -4
  36. package/dist/{chunk-RZABQ4YH.js → chunk-DGYXCIBV.js} +4 -4
  37. package/dist/{chunk-P6HXDOFG.js → chunk-DH6O5NQU.js} +13 -13
  38. package/dist/{chunk-I2AVVARA.js → chunk-ECQXASG3.js} +2 -2
  39. package/dist/{chunk-2BHYGUTI.js → chunk-EQXHUWUO.js} +2 -2
  40. package/dist/{chunk-EGEANMMK.js → chunk-FIERONKM.js} +2 -2
  41. package/dist/{chunk-A2AOUBJS.js → chunk-FKQX6KU7.js} +3 -2
  42. package/dist/{chunk-UECNKDDA.js → chunk-FOBVJ2UR.js} +8 -8
  43. package/dist/{chunk-GRWYO2MS.js → chunk-FXZEZAV2.js} +3 -3
  44. package/dist/{chunk-H6VVSGKN.js → chunk-G4WRZU5T.js} +7 -7
  45. package/dist/{chunk-K6BQPFRS.js → chunk-GBSHHNSD.js} +3 -3
  46. package/dist/{chunk-N3XSXGAL.js → chunk-GCINMMFL.js} +2 -2
  47. package/dist/{chunk-WZXEQUIM.js → chunk-GDJCWQIK.js} +2 -2
  48. package/dist/{chunk-ZACMAKZE.js → chunk-GIQIMWTK.js} +14 -14
  49. package/dist/{chunk-POZ6V4MU.js → chunk-GKQTXUOW.js} +2 -2
  50. package/dist/{chunk-D4VKPOD4.js → chunk-GRXX2TOJ.js} +13 -112
  51. package/dist/{chunk-YJK4NPXC.js → chunk-GVHWIDEJ.js} +3 -3
  52. package/dist/{chunk-UKC65HBQ.js → chunk-HCNIB3EC.js} +4 -4
  53. package/dist/{chunk-DILYWJVP.js → chunk-HXFLHA5K.js} +2 -2
  54. package/dist/{chunk-FLDFKG24.js → chunk-IKXXTRMN.js} +4 -4
  55. package/dist/{chunk-QWWQM4XZ.js → chunk-JAYHFXWH.js} +7 -7
  56. package/dist/{chunk-6LECAG3Y.js → chunk-JWASCOHO.js} +4 -4
  57. package/dist/{chunk-DPSR5GRE.js → chunk-K6SWZ6H4.js} +49 -49
  58. package/dist/{chunk-VA4JK4TW.js → chunk-KMKUH2IO.js} +3 -3
  59. package/dist/{chunk-UFFIU57H.js → chunk-LSJ3SQEU.js} +4 -4
  60. package/dist/{chunk-JHQAVWHW.js → chunk-M7O3T7IM.js} +2 -2
  61. package/dist/{chunk-BXVNRUDB.js → chunk-MGG4CHO4.js} +3 -3
  62. package/dist/{chunk-7NNLRNXE.js → chunk-MIS6F4HM.js} +4 -4
  63. package/dist/{chunk-6HTXQAMG.js → chunk-N72XNQNJ.js} +14 -14
  64. package/dist/{chunk-H7GMGZHI.js → chunk-NDV6CBR7.js} +2 -2
  65. package/dist/{chunk-6OOZJQJK.js → chunk-NNI5R6V6.js} +68 -68
  66. package/dist/{chunk-IFXPHVPY.js → chunk-NPYYDTXS.js} +3 -3
  67. package/dist/{chunk-DYGRTWAI.js → chunk-O44MJTLR.js} +3 -3
  68. package/dist/{chunk-HDANNK4A.js → chunk-OZWAITII.js} +9 -9
  69. package/dist/{chunk-ONNSFD73.js → chunk-P7GKTV7N.js} +10 -10
  70. package/dist/{chunk-373AVIL2.js → chunk-QAEBBTYR.js} +7 -7
  71. package/dist/{chunk-3ZVSOZZC.js → chunk-QRMKQYCB.js} +2 -2
  72. package/dist/{chunk-TANWE2ZY.js → chunk-QW7NGUYW.js} +80 -80
  73. package/dist/{chunk-U4DSFCH5.js → chunk-R3GPRNBT.js} +2 -2
  74. package/dist/{chunk-SBS2IYTN.js → chunk-RBTZEHXF.js} +3 -3
  75. package/dist/{chunk-XFQAA2SU.js → chunk-RVAEPPRH.js} +2 -2
  76. package/dist/{chunk-W5MKVFBQ.js → chunk-RXNMZM6H.js} +5 -5
  77. package/dist/{chunk-6QJORUHC.js → chunk-RYWNNJK5.js} +2 -2
  78. package/dist/{chunk-NZ7ML6LG.js → chunk-SH4RY6QX.js} +290 -98
  79. package/dist/{chunk-ZGNWMGN3.js → chunk-SHHXLI2K.js} +26 -8
  80. package/dist/{chunk-MLKJUEG3.js → chunk-SL55XKVL.js} +23 -23
  81. package/dist/{chunk-H5FAYLCR.js → chunk-SPLRKCFV.js} +2 -2
  82. package/dist/{chunk-XYVPF63S.js → chunk-SXMZNSQ6.js} +8 -8
  83. package/dist/{chunk-NMHTB346.js → chunk-TT6LN55R.js} +36 -10
  84. package/dist/{chunk-B5N6EWOM.js → chunk-TXFOQZUQ.js} +3 -3
  85. package/dist/{chunk-VFRL4G72.js → chunk-UNFQN3TT.js} +3 -3
  86. package/dist/{chunk-EKS7SAZS.js → chunk-UVHSMANV.js} +53 -61
  87. package/dist/{chunk-RQHXYL77.js → chunk-V7WCTXEH.js} +5 -7
  88. package/dist/{chunk-HEMWBHQS.js → chunk-VUWR5YLE.js} +13 -13
  89. package/dist/{chunk-O6PWEJUV.js → chunk-VXHXSGPU.js} +8 -8
  90. package/dist/chunk-VYJYDMY6.js +9 -0
  91. package/dist/{chunk-C4TZP5PQ.js → chunk-WS2X5BB2.js} +5 -5
  92. package/dist/{chunk-P5JF3U65.js → chunk-WS4BA75E.js} +37 -4
  93. package/dist/{chunk-HUEFVPYW.js → chunk-WXKSB2N3.js} +3 -3
  94. package/dist/{chunk-DFCYAEBE.js → chunk-XLP4CNSF.js} +3 -3
  95. package/dist/{chunk-OCNTMJSY.js → chunk-XPSDDTUZ.js} +3 -3
  96. package/dist/{chunk-OBRMA2VK.js → chunk-XY4OBD26.js} +3 -3
  97. package/dist/{chunk-XVOODRNK.js → chunk-Y5XAPLZS.js} +4 -4
  98. package/dist/{chunk-ZISPEBNM.js → chunk-YCKKL5PD.js} +60 -55
  99. package/dist/{chunk-XM56DAM7.js → chunk-YR3MNGWZ.js} +8 -8
  100. package/dist/{chunk-WQZCFVAD.js → chunk-ZC6H2ERE.js} +5 -5
  101. package/dist/{chunk-UDCKYLBW.js → chunk-ZDVVIJPU.js} +4 -4
  102. package/dist/{chunk-ENAUSLMP.js → chunk-ZF2CBXT5.js} +3 -3
  103. package/dist/{chunk-AUYXBKGR.js → chunk-ZOHEHIFS.js} +2 -2
  104. package/dist/{chunk-3RZ4UJWV.js → chunk-ZPJXWMHK.js} +4 -4
  105. package/dist/{chunk-A3CT26GX.js → chunk-ZRXDPCMN.js} +2 -2
  106. package/dist/{chunk-RAGFXELQ.js → chunk-ZYECXDVV.js} +5 -5
  107. package/dist/cli.js +45 -44
  108. package/dist/{codegen-command-BAFON45M.js → codegen-command-RDD4GL35.js} +63 -62
  109. package/dist/codegen.js +2 -2
  110. package/dist/{commands-IFRAGWGK.js → commands-5ILSWDSV.js} +2 -2
  111. package/dist/{completion-RTXCODHS.js → completion-UNKBVVDT.js} +2 -2
  112. package/dist/{config-EHFXNFSP.js → config-NTOASFCA.js} +3 -3
  113. package/dist/{deploy-command-JW7R3BPW.js → deploy-command-BYAZZF37.js} +52 -51
  114. package/dist/{deploy-source-ZUPLAL7L.js → deploy-source-QCPZWNJO.js} +27 -26
  115. package/dist/{dev-env-sync-W7OTV7OD.js → dev-env-sync-6MHK3UHC.js} +46 -45
  116. package/dist/{display-name-hint-BKPMISQU.js → display-name-hint-MYXCCAOP.js} +10 -10
  117. package/dist/{env-example-refresh-TS7WBVZQ.js → env-example-refresh-MQWHY7ZS.js} +64 -63
  118. package/dist/{env-pull-command-5IYXQ2WK.js → env-pull-command-KUIEKBTM.js} +42 -41
  119. package/dist/{env-target-TQBPLU2S.js → env-target-Y77RLRS5.js} +9 -9
  120. package/dist/{env-var-command-AKCWYZPB.js → env-var-command-BZWJD75C.js} +37 -36
  121. package/dist/{ephemeral-CART6DIR.js → ephemeral-VLPRDNEJ.js} +8 -8
  122. package/dist/{ephemeral-command-SJYH6XRS.js → ephemeral-command-SYKDPALW.js} +43 -42
  123. package/dist/{ephemeral-state-HPKSKC4Y.js → ephemeral-state-RUOU2GFS.js} +7 -7
  124. package/dist/{generate-command-FSCFZPOJ.js → generate-command-CSQDQZSW.js} +68 -67
  125. package/dist/{gitignore-6IJ66XME.js → gitignore-OQGYM7DO.js} +15 -14
  126. package/dist/{guards-RU4C7TFG.js → guards-JUYBDLZY.js} +6 -6
  127. package/dist/{impersonate-command-IH4HMSS3.js → impersonate-command-HSFCZBV6.js} +33 -32
  128. package/dist/{import-RUBCGLCA.js → import-T4ZTOTBT.js} +4 -4
  129. package/dist/index.d.ts +105 -109
  130. package/dist/index.js +11 -11
  131. package/dist/{init-command-STB4YSAK.js → init-command-6Z7QNVDY.js} +50 -51
  132. package/dist/{init-modules-YIZYPCMM.js → init-modules-BL2SR5RK.js} +7 -7
  133. package/dist/{init-web-OGKACAOC.js → init-web-DYE2FEXL.js} +2 -2
  134. package/dist/internal.d.ts +2 -2
  135. package/dist/internal.js +68 -62
  136. package/dist/{keep-data-merge-VRKS64JK.js → keep-data-merge-SHF75FC7.js} +24 -24
  137. package/dist/{lambda-config-reconcile-FXPDH2U5.js → lambda-config-reconcile-VOBVZPWS.js} +3 -3
  138. package/dist/{landing-record-5EFK7RI6.js → landing-record-7EOLEKH3.js} +17 -16
  139. package/dist/{live-diff-HARRGFV4.js → live-diff-M2OLXKM6.js} +6 -6
  140. package/dist/{local-engine-choice-TRTEJVMV.js → local-engine-choice-TOC3UYZZ.js} +30 -29
  141. package/dist/{local-engine-command-2FK2PE2P.js → local-engine-command-6KSRDZBR.js} +35 -34
  142. package/dist/{local-engine-deploy-ZZVHBI2X.js → local-engine-deploy-4N4NFZ4T.js} +11 -11
  143. package/dist/{local-engine-lookup-QFRKO35F.js → local-engine-lookup-AQTUGSBT.js} +2 -2
  144. package/dist/{local-engine-mcp-bridge-T2EFRRAF.js → local-engine-mcp-bridge-AMYRH4SY.js} +9 -9
  145. package/dist/{local-engine-mcp-command-FB7EOGG6.js → local-engine-mcp-command-XTP3EATV.js} +41 -48
  146. package/dist/{local-engine-process-XH35DURU.js → local-engine-process-OD5OSWDG.js} +6 -6
  147. package/dist/{local-engine-update-check-HAXE7BVG.js → local-engine-update-check-G3YCBXRE.js} +4 -4
  148. package/dist/{lock-commands-7PBZIRWR.js → lock-commands-437P6BHY.js} +50 -49
  149. package/dist/{login-command-2O6GRMTH.js → login-command-BNRDAVFV.js} +23 -22
  150. package/dist/{logout-command-RZXGW3O2.js → logout-command-FCGCHB7Y.js} +13 -12
  151. package/dist/{loop-QHZD37KX.js → loop-WOAEXMTC.js} +6 -6
  152. package/dist/{marketplace-command-NCMLGIMS.js → marketplace-command-SUBJZPJV.js} +33 -33
  153. package/dist/{marketplace-resolve-HPCRNV5O.js → marketplace-resolve-JR4BBJ6K.js} +5 -5
  154. package/dist/{meta-client-DYYM5F5G.js → meta-client-AYJS3RQ3.js} +10 -10
  155. package/dist/{module-manifest-EFE6JBZW.js → module-manifest-63I5GRK4.js} +3 -3
  156. package/dist/node.d.ts +2 -2
  157. package/dist/node.js +50 -49
  158. package/dist/{operation-outcome-SHNROAFA.js → operation-outcome-ORQPVJKB.js} +19 -19
  159. package/dist/{output-target-PSSR3E4N.js → output-target-KNHHNDM3.js} +16 -15
  160. package/dist/{plan-disclosure-WEMB5ZJ2.js → plan-disclosure-4DUFRGCP.js} +16 -16
  161. package/dist/{plugin-contributions-U5PAZKBE.js → plugin-contributions-YYEP7IWH.js} +4 -4
  162. package/dist/{plugin-prompt-O5PAMV5B.js → plugin-prompt-GKCQKNYI.js} +4 -4
  163. package/dist/{plugin-questions-ZVYNKDRB.js → plugin-questions-P7MA3TYI.js} +3 -3
  164. package/dist/{preflight-command-6F7JF3YQ.js → preflight-command-32GFVKSN.js} +56 -55
  165. package/dist/{profile-command-5AOGD6GV.js → profile-command-U2XTKOMF.js} +24 -23
  166. package/dist/{profile-pointer-VTOZDBHM.js → profile-pointer-JJ7K5O2R.js} +3 -3
  167. package/dist/{project-dependency-EZNTHMWI.js → project-dependency-X3KCWBK5.js} +6 -6
  168. package/dist/{project-sdk-ZGJM4WYQ.js → project-sdk-YHJZRCNB.js} +3 -3
  169. package/dist/promote-command-OO56IZBT.js +148 -0
  170. package/dist/{prompt-F7UVH4GP.js → prompt-QNMJIWNI.js} +3 -3
  171. package/dist/{publish-command-6VVSJPLI.js → publish-command-5ZVZ6IYT.js} +55 -54
  172. package/dist/{pull-command-GE2WUEUF.js → pull-command-LT5PCEIW.js} +66 -65
  173. package/dist/{pull-superseded-77UZ7CHH.js → pull-superseded-6HADGGC5.js} +3 -3
  174. package/dist/{release-command-55RTR674.js → release-command-RBUOXIH7.js} +60 -59
  175. package/dist/{release-ns-command-5XPZ2B6N.js → release-ns-command-LDN5DOKQ.js} +78 -77
  176. package/dist/{retry-command-S5QALD5Z.js → retry-command-LFZYEVRU.js} +7 -7
  177. package/dist/{routes-manifest-ET2TTSCL.js → routes-manifest-BMAOL6WN.js} +6 -6
  178. package/dist/{routes-manifest-file-42FTJHRY.js → routes-manifest-file-MPOVKD6N.js} +9 -9
  179. package/dist/scaffold.d.ts +0 -5
  180. package/dist/scaffold.js +2 -2
  181. package/dist/{secrets-file-N5IF265R.js → secrets-file-7QM3ORGX.js} +15 -14
  182. package/dist/{secrets-fill-command-35WKBURT.js → secrets-fill-command-OZ537VOD.js} +49 -48
  183. package/dist/{seed-5YLQRT2D.js → seed-ATGBOEJP.js} +6 -6
  184. package/dist/{source-resolve-JXGOVJD3.js → source-resolve-QYSWA3QR.js} +17 -17
  185. package/dist/{static-host-TQP3FXPI.js → static-host-MO4VDHL7.js} +4 -4
  186. package/dist/{status-command-G3DFRMU7.js → status-command-IEB4K7ME.js} +60 -34
  187. package/dist/{store-ZE5BXCOW.js → store-AJX4MC7Y.js} +5 -5
  188. package/dist/{store-BM7SQcUt.d.ts → store-DspGMsFY.d.ts} +112 -118
  189. package/dist/{sync-baseline-JGAAOS25.js → sync-baseline-IB7MABZO.js} +7 -7
  190. package/dist/{sync-contributions-7T4CSPVQ.js → sync-contributions-DLV5JZUK.js} +8 -8
  191. package/dist/{sync-record-ILWS44DG.js → sync-record-NE62ERA3.js} +9 -9
  192. package/dist/{table-V3LTQUY6.js → table-TFD4ZQXA.js} +8 -8
  193. package/dist/{tables-command-7NUOZBHX.js → tables-command-IMCVPUFY.js} +35 -34
  194. package/dist/{tenant-7WUS7Q6V.js → tenant-IIYECNWO.js} +9 -9
  195. package/dist/{tenant-command-JGEHRKN7.js → tenant-command-77KG76MU.js} +83 -82
  196. package/dist/{test-command-2LNEA6GK.js → test-command-NSPU4RUO.js} +32 -31
  197. package/dist/{tests-ENFUACKD.js → tests-JWQRHFCT.js} +5 -5
  198. package/dist/{token-DWNH44NW.js → token-BDHD7GU3.js} +9 -8
  199. package/dist/{toolchain-hooks-QIFGPGH2.js → toolchain-hooks-QHJRDCRW.js} +8 -8
  200. package/dist/{toolchain-modules-F4DUMWTO.js → toolchain-modules-LY7BMYG6.js} +4 -4
  201. package/dist/{toolchain-peers-K44IINPG.js → toolchain-peers-FQJBTKEB.js} +7 -7
  202. package/dist/{tracked-backend-ZFXVLBBJ.js → tracked-backend-BIR7YJCE.js} +30 -29
  203. package/dist/{update-check-KBHT63GJ.js → update-check-JDARCXAX.js} +48 -47
  204. package/dist/{upgrade-command-CI543AZP.js → upgrade-command-YCADQCIA.js} +51 -50
  205. package/dist/{whoami-command-77DXENWD.js → whoami-command-IZCTUPM4.js} +12 -11
  206. package/dist/{workspace-RI5C77BZ.js → workspace-TK52V7WO.js} +4 -4
  207. package/dist/{workspace-binding-PR57NBGH.js → workspace-binding-3UT6PP4B.js} +11 -10
  208. package/dist/{workspace-command-6HHVFQKW.js → workspace-command-46OCB6XT.js} +79 -78
  209. package/dist/{workspace-env-2APJEASO.js → workspace-env-PVPOWFNZ.js} +12 -11
  210. package/dist/{workspace-export-GHMUSX2P.js → workspace-export-PUEXKZNS.js} +4 -4
  211. package/dist/{writable-Y6CE2CGK.js → writable-LMMG4AFZ.js} +3 -3
  212. package/dist/{xano-2A2GT7EH.js → xano-EOUVXNQX.js} +7 -7
  213. package/dist/{xanosdk-import-HBQH3ZBS.js → xanosdk-import-XXJT365U.js} +5 -5
  214. package/dist/{xanosdk-project-W45IR3Q7.js → xanosdk-project-CJKRLQ6U.js} +13 -12
  215. package/guides/README.md +3 -3
  216. package/guides/authoring.md +11 -11
  217. package/guides/bundle.md +2 -2
  218. package/guides/cli.md +179 -176
  219. package/guides/codegen.md +17 -17
  220. package/guides/codes.md +3 -3
  221. package/guides/coverage.md +2 -2
  222. package/guides/deploying.md +123 -123
  223. package/guides/environment.md +30 -30
  224. package/guides/marketplace.md +24 -24
  225. package/guides/module-contract.md +9 -9
  226. package/guides/object-kinds.md +4 -4
  227. package/guides/project-structure.md +4 -4
  228. package/guides/scaffold.md +22 -22
  229. package/guides/typed-frontend.md +3 -3
  230. package/llms/client.md +4 -4
  231. package/llms/errors.md +2 -2
  232. package/llms/fields.md +1 -1
  233. package/llms/kinds-agent-mcp.md +1 -1
  234. package/llms/kinds-realtime.md +2 -2
  235. package/llms/lock.md +3 -3
  236. package/llms/statements-calls.md +1 -1
  237. package/llms/statements-catalog.md +57 -57
  238. package/llms/statements-runtime.md +2 -2
  239. package/llms/tests.md +3 -3
  240. package/llms/toolchain.md +2 -2
  241. package/llms-full.txt +113 -110
  242. package/llms.txt +35 -32
  243. package/manifest.json +82 -152
  244. package/package.json +1 -1
  245. package/skills/xano-backend/SKILL.md +7 -7
  246. package/dist/promote-command-O2NRRFLK.js +0 -147
@@ -658,12 +658,12 @@ workspaceConfig({ name: "my-app", env: { STRIPE_KEY: "" } });
658
658
  STRIPE_KEY=sk_live_...
659
659
  ```
660
660
 
661
- `xano/.env.example` is generated beside it listing the declared names, and `xanosdk env pull`
661
+ `xano/.env.example` is generated beside it listing the declared names, and `npx @xano/sdk env pull`
662
662
  fills `xano/.env` from a running backend after confirming. Two flags override the default:
663
663
 
664
664
  ```bash
665
- xanosdk deploy --backend-env-file ci.env # REPLACES the default (CI has no xano/.env)
666
- xanosdk deploy --env-var STRIPE_KEY=sk_live_... # one value, beats both files
665
+ npx @xano/sdk deploy --backend-env-file ci.env # REPLACES the default (CI has no xano/.env)
666
+ npx @xano/sdk deploy --env-var STRIPE_KEY=sk_live_... # one value, beats both files
667
667
  ```
668
668
 
669
669
  A deploy REPLACES the workspace's env set, so a declared name that no file and no flag
@@ -688,15 +688,15 @@ groups that legitimately share a name keep their own tokens.
688
688
 
689
689
  A literal `token` in source fails the export — there is no migration path, because declaring
690
690
  the gate covers every use and the literal form's only distinguishing property is that it commits
691
- a secret. `xanosdk pull` writes the value to the sidecar, reports every scope it carried, and
691
+ a secret. `npx @xano/sdk pull` writes the value to the sidecar, reports every scope it carried, and
692
692
  every build reads it back, so pull-then-deploy restores the gate with no step in between.
693
693
 
694
694
  A gate you write here is the other direction: there is no live value to pull, because the
695
- object has never had one. `xanosdk secrets fill` mints one for every declared gate the sidecar
695
+ object has never had one. `npx @xano/sdk secrets fill` mints one for every declared gate the sidecar
696
696
  has no value for, and leaves every value it already holds alone:
697
697
 
698
698
  ```bash
699
- xanosdk secrets fill # or `xanosdk secrets fill ./xano/index.ts`
699
+ npx @xano/sdk secrets fill # or `npx @xano/sdk secrets fill ./xano/index.ts`
700
700
  ```
701
701
 
702
702
  It writes nothing when every gate is already filled, so it is safe to re-run. A minted token
@@ -734,7 +734,7 @@ values stay inert. Two consequences to plan around:
734
734
  - A release carries no env values. A **newly declared** name the target does not hold yet
735
735
  is not created by `promote` or `tenant deploy`: the release's objects read it as null there
736
736
  until it is set. Both commands name every env var the release reads that the target lacks,
737
- before the confirmation, with the `printf %s "$VALUE" | xanosdk env set NAME --to … --yes`
737
+ before the confirmation, with the `printf %s "$VALUE" | npx @xano/sdk env set NAME --to … --yes`
738
738
  that sets it.
739
739
  - `deploy --to workspace --replace` rebuilds the workspace, so the env set becomes exactly what the config
740
740
  declares. Every env var the target holds that your config does not declare is DROPPED —
@@ -743,7 +743,7 @@ values stay inert. Two consequences to plan around:
743
743
  holds: by definition the project never declared it. Declare the name to keep it, or merge
744
744
  without `--replace`.
745
745
 
746
- > ⚠️ The refusal is part of the COMPILE, so `xanosdk deploy --bundle <path>` does not get it:
746
+ > ⚠️ The refusal is part of the COMPILE, so `npx @xano/sdk deploy --bundle <path>` does not get it:
747
747
  > a pre-built bundle carries whatever env it was built with, and deploying it sends exactly
748
748
  > that. A build-once-deploy-the-artifact pipeline therefore has to resolve its values at
749
749
  > BUILD time — pass `--backend-env-file`/`--env-var` to the `export` that produces the bundle, and
@@ -843,7 +843,7 @@ Four things that are easy to get wrong:
843
843
  - **`create_only` is the whole idempotency mechanism.** Without it the write always succeeds
844
844
  and the branch always runs, so the guard reads as present and does nothing.
845
845
  - **Redis is an instance capability.** On an instance without cache support every
846
- `s.redis.*` statement fails at request time; `xanosdk export` lists what a bundle needs.
846
+ `s.redis.*` statement fails at request time; `npx @xano/sdk export` lists what a bundle needs.
847
847
  The unique index on `webhook_events.provider_event_id` above is the durable fallback — the insert fails on a
848
848
  duplicate rather than being skipped, so wrap it in `s.try_catch` if you take that route.
849
849
 
@@ -904,7 +904,7 @@ seed: seedFile("./products.seed.json", import.meta.url),
904
904
 
905
905
  The path resolves against the file that declares the table, and it is read with `node:fs`
906
906
  at deploy time. Note the tradeoff: inline rows are typed against the table schema at compile
907
- time, while a `seedFile`/thunk seed is opaque to the typechecker — `xanosdk export`/`deploy`
907
+ time, while a `seedFile`/thunk seed is opaque to the typechecker — `npx @xano/sdk export`/`deploy`
908
908
  validates it instead, naming the row index, the offending column and the table's known
909
909
  columns. A thunk (`seed: () => import("./products.seed.json")`) also works and is
910
910
  the right shape for *computed* seeds — but be aware it does **not** keep seed values out of
@@ -914,7 +914,7 @@ ships the seed to the browser. `seedFile` stores a path string, which a bundler
914
914
  to follow.
915
915
 
916
916
  Either way, keep secrets out of `seed` — it is throwaway fixture data for disposable
917
- environments. As a backstop, `xanosdk deploy <entry> --static <dir>` and `xanosdk deploy <entry> --to workspace --static <dir>`
917
+ environments. As a backstop, `npx @xano/sdk deploy <entry> --static <dir>` and `npx @xano/sdk deploy <entry> --to workspace --static <dir>`
918
918
  refuse to publish a frontend build containing seed values from password columns or columns
919
919
  your schema marks `access: "internal"` or `sensitive`. If the data is deliberately public (a
920
920
  demo login the frontend shows), declare it on the table: `publicSeed: ["password"]`.
package/guides/bundle.md CHANGED
@@ -8,7 +8,7 @@ engine grows a new one.
8
8
  A bundle is what `export` writes:
9
9
 
10
10
  ```bash
11
- npx xanosdk export ./xano/index.ts --out bundle.json
11
+ npx @xano/sdk export ./xano/index.ts --out bundle.json
12
12
  ```
13
13
 
14
14
  ```ts
@@ -39,7 +39,7 @@ for (const { raw, path, depth } of walk(bundle.payload.query[0].run)) {
39
39
  engine-filled operands excluded — so adding a column to a table leaves `db.edit` /
40
40
  `db.add_or_edit` unchanged. A `db.add` writes every column, so its hash does change.
41
41
  - **`tableRefOf(column)` / `linkedTableOf(column)`** → the table a column points at.
42
- - **`normalize(value)`** → the normalizer `xanosdk preflight` compares with, for diffing a
42
+ - **`normalize(value)`** → the normalizer `npx @xano/sdk preflight` compares with, for diffing a
43
43
  stored workspace against a compiled one.
44
44
 
45
45
  Everything on the entry is pure — no filesystem, network, or Node built-ins — so it runs anywhere.
package/guides/cli.md CHANGED
@@ -1,158 +1,162 @@
1
1
  # CLI
2
2
 
3
- Every `xanosdk` command, shell completion, and what the CLI prints when something fails.
3
+ Every CLI command, shell completion, and what the CLI prints when something fails.
4
4
 
5
- The examples spell the bare `xanosdk` of a global install (`npm i -g @xano/sdk`). In a project
6
- with `@xano/sdk` installed, run them as `npx xanosdk …`; anywhere else, `npx @xano/sdk …` (see
7
- [Commands the CLI prints](#commands-the-cli-prints)).
5
+ Run every command here as `npx @xano/sdk …`. Inside a project, npx runs the project's installed
6
+ version; anywhere else it runs the latest release. In a project, the `npm run xano:*` scripts
7
+ `init` writes are shortcuts for the common ones.
8
+
9
+ The program inside the package is named `xanosdk`. That's what the `npm run xano:*` scripts
10
+ call, and what `npm i -g @xano/sdk` puts on your PATH. A global `xanosdk` ignores the project's
11
+ version, so inside a project use `npx @xano/sdk` or the scripts.
8
12
 
9
13
  ```bash
10
- xanosdk init my-app # scaffold a full project (frontend/ + xano/)
11
- xanosdk init my-app --framework svelte # SvelteKit instead of the default React
12
- xanosdk init my-api --framework none # a new project with the backend only (no frontend/)
13
- xanosdk init # inside an existing app: add xano/ and the xano:* scripts, no frontend (lists clashes and writes nothing; --force overwrites)
14
- xanosdk init my-app --no-agents-md --no-install # skip AGENTS.md and npm install
15
- xanosdk init my-app --theme zinc-blue --dark toggle --icons tabler # the look
16
- xanosdk init my-app --marketplace @xano-sdk/auth,@xano-sdk/vector # install add-ons AND register them
17
-
18
- xanosdk marketplace list # every published add-on (no login needed)
19
- xanosdk marketplace search auth # narrow by keyword
20
- xanosdk marketplace details @xano-sdk/auth # what it installs + the registration to copy
21
- xanosdk marketplace details @xano-sdk/auth --prompt # …as a prompt for a coding agent
22
- xanosdk marketplace install @xano-sdk/auth # add an add-on to the project you're in (and configure it)
23
- xanosdk marketplace reinstall <toolchain-package> # re-ask a toolchain module its questions
24
- xanosdk marketplace remove <toolchain-package> # uninstall it and drop what it contributed
25
-
26
- xanosdk export ./xano/index.ts # bundle to stdout
27
- xanosdk export ./xano/index.ts --out ws.json
28
- xanosdk compile ./xano/functions/get-user.ts # a single function's JSON
29
- xanosdk routes ./xano/index.ts # every route, realtime socket/channel and MCP server address (`paths` is an alias)
30
-
31
- xanosdk export ./xano/index.ts --strict # CI: fail the build on any warning, don't just print it
32
- xanosdk export ./xano/index.ts --no-lock # build with no xano.lock (one is written by default; refused once one exists)
33
- xanosdk export ./xano/index.ts --frozen-lock # CI guard: fail if the export would change the lock, or if the lock carries an entry no object matches
34
- xanosdk export ./xano/index.ts --check --strict # the same guard, writing nothing (no bundle, no lock) — needs no .env or .secrets.json; the scaffold's xano:check
35
- xanosdk lock rename --entry=xano/index.ts table users members # move a lock entry after renaming in code
36
- xanosdk lock prune ./xano/index.ts --yes # drop lock entries nothing exports anymore
37
- xanosdk lock prune --identity-only --entry=xano/index.ts --yes dbo:notes # …or drop named keys without running the workspace
38
- xanosdk lock import live-export.json --entry=xano/index.ts --yes # seed the lock from a live engine export
39
-
40
- xanosdk login # OAuth sign-in (once) — pick the instance + workspace at consent
41
- xanosdk login --paste # …when the browser can't reach this machine's 127.0.0.1 (remote shell, container, Codespace)
42
- xanosdk login --scope "<list>" # request these OAuth scopes instead of the built-in set
43
- xanosdk login --profile staging # sign in as a second named credential, leaving the others alone
44
- xanosdk <command> --profile staging # act as that profile for one run (-p is the short form)
45
- xanosdk workspace details # which instance/workspace am I bound to, and via which credential?
46
- xanosdk deploy ./xano/index.ts # compile + import into the Xano Engine on this machine (the dev loop) → URL; no account needed
47
- xanosdk deploy ./xano/index.ts --ephemeral # …or into a live ephemeral on Xano's cloud → URL
48
- xanosdk deploy ./xano/index.ts --ephemeral --static ./frontend/dist # also deploy a static frontend (onto the ephemeral)
49
- xanosdk deploy ./xano/index.ts --ephemeral --static ./frontend/dist --static-env PK=pk_live_1 # + extra public config
50
- xanosdk deploy --bundle ws.json # deploy an already-exported bundle
51
- xanosdk deploy ./xano/index.ts --open # …and open the deployed URL in your browser
52
- xanosdk deploy ./xano/index.ts --ephemeral --expires-hours 8 # the ephemeral's TTL when this deploy creates it: 1–24 hours (default: 1)
53
- xanosdk deploy ./xano/index.ts --ephemeral --keep-data --static ./frontend/dist --static-host docs # publish to a named static host — merge only: a replace deletes it, and a deploy creates only `default` (create `docs` in the dashboard first)
54
- xanosdk deploy ./xano/index.ts --ephemeral --static ./frontend/dist --static-routing spa # override URL resolution, spa|multipage (inferred from the bundle; rarely needed)
55
- xanosdk deploy ./xano/index.ts --keep-data # redeploy but keep table rows (merge instead of replace; seeds aren't re-written)
56
- xanosdk env pull --from workspace # fill xano/.env from a running backend (default: last deployed); lists what changes and confirms over an existing file (--yes off a terminal)
57
- xanosdk env set STRIPE_KEY --to workspace --yes # set ONE env var on a running backend, value piped on stdin (no deploy; never printed)
58
- xanosdk env unset STRIPE_KEY --to local # clear one (--to workspace|ephemeral[:<name>]|local[:<name>]|tenant:<name>, default: last deployed)
59
- xanosdk secrets fill # mint a token in xano/.secrets.json for every documentation gate that has none (never replaces one)
60
- xanosdk publish ./frontend/dist # publish a built frontend alone — no compile, no backend import (default: last deployed)
61
- xanosdk publish ./frontend/dist --to ephemeral # …or onto an ephemeral instead (after a local deploy, bare publish goes to the engine)
62
- xanosdk deploy ./xano/index.ts --static ./frontend/dist # on the Xano Engine, the engine serves the build at http://<prefix>.localhost:<port>
63
- xanosdk publish ./frontend/dist --to workspace --branch v2 --yes # …onto the workspace, refused unless branch v2 is live
64
- xanosdk deploy ./xano/index.ts --local # the default, spelled out: the Xano Engine on this machine (runs the version pinned in package.json)
65
- xanosdk deploy ./xano/index.ts --local=~/Downloads/engine.tar.gz # override: run this archive, URL or version (v0.1.8), never touching the pin
14
+ npx @xano/sdk init my-app # scaffold a full project (frontend/ + xano/)
15
+ npx @xano/sdk init my-app --framework svelte # SvelteKit instead of the default React
16
+ npx @xano/sdk init my-api --framework none # a new project with the backend only (no frontend/)
17
+ npx @xano/sdk init # inside an existing app: add xano/ and the xano:* scripts, no frontend (lists clashes and writes nothing; --force overwrites)
18
+ npx @xano/sdk init my-app --no-agents-md --no-install # skip AGENTS.md and npm install
19
+ npx @xano/sdk init my-app --theme zinc-blue --dark toggle --icons tabler # the look
20
+ npx @xano/sdk init my-app --marketplace @xano-sdk/auth,@xano-sdk/vector # install add-ons AND register them
21
+
22
+ npx @xano/sdk marketplace list # every published add-on (no login needed)
23
+ npx @xano/sdk marketplace search auth # narrow by keyword
24
+ npx @xano/sdk marketplace details @xano-sdk/auth # what it installs + the registration to copy
25
+ npx @xano/sdk marketplace details @xano-sdk/auth --prompt # …as a prompt for a coding agent
26
+ npx @xano/sdk marketplace install @xano-sdk/auth # add an add-on to the project you're in (and configure it)
27
+ npx @xano/sdk marketplace reinstall <toolchain-package> # re-ask a toolchain module its questions
28
+ npx @xano/sdk marketplace remove <toolchain-package> # uninstall it and drop what it contributed
29
+
30
+ npx @xano/sdk export ./xano/index.ts # bundle to stdout
31
+ npx @xano/sdk export ./xano/index.ts --out ws.json
32
+ npx @xano/sdk compile ./xano/functions/get-user.ts # a single function's JSON
33
+ npx @xano/sdk routes ./xano/index.ts # every route, realtime socket/channel and MCP server address (`paths` is an alias)
34
+
35
+ npx @xano/sdk export ./xano/index.ts --strict # CI: fail the build on any warning, don't just print it
36
+ npx @xano/sdk export ./xano/index.ts --no-lock # build with no xano.lock (one is written by default; refused once one exists)
37
+ npx @xano/sdk export ./xano/index.ts --frozen-lock # CI guard: fail if the export would change the lock, or if the lock carries an entry no object matches
38
+ npx @xano/sdk export ./xano/index.ts --check --strict # the same guard, writing nothing (no bundle, no lock) — needs no .env or .secrets.json; the scaffold's xano:check
39
+ npx @xano/sdk lock rename --entry=xano/index.ts table users members # move a lock entry after renaming in code
40
+ npx @xano/sdk lock prune ./xano/index.ts --yes # drop lock entries nothing exports anymore
41
+ npx @xano/sdk lock prune --identity-only --entry=xano/index.ts --yes dbo:notes # …or drop named keys without running the workspace
42
+ npx @xano/sdk lock import live-export.json --entry=xano/index.ts --yes # seed the lock from a live engine export
43
+
44
+ npx @xano/sdk login # OAuth sign-in (once) — pick the instance + workspace at consent
45
+ npx @xano/sdk login --paste # …when the browser can't reach this machine's 127.0.0.1 (remote shell, container, Codespace)
46
+ npx @xano/sdk login --scope "<list>" # request these OAuth scopes instead of the built-in set
47
+ npx @xano/sdk login --profile staging # sign in as a second named credential, leaving the others alone
48
+ npx @xano/sdk <command> --profile staging # act as that profile for one run (-p is the short form)
49
+ npx @xano/sdk workspace details # which instance/workspace am I bound to, and via which credential?
50
+ npx @xano/sdk deploy ./xano/index.ts # compile + import into the Xano Engine on this machine (the dev loop) → URL; no account needed
51
+ npx @xano/sdk deploy ./xano/index.ts --ephemeral # …or into a live ephemeral on Xano's cloud → URL
52
+ npx @xano/sdk deploy ./xano/index.ts --ephemeral --static ./frontend/dist # also deploy a static frontend (onto the ephemeral)
53
+ npx @xano/sdk deploy ./xano/index.ts --ephemeral --static ./frontend/dist --static-env PK=pk_live_1 # + extra public config
54
+ npx @xano/sdk deploy --bundle ws.json # deploy an already-exported bundle
55
+ npx @xano/sdk deploy ./xano/index.ts --open # …and open the deployed URL in your browser
56
+ npx @xano/sdk deploy ./xano/index.ts --ephemeral --expires-hours 8 # the ephemeral's TTL when this deploy creates it: 1–24 hours (default: 1)
57
+ npx @xano/sdk deploy ./xano/index.ts --ephemeral --keep-data --static ./frontend/dist --static-host docs # publish to a named static host — merge only: a replace deletes it, and a deploy creates only `default` (create `docs` in the dashboard first)
58
+ npx @xano/sdk deploy ./xano/index.ts --ephemeral --static ./frontend/dist --static-routing spa # override URL resolution, spa|multipage (inferred from the bundle; rarely needed)
59
+ npx @xano/sdk deploy ./xano/index.ts --keep-data # redeploy but keep table rows (merge instead of replace; seeds aren't re-written)
60
+ npx @xano/sdk env pull --from workspace # fill xano/.env from a running backend (default: last deployed); lists what changes and confirms over an existing file (--yes off a terminal)
61
+ npx @xano/sdk env set STRIPE_KEY --to workspace --yes # set ONE env var on a running backend, value piped on stdin (no deploy; never printed)
62
+ npx @xano/sdk env unset STRIPE_KEY --to local # clear one (--to workspace|ephemeral[:<name>]|local[:<name>]|tenant:<name>, default: last deployed)
63
+ npx @xano/sdk secrets fill # mint a token in xano/.secrets.json for every documentation gate that has none (never replaces one)
64
+ npx @xano/sdk publish ./frontend/dist # publish a built frontend alone — no compile, no backend import (default: last deployed)
65
+ npx @xano/sdk publish ./frontend/dist --to ephemeral # …or onto an ephemeral instead (after a local deploy, bare publish goes to the engine)
66
+ npx @xano/sdk deploy ./xano/index.ts --static ./frontend/dist # on the Xano Engine, the engine serves the build at http://<prefix>.localhost:<port>
67
+ npx @xano/sdk publish ./frontend/dist --to workspace --branch v2 --yes # …onto the workspace, refused unless branch v2 is live
68
+ npx @xano/sdk deploy ./xano/index.ts --local # the default, spelled out: the Xano Engine on this machine (runs the version pinned in package.json)
69
+ npx @xano/sdk deploy ./xano/index.ts --local=~/Downloads/engine.tar.gz # override: run this archive, URL or version (v0.1.8), never touching the pin
66
70
  XANOSDK_ENGINE_OVERRIDE=v0.1.8 npm run xano:deploy # the same override for every deploy in the shell
67
- xanosdk local list # Xano Engines on this machine, marking the ones xanosdk started
68
- xanosdk local token # print its meta API bearer: XANO_META_TOKEN=$(xanosdk local token)
69
- xanosdk local mcp # how a coding agent connects to its MCP server (url, command, config); never the bearer
70
- xanosdk local mcp --stdio # the bridge an agent's .mcp.json launches: follows restarts, brings the current bearer
71
- xanosdk local stop <name> # stop one (--all: every one xanosdk started, and what a crashed one left running)
72
- xanosdk local update # move this project's pinned engine to the latest (--version <v>: that one) and restart it — commit package.json
73
- xanosdk local cache list # each cached engine version, its size, and the engines running on it
74
- xanosdk local cache clear # remove every cached engine and its unpacked runtime (--version <v>: just that one); running ones are stopped first
75
- xanosdk ephemeral list # list your ephemeral environments (--all-workspaces spans every workspace; --json: { ephemerals: [...] })
76
- xanosdk ephemeral get <name> # base URL, state, and expiry for one (<name> = the tenant name, e.g. ewap-8wz9-9e13, NOT the display name — `ephemeral list` shows it in bold)
77
- xanosdk ephemeral delete <name> --yes # destroy one
78
- xanosdk tables # the last-deployed backend's tables: id, guid, name (for release create --seed)
79
- xanosdk tables tenant:acme # …or name one
80
- xanosdk test run-all # run the tests the last-deployed backend carries (exits 5 on a failure)
81
- xanosdk test run-all --on local # …or name one (--on ephemeral:<name>|tenant:<name>|workspace)
82
- xanosdk test list # list the tests a backend carries, without running any
83
- xanosdk test run "<name>" # run one test by its name
84
- xanosdk test run-all --kind unit # only one family (unit|workflow; default: both) — also on test list
85
- xanosdk test run-all --concurrency 4 # run 4 at once (default: 1); tests share the backend's database, so only when yours don't share state
86
- xanosdk impersonate # open what this project last deployed to in the builder (--guest = read-only; --url-only prints the URL; the URL is a session — treat it as a credential)
87
- xanosdk impersonate ephemeral:<tenant> # …or name one: local[:<name>] or tenant:<name> (open your workspace from the Xano dashboard)
88
- xanosdk deploy ./xano/index.ts --ephemeral --test # THE RELEASE FLOW, step 1: stand it up on an ephemeral and run its tests (a bare deploy goes to the Xano Engine, which release create cannot cut from)
89
- xanosdk release create v1 # …2: cut a release from the ephemeral this project last deployed to (after a local deploy: --from ephemeral)
90
- xanosdk release create v1 --from ephemeral:e4f2-9ab1 --description "what shipped" # …from a named source
91
- xanosdk release create v1 --from workspace --branch staging # …or from a branch of your workspace (default: what it serves)
92
- xanosdk release list # every release in this workspace, newest first, a description cut to one line (--json: { releases: [...] }, each with the origin show names)
93
- xanosdk release show v1 # one release: when it was cut, from what (a cut from an environment records it in the description), what it carries
71
+ npx @xano/sdk local list # Xano Engines on this machine, marking the ones the SDK started
72
+ npx @xano/sdk local token # print its meta API bearer: XANO_META_TOKEN=$(npx @xano/sdk local token)
73
+ npx @xano/sdk local mcp # how a coding agent connects to its MCP server (url, command, config); never the bearer
74
+ npx @xano/sdk local mcp --stdio # the bridge an agent's .mcp.json launches: follows restarts, brings the current bearer
75
+ npx @xano/sdk local stop <name> # stop one (--all: every one the SDK started, and what a crashed one left running)
76
+ npx @xano/sdk local update # move this project's pinned engine to the latest (--version <v>: that one) and restart it — commit package.json
77
+ npx @xano/sdk local cache list # each cached engine version, its size, and the engines running on it
78
+ npx @xano/sdk local cache clear # remove every cached engine and its unpacked runtime (--version <v>: just that one); running ones are stopped first
79
+ npx @xano/sdk ephemeral list # list your ephemeral environments (--all-workspaces spans every workspace; --json: { ephemerals: [...] })
80
+ npx @xano/sdk ephemeral get <name> # base URL, state, and expiry for one (<name> = the tenant name, e.g. ewap-8wz9-9e13, NOT the display name — `ephemeral list` shows it in bold)
81
+ npx @xano/sdk ephemeral delete <name> --yes # destroy one
82
+ npx @xano/sdk tables # the last-deployed backend's tables: id, guid, name (for release create --seed)
83
+ npx @xano/sdk tables tenant:acme # …or name one
84
+ npx @xano/sdk test run-all # run the tests the last-deployed backend carries (exits 5 on a failure)
85
+ npx @xano/sdk test run-all --on local # …or name one (--on ephemeral:<name>|tenant:<name>|workspace)
86
+ npx @xano/sdk test list # list the tests a backend carries, without running any
87
+ npx @xano/sdk test run "<name>" # run one test by its name
88
+ npx @xano/sdk test run-all --kind unit # only one family (unit|workflow; default: both) — also on test list
89
+ npx @xano/sdk test run-all --concurrency 4 # run 4 at once (default: 1); tests share the backend's database, so only when yours don't share state
90
+ npx @xano/sdk impersonate # open what this project last deployed to in the builder (--guest = read-only; --url-only prints the URL; the URL is a session — treat it as a credential)
91
+ npx @xano/sdk impersonate ephemeral:<tenant> # …or name one: local[:<name>] or tenant:<name> (open your workspace from the Xano dashboard)
92
+ npx @xano/sdk deploy ./xano/index.ts --ephemeral --test # THE RELEASE FLOW, step 1: stand it up on an ephemeral and run its tests (a bare deploy goes to the Xano Engine, which release create cannot cut from)
93
+ npx @xano/sdk release create v1 # …2: cut a release from the ephemeral this project last deployed to (after a local deploy: --from ephemeral)
94
+ npx @xano/sdk release create v1 --from ephemeral:e4f2-9ab1 --description "what shipped" # …from a named source
95
+ npx @xano/sdk release create v1 --from workspace --branch staging # …or from a branch of your workspace (default: what it serves)
96
+ npx @xano/sdk release list # every release in this workspace, newest first, a description cut to one line (--json: { releases: [...] }, each with the origin show names)
97
+ npx @xano/sdk release show v1 # one release: when it was cut, from what (a cut from an environment records it in the description), what it carries
94
98
  # --json origin: {kind:"branch",label} | {kind:"environment",name,type} | {kind:"copy",source:{host,workspaceId,release},from?:<branch or environment>} (transferred in) | null
95
- xanosdk release export v1 # download it as a XanoScript multidoc (workspace block named "v1")
96
- xanosdk release delete v1 --yes # remove one (a tenant may be running it — there is no undo)
97
- xanosdk release transfer v1 --to-profile prod # copy a release to another workspace/instance, checked by content hash
98
- xanosdk promote v1 # …3: land it in your workspace, as a new branch
99
- xanosdk promote v1 --branch staging # …on a named branch instead of one named after the release (a taken label exits 2, SDK_BRANCH_TAKEN)
99
+ npx @xano/sdk release export v1 # download it as a XanoScript multidoc (workspace block named "v1")
100
+ npx @xano/sdk release delete v1 --yes # remove one (a tenant may be running it — there is no undo)
101
+ npx @xano/sdk release transfer v1 --to-profile prod # copy a release to another workspace/instance, checked by content hash
102
+ npx @xano/sdk promote v1 # …3: land it in your workspace, as a new branch
103
+ npx @xano/sdk promote v1 --branch staging # …on a named branch instead of one named after the release (a taken label exits 2, SDK_BRANCH_TAKEN)
100
104
  # (a label is letters, digits, _ . - and starts with a letter, digit or _; surrounding spaces are trimmed)
101
- xanosdk tenant list # every tenant under this workspace (--json: { tenants: [...] })
102
- xanosdk tenant get acme # base URL and state for one
103
- xanosdk tenant deploy acme v1 # …or 3: land it on a customer tenant instead
104
- xanosdk tenant delete acme --yes # destroy one (by its NAME — a display name fails with exit 8 and names the tenant it belongs to)
105
- xanosdk pull release:v1 # refresh xano/ from a release: rewrites decoded files, keeps and names files you added, lists and confirms (also workspace, ephemeral[:<name>], local, tenant:<name>)
106
- xanosdk pull release:v1 --yes # …skip the confirmation and the dirty-tree refusal (CI)
107
- xanosdk pull workspace --backend-dir ./backend # …when this project keeps its backend somewhere other than xano/ and nothing on disk says so (also on env pull)
108
- xanosdk generate release:v1 --out ./backend # write ONLY the decoded xano/ tree, no project around it (any source above, or a bundle path; --force replaces the files an earlier generate wrote, asks first when that loses your edits (--yes answers), and keeps and lists any others)
109
- xanosdk deploy ./xano/index.ts --to workspace --dry-run # ALTERNATIVE to the release flow: preview a merge of the local build
110
- xanosdk deploy ./xano/index.ts --to workspace # …send it: add + update, never delete, never touch table data. Leaves no release to re-land
111
- xanosdk deploy ./xano/index.ts --to workspace --prune # …also delete objects this project LANDED here and no longer defines (per xano.lock's `landed` record; commit it)
112
- xanosdk deploy ./xano/index.ts --to workspace --branch staging # …land on a NEW branch instead of live (created; an existing label is refused, exit 2; stages LOGIC only — schema and workspace settings are shared, so not applied from a branch)
113
- xanosdk deploy ./xano/index.ts --to workspace --branch staging --set-live # …and set it live the moment the import succeeds
114
- xanosdk deploy ./xano/index.ts --to tenant:acme # …or merge into a customer tenant
115
- xanosdk ephemeral export <name> # export a DEPLOYED ephemeral as a JSON bundle → .xano/exports/<name>.json
116
- xanosdk ephemeral export <name> --format multidoc --name backend # …or as XanoScript → .xano/exports/backend.xs (--path picks elsewhere; a secret-bearing file git would commit is added to .gitignore)
117
- xanosdk ephemeral export <name> --format multidoc --path - # …stream the multidoc to stdout (deploy first)
118
-
119
- xanosdk workspace details # which workspace your token is scoped to (instance, id, name)
120
- xanosdk workspace export --path ws.json # your REAL workspace as a JSON bundle (`--path -` streams to stdout)
121
- xanosdk workspace diff ./xano/index.ts --branch staging # did my release land? which objects on the branch differ from your compile, are missing, or are unexpected (default: live), and which side changed each since the last sync (`changedThere`/`changedHere`/`changedBoth`); exits 2 when anything declared differs or is missing
122
- xanosdk workspace reset-tables ./xano/index.ts --table <guid> --write # put named tables back to the seed rows your project compiles (a dry run without --write; every other table is left alone)
123
- xanosdk workspace branch list # its branches, and which one is live
124
- xanosdk workspace branch set-live staging # promote a branch (also the way back after --backup-branch)
125
- xanosdk workspace branch delete staging --yes # remove a non-live branch (a label padded with spaces is found by the trimmed one; one not there exits 0, alreadyGone; the live branch exits 2, SDK_BRANCH_LIVE)
126
- xanosdk init my-app --from workspace # …or as a runnable project (the pull direction)
127
- xanosdk init my-app --from ephemeral:<tenant> # same, from an ephemeral (the env is named inside the flag)
128
- xanosdk init my-app --from ./ws.json # …or from a bundle already on disk (offline, no auth)
129
-
130
- xanosdk status # who am I, which workspace, and the env this project last deployed to
131
- xanosdk whoami # print the scoped user + instance base URL (pretty on a TTY, JSON when piped)
132
- xanosdk profile list # every stored credential profile, with the default and the active one marked
133
- xanosdk profile show [name] # what one profile addresses — never its token
134
- xanosdk profile use <name> # pin THIS PROJECT to a profile (writes a committed xano.profile.json)
135
- xanosdk profile set-default <name> # set the profile THIS MACHINE falls back to
136
- xanosdk profile add <name> --instance <url> --workspace-id <n> # store a meta API token (prompts, or reads it piped on stdin; checked before storing)
137
- xanosdk profile delete <name> # revoke that session and remove the profile (xano.profile.json is kept, as logout keeps it)
138
- xanosdk logout # revoke the active profile and remove it (--all for every profile)
105
+ npx @xano/sdk tenant list # every tenant under this workspace (--json: { tenants: [...] })
106
+ npx @xano/sdk tenant get acme # base URL and state for one
107
+ npx @xano/sdk tenant deploy acme v1 # …or 3: land it on a customer tenant instead
108
+ npx @xano/sdk tenant delete acme --yes # destroy one (by its NAME — a display name fails with exit 8 and names the tenant it belongs to)
109
+ npx @xano/sdk pull release:v1 # refresh xano/ from a release: rewrites decoded files, keeps and names files you added, lists and confirms (also workspace, ephemeral[:<name>], local, tenant:<name>)
110
+ npx @xano/sdk pull release:v1 --yes # …skip the confirmation and the dirty-tree refusal (CI)
111
+ npx @xano/sdk pull workspace --backend-dir ./backend # …when this project keeps its backend somewhere other than xano/ and nothing on disk says so (also on env pull)
112
+ npx @xano/sdk generate release:v1 --out ./backend # write ONLY the decoded xano/ tree, no project around it (any source above, or a bundle path; --force replaces the files an earlier generate wrote, asks first when that loses your edits (--yes answers), and keeps and lists any others)
113
+ npx @xano/sdk deploy ./xano/index.ts --to workspace --dry-run # ALTERNATIVE to the release flow: preview a merge of the local build
114
+ npx @xano/sdk deploy ./xano/index.ts --to workspace # …send it: add + update, never delete, never touch table data. Leaves no release to re-land
115
+ npx @xano/sdk deploy ./xano/index.ts --to workspace --prune # …also delete objects this project LANDED here and no longer defines (per xano.lock's `landed` record; commit it)
116
+ npx @xano/sdk deploy ./xano/index.ts --to workspace --branch staging # …land on a NEW branch instead of live (created; an existing label is refused, exit 2; stages LOGIC only — schema and workspace settings are shared, so not applied from a branch)
117
+ npx @xano/sdk deploy ./xano/index.ts --to workspace --branch staging --set-live # …and set it live the moment the import succeeds
118
+ npx @xano/sdk deploy ./xano/index.ts --to tenant:acme # …or merge into a customer tenant
119
+ npx @xano/sdk ephemeral export <name> # export a DEPLOYED ephemeral as a JSON bundle → .xano/exports/<name>.json
120
+ npx @xano/sdk ephemeral export <name> --format multidoc --name backend # …or as XanoScript → .xano/exports/backend.xs (--path picks elsewhere; a secret-bearing file git would commit is added to .gitignore)
121
+ npx @xano/sdk ephemeral export <name> --format multidoc --path - # …stream the multidoc to stdout (deploy first)
122
+
123
+ npx @xano/sdk workspace details # which workspace your token is scoped to (instance, id, name)
124
+ npx @xano/sdk workspace export --path ws.json # your REAL workspace as a JSON bundle (`--path -` streams to stdout)
125
+ npx @xano/sdk workspace diff ./xano/index.ts --branch staging # did my release land? which objects on the branch differ from your compile, are missing, or are unexpected (default: live), and which side changed each since the last sync (`changedThere`/`changedHere`/`changedBoth`); exits 2 when anything declared differs or is missing
126
+ npx @xano/sdk workspace reset-tables ./xano/index.ts --table <guid> --write # put named tables back to the seed rows your project compiles (a dry run without --write; every other table is left alone)
127
+ npx @xano/sdk workspace branch list # its branches, and which one is live
128
+ npx @xano/sdk workspace branch set-live staging # promote a branch (also the way back after --backup-branch)
129
+ npx @xano/sdk workspace branch delete staging --yes # remove a non-live branch (a label padded with spaces is found by the trimmed one; one not there exits 0, alreadyGone; the live branch exits 2, SDK_BRANCH_LIVE)
130
+ npx @xano/sdk init my-app --from workspace # …or as a runnable project (the pull direction)
131
+ npx @xano/sdk init my-app --from ephemeral:<tenant> # same, from an ephemeral (the env is named inside the flag)
132
+ npx @xano/sdk init my-app --from ./ws.json # …or from a bundle already on disk (offline, no auth)
133
+
134
+ npx @xano/sdk status # who am I, which workspace, and the env this project last deployed to
135
+ npx @xano/sdk whoami # print the scoped user + instance base URL (pretty on a TTY, JSON when piped)
136
+ npx @xano/sdk profile list # every stored credential profile, with the default and the active one marked
137
+ npx @xano/sdk profile show [name] # what one profile addresses — never its token
138
+ npx @xano/sdk profile use <name> # pin THIS PROJECT to a profile (writes a committed xano.profile.json)
139
+ npx @xano/sdk profile set-default <name> # set the profile THIS MACHINE falls back to
140
+ npx @xano/sdk profile add <name> --instance <url> --workspace-id <n> # store a meta API token (prompts, or reads it piped on stdin; checked before storing)
141
+ npx @xano/sdk profile delete <name> # revoke that session and remove the profile (xano.profile.json is kept, as logout keeps it)
142
+ npx @xano/sdk logout # revoke the active profile and remove it (--all for every profile)
139
143
  # Both ask first (--yes off a terminal) when the profile is the one xano.profile.json pins, or the default while others stay.
140
- xanosdk version # print the installed @xano/sdk version
141
- xanosdk upgrade --check # is a newer @xano/sdk published? exits 7 if so, 0 if current
142
- 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)
143
- xanosdk agent-skill install # put the xano-backend skill into each coding agent detected on this machine (--agent <id> to pick)
144
- xanosdk agent-skill status # each copy: current, stale, edited or absent
145
- xanosdk agent-skill uninstall # remove the copies install wrote (an edited copy is kept)
146
- xanosdk help # grouped command reference (also the no-arg default)
147
- xanosdk <command> --help # that command's usage, subcommands, and flags (`xanosdk deploy --help`)
148
- xanosdk <noun> <verb> --help # scoped to one verb (`xanosdk workspace export --help`)
149
- xanosdk <command> --json # force JSON on stdout (otherwise: whenever stdout isn't a terminal)
150
- xanosdk <command> --no-refresh # don't refresh the managed blocks in AGENTS.md and the README (a build that writes nothing outside its output)
151
- xanosdk completion zsh # shell completion script (also bash, fish) — see below
152
-
153
- xanosdk preflight ./xano/index.ts # import into a live instance, diff each object back (needs auth + a throwaway tenant)
154
- xanosdk preflight ./xano/index.ts --runtime # also run each deployed function on the engine
155
- xanosdk preflight ./xano/index.ts --capture # write the fetched JSON as fixture candidates
144
+ npx @xano/sdk version # print the installed @xano/sdk version
145
+ npx @xano/sdk upgrade --check # is a newer @xano/sdk published? exits 7 if so, 0 if current
146
+ npx @xano/sdk 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)
147
+ npx @xano/sdk agent-skill install # put the xano-backend skill into each coding agent detected on this machine (--agent <id> to pick)
148
+ npx @xano/sdk agent-skill status # each copy: current, stale, edited or absent
149
+ npx @xano/sdk agent-skill uninstall # remove the copies install wrote (an edited copy is kept)
150
+ npx @xano/sdk help # grouped command reference (also the no-arg default)
151
+ npx @xano/sdk <command> --help # that command's usage, subcommands, and flags (`npx @xano/sdk deploy --help`)
152
+ npx @xano/sdk <noun> <verb> --help # scoped to one verb (`npx @xano/sdk workspace export --help`)
153
+ npx @xano/sdk <command> --json # force JSON on stdout (otherwise: whenever stdout isn't a terminal)
154
+ npx @xano/sdk <command> --no-refresh # don't refresh the managed blocks in AGENTS.md and the README (a build that writes nothing outside its output)
155
+ npx @xano/sdk completion zsh # shell completion script (also bash, fish) — see below
156
+
157
+ npx @xano/sdk preflight ./xano/index.ts # import into a live instance, diff each object back (needs auth + a throwaway tenant)
158
+ npx @xano/sdk preflight ./xano/index.ts --runtime # also run each deployed function on the engine
159
+ npx @xano/sdk preflight ./xano/index.ts --capture # write the fetched JSON as fixture candidates
156
160
  ```
157
161
 
158
162
  The `marketplace` family has a guide of its own: [The marketplace](marketplace.md) for what
@@ -166,8 +170,8 @@ Every command that reads, writes or opens a running backend names it with one gr
166
170
  | Spelling | What it is |
167
171
  |---|---|
168
172
  | `workspace` | Your real workspace — the one your login is scoped to |
169
- | `ephemeral` / `ephemeral:<name>` | The ephemeral this project deployed to, or a named one — by its name (`e4f2-9ab1`, from `xanosdk ephemeral list`), not its display name |
170
- | `local` / `local:<name>` | The engine this project deployed to, or a named one from `xanosdk local list`. Needs no Xano account |
173
+ | `ephemeral` / `ephemeral:<name>` | The ephemeral this project deployed to, or a named one — by its name (`e4f2-9ab1`, from `npx @xano/sdk ephemeral list`), not its display name |
174
+ | `local` / `local:<name>` | The engine this project deployed to, or a named one from `npx @xano/sdk local list`. Needs no Xano account |
171
175
  | `tenant:<name>` | A tenant on your instance |
172
176
  | `release:<name>` | A stored release — where a command reads one (`deploy`, `pull`, `generate`, `init --from`) |
173
177
  | a bundle path | Where a command takes a file (`deploy`, `generate`, `init --from`) |
@@ -181,8 +185,8 @@ takes **`--on`**, and a command whose subject IS the backend takes it positional
181
185
  in `.xano/deployed.json` by an ephemeral or local deploy, and never by a deploy to your
182
186
  workspace or a tenant, so a bare command cannot reach something real unasked. With no record,
183
187
  it falls back to the ephemeral recorded under your current credential, then to the engine
184
- recorded for this directory, and otherwise refuses naming the flag, `xanosdk deploy` and
185
- `xanosdk deploy --local`.
188
+ recorded for this directory, and otherwise refuses naming the flag, `npx @xano/sdk deploy` and
189
+ `npx @xano/sdk deploy --local`.
186
190
  `deploy` is the exception: bare, it compiles the project and stands it up on the Xano Engine
187
191
  on this machine unless `--ephemeral` or `--to` says otherwise, so it writes that record rather
188
192
  than reading it. `generate` and `init --from` need a backend named.
@@ -222,7 +226,7 @@ only by each row's `type`, while a `tool` lands in `payload.tool`; matching on t
222
226
  "toolset" alone picks the wrong array. A file format keeps the stored spelling too, so a
223
227
  `xano.lock` key is `dbo:users`, not `table:users`.
224
228
 
225
- This is also the format `xanosdk lock import` reads, so both directions are user-facing.
229
+ This is also the format `npx @xano/sdk lock import` reads, so both directions are user-facing.
226
230
 
227
231
 
228
232
  **Build warnings, and `--strict`.** `export`/`deploy` print a warning (a `!` line) for the
@@ -279,37 +283,37 @@ string, `values` its whole closed set, `examples` a few values of a flag that ta
279
283
 
280
284
  ## Shell completion
281
285
 
282
- `xanosdk completion <bash|zsh|fish>` prints a completion script covering every command, verb, flag,
286
+ `npx @xano/sdk completion <bash|zsh|fish>` prints a completion script covering every command, verb, flag,
283
287
  and closed value set (`--on workspace|ephemeral|local`, `--format json|multidoc`, `--icons lucide|tabler|phosphor`).
284
288
  A flag's value completes as what it takes: its closed set, file names for a path (`--config`,
285
289
  `--secrets-file`), directories for a directory (`--backend-dir`), stored profile names for
286
290
  `--profile`/`--to-profile`, and nothing for a free-form value (`--name`, `--expires-hours`).
287
- `xanosdk help <Tab>` completes command names, then verbs.
291
+ `npx @xano/sdk help <Tab>` completes command names, then verbs.
288
292
  It is generated from the CLI's own command table, so it never drifts from what the CLI accepts — but it
289
293
  is baked at generation time, so re-run it after upgrading.
290
294
 
291
295
  ```bash
292
296
  # zsh
293
- xanosdk completion zsh > "${fpath[1]}/_xanosdk" # then restart your shell
297
+ npx @xano/sdk completion zsh > "${fpath[1]}/_xanosdk" # then restart your shell
294
298
 
295
299
  # bash
296
- xanosdk completion bash > ~/.xanosdk-completion.bash
300
+ npx @xano/sdk completion bash > ~/.xanosdk-completion.bash
297
301
  echo 'source ~/.xanosdk-completion.bash' >> ~/.bashrc
298
302
 
299
303
  # fish
300
- xanosdk completion fish > ~/.config/fish/completions/xanosdk.fish
304
+ npx @xano/sdk completion fish > ~/.config/fish/completions/xanosdk.fish
301
305
  ```
302
306
 
303
307
  After a command succeeds the CLI checks npm (at most once an hour, cached in
304
308
  `~/.xanosdk/update-check.json`) and prints a one-line nudge to **stderr** when a newer
305
309
  `@xano/sdk` is published — never to stdout, so piped bundles stay clean. The suggested
306
310
  command adapts to how you installed it: `npm i -g @xano/sdk@latest` for a global install,
307
- `xanosdk upgrade` when it's a project dependency (it keeps the SDK in the `package.json` block
311
+ `npx @xano/sdk upgrade` when it's a project dependency (it keeps the SDK in the `package.json` block
308
312
  that lists it and restores the scaffolded range, which a raw `npm i` would not). The check is best-effort and bounded (a slow or offline
309
313
  registry never delays a command), and stays silent under CI or when stderr isn't a terminal.
310
314
  Opt out with `XANOSDK_NO_UPDATE_CHECK=1` (or the conventional `NO_UPDATE_NOTIFIER=1`).
311
315
 
312
- `xanosdk upgrade` is the same question asked on purpose, and it answers under all the
316
+ `npx @xano/sdk upgrade` is the same question asked on purpose, and it answers under all the
313
317
  conditions the nudge stays quiet for — CI, a piped stderr, the opt-out variables — reading the
314
318
  registry live rather than serving the hourly cache. `--check` reports without installing and
315
319
  exits **7** when a newer version is published, **0** when you are current or ahead of the
@@ -317,8 +321,8 @@ latest published version (a local build; `status: "ahead"`, and a bare `upgrade`
317
321
  nothing), so a pipeline can branch on it:
318
322
 
319
323
  ```bash
320
- xanosdk upgrade --check || echo "an upgrade is waiting"
321
- xanosdk upgrade --check | jq -r .latest # piped stdout is JSON already
324
+ npx @xano/sdk upgrade --check || echo "an upgrade is waiting"
325
+ npx @xano/sdk upgrade --check | jq -r .latest # piped stdout is JSON already
322
326
  ```
323
327
 
324
328
  A registry it cannot reach is an error (exit 1), never a quiet "you are up to date". Without
@@ -356,7 +360,7 @@ silently ignored. `init --from` follows the same two modes
356
360
  ([Pulling an existing workspace](codegen.md#running-it)).
357
361
 
358
362
  ```bash
359
- xanosdk init --json # inside the app; then run the command in `next`
363
+ npx @xano/sdk init --json # inside the app; then run the command in `next`
360
364
  ```
361
365
 
362
366
  `init --json` reports `mode` (`new` or `existing`), `files` (every file it wrote or merged
@@ -371,11 +375,11 @@ tells the agent when to set up a Xano backend and hands it to `init`, then to th
371
375
  AI agents read. The package ships it at `skills/xano-backend/SKILL.md`.
372
376
 
373
377
  ```bash
374
- xanosdk agent-skill install # every coding agent detected on this machine
375
- xanosdk agent-skill install --agent claude-code # …or name one (repeatable)
376
- xanosdk agent-skill install --dry-run # report what would change, write nothing
377
- xanosdk agent-skill status --json # each copy, as data
378
- xanosdk agent-skill uninstall
378
+ npx @xano/sdk agent-skill install # every coding agent detected on this machine
379
+ npx @xano/sdk agent-skill install --agent claude-code # …or name one (repeatable)
380
+ npx @xano/sdk agent-skill install --dry-run # report what would change, write nothing
381
+ npx @xano/sdk agent-skill status --json # each copy, as data
382
+ npx @xano/sdk agent-skill uninstall
379
383
  ```
380
384
 
381
385
  It writes at most two copies. Claude Code reads `~/.claude/skills/xano-backend/SKILL.md`
@@ -421,13 +425,13 @@ import manifest from "@xano/sdk/manifest.json" with { type: "json" };
421
425
  const has = (cmd: string) => manifest.cli.some((c) => c.command === cmd);
422
426
  ```
423
427
 
424
- Read the manifest from the install whose `xanosdk` you will run: a project dependency and a
428
+ Read the manifest from the install `npx @xano/sdk` will run: a project dependency and a
425
429
  global install can be different versions.
426
430
 
427
431
  - **Check each operation, not the whole feature.** A backend-only promotion needs `promote`,
428
432
  and it should not be refused because `publish` is missing. Gate each command on its own entry.
429
- - **When something is missing, name the command.** `This workflow needs \`xanosdk publish\`,
430
- which the installed @xano/sdk (1.0.x) does not have. Run \`xanosdk upgrade\`.` is accurate. "This SDK has
433
+ - **When something is missing, name the command.** `This workflow needs \`npx @xano/sdk publish\`,
434
+ which the installed @xano/sdk (1.0.x) does not have. Run \`npx @xano/sdk upgrade\`.` is accurate. "This SDK has
431
435
  no release support" is not, when `release create` and `promote` are right there.
432
436
  - **The manifest describes the package, not the target.** Whether a particular workspace or
433
437
  instance will accept an operation is decided when the command runs. The command's own
@@ -436,11 +440,10 @@ global install can be different versions.
436
440
  ## Commands the CLI prints
437
441
 
438
442
  Every command the CLI prints for you to run next (a remedy, a rerun, a hint, `--help`) is spelled
439
- for where it runs, in the text and in `--json` fields such as `rerun` alike: plain `xanosdk …` from a
440
- global install; otherwise `npx xanosdk …` in a project with `@xano/sdk` installed, and
441
- `npx @xano/sdk …` anywhere else (a `cd <dir> && …` is spelled for `<dir>`). Paths in it read from
442
- where you typed — under `npm run`, the directory you ran npm in. Files it writes to disk (a
443
- scaffold's README, `AGENTS.md`, `.env.example`) always say `npx xanosdk …`.
443
+ `npx @xano/sdk …`, in the text and in `--json` fields such as `rerun` alike, and so is every file it
444
+ writes to disk (a scaffold's README, `AGENTS.md`, `.env.example`). Paths in it read from where you
445
+ typed — under `npm run`, the directory you ran npm in. Never `npx xanosdk`: outside a project,
446
+ npx would fetch the `xanosdk` package from the registry, which is only a placeholder.
444
447
 
445
448
  ## When something fails
446
449
 
@@ -453,7 +456,7 @@ what it could not reach and why (`workspace list could not reach https://…: fe
453
456
  response body underneath — nothing is discarded, only folded away.
454
457
 
455
458
  A malformed invocation fails before any work happens: a missing or misspelled entry file, an
456
- argument the command has nowhere to put (`xanosdk export --lock xano.lock` — that flag takes
459
+ argument the command has nowhere to put (`npx @xano/sdk export --lock xano.lock` — that flag takes
457
460
  its value attached, as `--lock=xano.lock`), or a missing credential, each answered with the
458
461
  command's usage block instead of a stack trace. `deploy` and `release` check that you are
459
462
  signed in *before* compiling, so a lapsed session costs you a message, not a build.
@@ -480,4 +483,4 @@ the root so an agent scanning the package's exports sees the surface rather than
480
483
 
481
484
  `emit`, `emitBundle` and the `@xano/sdk/node` writers run the same build-time checks, including seed validation of a literal
482
485
  `seed: [...]` array. A **deferred** seed (a thunk, or `seedFile()`) needs an await or the
483
- filesystem, so it is materialised and checked only by `xanosdk export` / `xanosdk deploy`.
486
+ filesystem, so it is materialised and checked only by `npx @xano/sdk export` / `npx @xano/sdk deploy`.