> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xano.com/llms.txt
> Use this file to discover all available pages before exploring further.

# DOC ACCURACY REPORT

# 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`](https://github.com/xano-inc/cli/blob/main/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.