Skip to main content

​
Xano CLI Documentation Accuracy Report

Date: 2026-04-20 CLI Source: xano-inc/cli@5921ec49f9181488fff8189082a6e1e02850af36 CLI Version on main: 0.0.95-beta.28 Latest Commit: 2026-04-20 5921ec4 feat: convert positional args to flags, add deploy confirmation, bump beta.28

​
Summary

I re-verified the docs against the current main branch source, using the generated README.md plus the command implementations under src/commands/**. The large syntax drift from the February report is no longer present in the current docs. The current xano-cli/ pages now match the CLI’s flag-based syntax for pull/push commands, workspace targeting, and release creation/deployment. Two remaining doc issues were present locally and were fixed during this verification pass:
  1. profiles.mdx wizard prompts were stale
    • The workspace prompt now shows (Skip workspace) as the first option and uses the message Select a workspace (or skip to use default).
    • The branch prompt only appears after a workspace is selected, and only when more than one branch exists.
    • The branch skip option is now (Skip and use live branch).
  2. profile create documented -w as a workspace name
    • The docs now describe -w as a workspace ID, which matches how profiles are used by downstream commands and how the auth flow stores workspace selections.

​
What Was Verified

The following pages were checked against the current source:
  • xano-cli/get-started.mdx
  • xano-cli/command-reference.mdx
  • xano-cli/profiles.mdx
  • xano-cli/workspaces-and-branches.mdx
  • xano-cli/push-pull.mdx
  • xano-cli/releases.mdx
  • xano-cli/guide-from-existing.mdx
  • xano-cli/guide-from-scratch.mdx
The following source files were used most heavily for verification:
  • src/commands/auth/index.ts
  • src/commands/profile/{wizard,create,edit,list,me,workspace,workspace/set}/index.ts
  • src/commands/workspace/{list,get,edit,pull,push,git/pull}/index.ts
  • src/commands/branch/{list,get,create,edit,set_live,delete}/index.ts
  • src/commands/release/{list,get,create,pull,push,deploy}/index.ts
  • src/commands/tenant/pull/index.ts
  • src/commands/sandbox/pull/index.ts

​
Current Accuracy Notes

  • Pull/push directory arguments: Correctly documented with -d instead of the older positional directory argument.
  • Workspace targeting: Correctly documented with -w for workspace get, workspace edit, workspace delete, and branch list.
  • Release creation: Correctly documented as xano release create "<name>" -b <branch>, with the release name as a positional argument.
  • Release deploy: Correctly documents the confirmation prompt and -f / --force.
  • Multidoc pull layout: Current docs are aligned with the current source, which writes resources under directories such as workspace/, table/, function/, api/, task/, ai/, realtime/, middleware/, and addon/.

​
Residual Source Ambiguity

One implementation detail in main is still slightly inconsistent:
  • auth / profile wizard store the selected branch using the branch choice value returned by the prompt.
  • other CLI help text and examples generally describe branch selection as a branch label/name.
This is mostly a CLI consistency issue rather than a docs issue. The docs should avoid over-specifying the persisted branch format until the CLI normalizes that behavior.

​
Conclusion

As of xano-inc/cli@5921ec4, the audited xano-cli/ docs are now materially aligned with the current main branch source after the fixes in this pass.