> ## 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.

# Command Reference

> Complete reference of all Xano CLI commands and flags

export const BrowserFrame = props => {
  const {url = "xano.run", maxWidth = 820, className = "", lightSrc, darkSrc, alt = "", children} = props || ({});
  const style = typeof maxWidth === "number" ? {
    maxWidth: `${maxWidth}px`,
    margin: "16px 0"
  } : {
    maxWidth,
    margin: "16px 0"
  };
  const hasSwapImages = Boolean(lightSrc && darkSrc);
  return <div className={`browser-frame ${className}`.trim()} style={style}>
      <div className="browser-frame__top">
        <div className="browser-frame__controls" aria-hidden="true">
          <span className="browser-frame__dot browser-frame__dot--red" />
          <span className="browser-frame__dot browser-frame__dot--yellow" />
          <span className="browser-frame__dot browser-frame__dot--green" />
        </div>
        <div className="browser-frame__address">{url}</div>
      </div>

      <div className="browser-frame__body">
        {hasSwapImages ? <>
            <img className="browser-frame__img--light" src={lightSrc} alt={alt} />
            <img className="browser-frame__img--dark" src={darkSrc} alt={alt} />
          </> : children}
      </div>
    </div>;
};

This page lists every Xano CLI command with its flags and usage. For detailed guides on each topic, see the linked pages.

## Global Flags

These flags are available on **all** commands:

| Flag            | Env Variable   | Description                                            |
| --------------- | -------------- | ------------------------------------------------------ |
| `-p, --profile` | `XANO_PROFILE` | Use a specific profile instead of the default          |
| `-v, --verbose` | `XANO_VERBOSE` | Show HTTP request/response details for troubleshooting |

***

## `xano auth`

Browser-based authentication. Opens your browser to log in and creates a profile.

```bash theme={null}
xano auth
xano auth -o https://my-xano.my-domain.com
xano auth -o https://my-xano.my-domain.com --insecure
```

| Flag             | Description                                                 |
| ---------------- | ----------------------------------------------------------- |
| `-o, --origin`   | Account/environment URL (for self-hosted or non-production) |
| `-k, --insecure` | Skip TLS certificate verification                           |

See [Get Started — Authentication](/xano-cli/get-started#authentication).

***

## `xano update`

Update the CLI to the latest version.

```bash theme={null}
xano update
xano update --check
xano update --beta
```

| Flag      | Description                          |
| --------- | ------------------------------------ |
| `--check` | Check for updates without installing |
| `--beta`  | Update to the latest beta version    |

***

## `xano profile`

Manage CLI profiles. See [Profiles](/xano-cli/profiles) for full documentation.

| Command                      | Description                                     |
| ---------------------------- | ----------------------------------------------- |
| `xano profile wizard`        | Interactive token-based profile setup           |
| `xano profile create <name>` | Create a profile non-interactively              |
| `xano profile edit <name>`   | Update fields on an existing profile            |
| `xano profile list`          | List all profiles (`-d` for details)            |
| `xano profile get`           | Print the default profile name                  |
| `xano profile set <name>`    | Set the default profile                         |
| `xano profile me`            | Verify the current profile against the Xano API |
| `xano profile token`         | Print the access token for the default profile  |
| `xano profile workspace`     | Print the workspace ID for the default profile  |
| `xano profile workspace set` | Interactively change the workspace on a profile |
| `xano profile delete <name>` | Delete a profile (`-f` to skip confirmation)    |

### `xano profile wizard`

```bash theme={null}
xano profile wizard
xano profile wizard -n production -o https://my-xano.my-domain.com
```

| Flag             | Description                       |
| ---------------- | --------------------------------- |
| `-n`             | Profile name                      |
| `-o`             | Account/environment origin URL    |
| `-k, --insecure` | Skip TLS certificate verification |

### `xano profile create`

```bash theme={null}
xano profile create my-profile -t TOKEN -i https://instance.xano.io -w WORKSPACE_ID -b BRANCH --default
```

| Flag             | Description                          |
| ---------------- | ------------------------------------ |
| `-t`             | Access token (required)              |
| `-i`             | Instance origin URL (required)       |
| `-a`             | Account origin URL (for self-hosted) |
| `-w`             | Workspace ID                         |
| `-b`             | Branch label                         |
| `-k, --insecure` | Skip TLS certificate verification    |
| `--default`      | Set as the default profile           |

### `xano profile edit`

```bash theme={null}
xano profile edit my-profile -w NEW_WORKSPACE_ID
xano profile edit my-profile --remove-branch
xano profile edit my-profile --insecure
```

| Flag                 | Description           |
| -------------------- | --------------------- |
| `-t`                 | Access token          |
| `-i`                 | Instance origin URL   |
| `-a`                 | Account origin URL    |
| `-w`                 | Workspace ID          |
| `-b`                 | Branch label          |
| `--insecure`         | Enable insecure mode  |
| `--remove-branch`    | Clear the branch      |
| `--remove-insecure`  | Disable insecure mode |
| `--remove-workspace` | Clear the workspace   |
| `--default`          | Set as default        |

***

## `xano workspace`

Manage workspaces. See [Workspaces & Branches](/xano-cli/workspaces-and-branches) for full documentation.

| Command                         | Description                                                                            |
| ------------------------------- | -------------------------------------------------------------------------------------- |
| `xano workspace list`           | List all workspaces (`--latest` to sort newest first)                                  |
| `xano workspace get`            | Get workspace details (use `-w` to override profile workspace)                         |
| `xano workspace create <name>`  | Create a workspace                                                                     |
| `xano workspace edit`           | Edit a workspace (use `-w` to override profile workspace)                              |
| `xano workspace delete`         | Delete a workspace (use `-w` to override profile workspace; `-f` to skip confirmation) |
| `xano workspace pull <dir>`     | Pull workspace [multidoc](/xanoscript/multidoc) to local files                         |
| `xano workspace push <dir>`     | Push local files as [multidoc](/xanoscript/multidoc) to workspace                      |
| `xano workspace git pull <dir>` | Pull XanoScript from a Git repo                                                        |

### `xano workspace pull`

```bash theme={null}
xano workspace pull -d ./my-workspace
xano workspace pull -d ./my-workspace -b v2-feature --env --records --draft
```

| Flag        | Description                         |
| ----------- | ----------------------------------- |
| `-b`        | Branch name (overrides profile)     |
| `-w`        | Workspace ID (overrides profile)    |
| `--env`     | Include environment variables       |
| `--records` | Include database records            |
| `--draft`   | Include draft versions of resources |

See [Push & Pull — Pull](/xano-cli/push-pull#pull).

### `xano workspace push`

```bash theme={null}
xano workspace push -d ./my-workspace
xano workspace push -d ./my-workspace --dry-run
xano workspace push -d ./my-workspace --sync --delete --force
xano workspace push -d ./my-workspace -i "function/*"
xano workspace push -d ./my-workspace -i "function/*" -e "**/test*"
```

| Flag               | Description                                                                 |
| ------------------ | --------------------------------------------------------------------------- |
| `-b`               | Branch name (overrides profile)                                             |
| `-w`               | Workspace ID (overrides profile)                                            |
| `-i, --include`    | Glob pattern to include files (supports multiple `-i` flags)                |
| `-e, --exclude`    | Glob pattern to exclude files (supports multiple `-e` flags)                |
| `--sync`           | Full push — send all files, not just changed ones (required for `--delete`) |
| `--delete`         | Delete remote objects not present locally (requires `--sync`)               |
| `--records`        | Include table records                                                       |
| `--env`            | Include environment variables                                               |
| `--dry-run`        | Show preview then exit without applying                                     |
| `--force`          | Skip preview and confirmation prompt; override critical error blocking      |
| `--no-guids`       | Skip writing server-assigned GUIDs back to local files                      |
| `--no-transaction` | Skip wrapping the import in a database transaction                          |
| `--truncate`       | Truncate all table records before importing                                 |

See [Push & Pull — Push](/xano-cli/push-pull#push).

### `xano workspace git pull`

```bash theme={null}
xano workspace git pull -d ./output -r https://github.com/owner/repo
xano workspace git pull -d ./output -r https://github.com/owner/repo -b main --path src/
```

| Flag     | Description                             |
| -------- | --------------------------------------- |
| `-r`     | Git repository URL (required)           |
| `-b`     | Branch, tag, or ref                     |
| `-t`     | Personal access token for private repos |
| `--path` | Subdirectory within the repo            |

See [Push & Pull — Pull from Git](/xano-cli/push-pull#pull-from-git).

### `xano workspace create`

```bash theme={null}
xano workspace create "My Workspace" -d "Description"
```

| Flag | Description                        |
| ---- | ---------------------------------- |
| `-d` | Description                        |
| `-o` | Output format: `summary` or `json` |

### `xano workspace edit`

```bash theme={null}
xano workspace edit -n "New Name" -d "New description"
xano workspace edit -w WORKSPACE_ID -n "New Name" -d "New description"
xano workspace edit -w WORKSPACE_ID --swagger --require-token
```

Workspace ID falls back to your profile workspace when `-w` is omitted.

| Flag                                     | Description                                      |
| ---------------------------------------- | ------------------------------------------------ |
| `-w`                                     | Workspace ID (overrides profile)                 |
| `-n`                                     | Workspace name                                   |
| `-d`                                     | Description                                      |
| `--swagger` / `--no-swagger`             | Enable/disable Swagger                           |
| `--require-token` / `--no-require-token` | Enable/disable token requirement                 |
| `--allow-push` / `--no-allow-push`       | Enable/disable direct CLI push to this workspace |
| `-o`                                     | Output format: `summary` or `json`               |

***

## `xano branch`

Manage workspace branches. See [Workspaces & Branches](/xano-cli/workspaces-and-branches#branches) for full documentation.

| Command                        | Description                                                |
| ------------------------------ | ---------------------------------------------------------- |
| `xano branch list`             | List all branches (use `-w` to override profile workspace) |
| `xano branch get <label>`      | Get branch details                                         |
| `xano branch create`           | Create a new branch                                        |
| `xano branch edit <label>`     | Edit a branch                                              |
| `xano branch set_live <label>` | Promote a branch to live                                   |
| `xano branch delete <label>`   | Delete a branch (`-f` to skip confirmation)                |

### `xano branch create`

```bash theme={null}
xano branch create v2-feature
xano branch create v3-hotfix -s v2-feature -d "Hotfix branch" -c "#FF5733"
```

| Argument / Flag | Description                                 |
| --------------- | ------------------------------------------- |
| `label`         | Branch label (required, positional)         |
| `-s`            | Source branch to clone from (default: `v1`) |
| `-d`            | Description                                 |
| `-c`            | Color hex code                              |
| `-w`            | Workspace ID                                |
| `-o`            | Output format: `summary` or `json`          |

### `xano branch edit`

```bash theme={null}
xano branch edit v2-feature -l v2-ready -d "Ready for review" -c "#00FF00"
```

| Flag | Description      |
| ---- | ---------------- |
| `-l` | New branch label |
| `-d` | Description      |
| `-c` | Color hex code   |

***

## `xano release`

Manage versioned releases. See [Releases](/xano-cli/releases) for full documentation.

| Command                      | Description                                                  |
| ---------------------------- | ------------------------------------------------------------ |
| `xano release list`          | List all releases                                            |
| `xano release get <name>`    | Get release details                                          |
| `xano release create <name>` | Create a release                                             |
| `xano release edit <name>`   | Edit a release                                               |
| `xano release delete <name>` | Delete a release (`-f` to skip confirmation)                 |
| `xano release export <name>` | Export release as `.tar.gz`                                  |
| `xano release import`        | Import a release file                                        |
| `xano release pull <dir>`    | Pull release as local XanoScript                             |
| `xano release push <dir>`    | Push local files as a new release                            |
| `xano release deploy <name>` | Deploy a release to a new branch (`-f` to skip confirmation) |

### `xano release create`

```bash theme={null}
xano release create "v1.0" -b v1 -d "Initial release"
xano release create "v1.1-hotfix" -b v1 --hotfix -d "Critical fix"
```

| Argument / Flag | Description                          |
| --------------- | ------------------------------------ |
| `name`          | Release name (required, positional)  |
| `-b`            | Branch to create from (required)     |
| `-d`            | Description                          |
| `--hotfix`      | Mark as a hotfix release             |
| `--table-ids`   | Comma-separated table IDs to include |
| `-w`            | Workspace ID                         |

### `xano release pull`

```bash theme={null}
xano release pull -d ./my-release -r v1.0
```

| Flag        | Description                   |
| ----------- | ----------------------------- |
| `-r`        | Release name (required)       |
| `--env`     | Include environment variables |
| `--records` | Include database records      |
| `-w`        | Workspace ID                  |

### `xano release push`

```bash theme={null}
xano release push -d ./my-release -n "v2.0"
```

| Flag           | Description                |
| -------------- | -------------------------- |
| `-n`           | Release name (required)    |
| `-d`           | Description                |
| `--hotfix`     | Mark as a hotfix release   |
| `--no-records` | Skip importing records     |
| `--no-env`     | Skip environment variables |
| `-w`           | Workspace ID               |

### `xano release export`

```bash theme={null}
xano release export v1.0
xano release export v1.0 --output ./backups/release.tar.gz
```

| Flag       | Description             |
| ---------- | ----------------------- |
| `--output` | Custom output file path |

### `xano release import`

```bash theme={null}
xano release import --file ./my-release.tar.gz
```

| Flag     | Description                               |
| -------- | ----------------------------------------- |
| `--file` | Path to release `.tar.gz` file (required) |

### `xano release deploy`

```bash theme={null}
xano release deploy "v1.0"
xano release deploy "v1.0" --force
xano release deploy "v1.0" -b "restore-v1" --set_live
xano release deploy "v1.0" -w 40 -o json --force
```

Prompts for confirmation before deploying. Use `-f` / `--force` to skip the prompt. `--set_live` is off by default — omit it to deploy without promoting the new branch.

| Flag          | Description                                                           |
| ------------- | --------------------------------------------------------------------- |
| `-b`          | Branch label for the new branch (defaults to the release branch name) |
| `--set_live`  | Set the new branch as live (default: off)                             |
| `-f, --force` | Skip the confirmation prompt                                          |
| `-w`          | Workspace ID                                                          |
| `-o`          | Output format: `summary` or `json`                                    |

***

## `xano tenant`

Manage tenants, deployments, and backups. See [Tenants](/xano-cli/tenants) for full documentation.

| Command                              | Description                                 |
| ------------------------------------ | ------------------------------------------- |
| `xano tenant list`                   | List all tenants                            |
| `xano tenant get <name>`             | Get tenant details                          |
| `xano tenant create <display>`       | Create a tenant                             |
| `xano tenant edit <name>`            | Edit a tenant                               |
| `xano tenant delete <name>`          | Delete a tenant (`-f` to skip confirmation) |
| `xano tenant impersonate <name>`     | Open tenant dashboard in browser            |
| `xano tenant pull <dir>`             | Pull tenant as local XanoScript             |
| `xano tenant deploy_release <name>`  | Deploy a release to a tenant                |
| `xano tenant deploy_platform <name>` | Deploy a platform to a tenant               |
| `xano tenant license get <name>`     | Get tenant license (`--file`, `--view`)     |
| `xano tenant license set <name>`     | Set tenant license (`--file`, `--value`)    |

### `xano tenant create`

```bash theme={null}
xano tenant create "My Tenant" --type tier2 --cluster_id 5
xano tenant create "My Tenant" --type tier2 --cluster_id 5 --license ./license.yaml
```

| Flag                       | Description                                              |
| -------------------------- | -------------------------------------------------------- |
| `-d`                       | Description                                              |
| `--type`                   | Tenant type: `tier1` (default), `tier2`, `tier3`         |
| `--cluster_id`             | Cluster ID (required for tier2/tier3)                    |
| `-l, --license`            | Path to a license override file to apply during creation |
| `--platform_id`            | Platform ID                                              |
| `--domain`                 | Custom domain                                            |
| `--ingress / --no-ingress` | Enable/disable ingress (default: enabled)                |
| `--tasks / --no-tasks`     | Enable/disable background tasks (default: enabled)       |
| `-w`                       | Workspace ID                                             |
| `-o`                       | Output format: `summary` or `json`                       |

### `xano tenant pull`

```bash theme={null}
xano tenant pull -d ./my-tenant -t TENANT_NAME
```

| Flag        | Description                   |
| ----------- | ----------------------------- |
| `-t`        | Tenant name (required)        |
| `--env`     | Include environment variables |
| `--records` | Include database records      |
| `--draft`   | Include draft versions        |
| `-w`        | Workspace ID                  |

### Tenant Environment Variables

| Command                                             | Description                                     |
| --------------------------------------------------- | ----------------------------------------------- |
| `xano tenant env list <name>`                       | List env var keys                               |
| `xano tenant env get <name> --name KEY`             | Get a single env var                            |
| `xano tenant env set <name> --name KEY --value VAL` | Set an env var                                  |
| `xano tenant env delete <name> --name KEY`          | Delete an env var                               |
| `xano tenant env get_all <name>`                    | Export all env vars (`--file` for YAML)         |
| `xano tenant env set_all <name>`                    | Import env vars from YAML (`--file`, `--clean`) |

### Tenant Backups

| Command                             | Description                                            |
| ----------------------------------- | ------------------------------------------------------ |
| `xano tenant backup list <name>`    | List backups (`--page` for pagination)                 |
| `xano tenant backup create <name>`  | Create a backup                                        |
| `xano tenant backup restore <name>` | Restore from backup (`--backup_id`, `-f`)              |
| `xano tenant backup export <name>`  | Export backup as `.tar.gz` (`--backup_id`, `--output`) |
| `xano tenant backup import <name>`  | Import a backup file (`--file`)                        |
| `xano tenant backup delete <name>`  | Delete a backup (`--backup_id`, `-f`)                  |

### Tenant Clusters

| Command                                | Description                                                          |
| -------------------------------------- | -------------------------------------------------------------------- |
| `xano tenant cluster list`             | List clusters                                                        |
| `xano tenant cluster get <id>`         | Get cluster details                                                  |
| `xano tenant cluster create`           | Create a cluster (`--name`, `--credentials_file` or `--credentials`) |
| `xano tenant cluster edit <id>`        | Edit a cluster                                                       |
| `xano tenant cluster delete <id>`      | Delete a cluster (`-f`)                                              |
| `xano tenant cluster license get <id>` | Get cluster kubeconfig                                               |
| `xano tenant cluster license set <id>` | Set cluster kubeconfig (`--file`)                                    |

***

## `xano platform`

View platform versions. See [Platforms](/xano-cli/platforms) for full documentation.

| Command                  | Description          |
| ------------------------ | -------------------- |
| `xano platform list`     | List all platforms   |
| `xano platform get <id>` | Get platform details |

***

## `xano unit_test`

Run unit tests. See [Testing](/xano-cli/workflow-tests) for full documentation.

| Command                   | Description                                   |
| ------------------------- | --------------------------------------------- |
| `xano unit_test list`     | List unit tests (`--branch`, `--obj-type`)    |
| `xano unit_test run <id>` | Run a single unit test                        |
| `xano unit_test run_all`  | Run all unit tests (`--branch`, `--obj-type`) |

***

## `xano workflow_test`

Run workflow tests. See [Testing](/xano-cli/workflow-tests) for full documentation.

| Command                          | Description                                |
| -------------------------------- | ------------------------------------------ |
| `xano workflow_test list`        | List workflow tests (`-b` for branch)      |
| `xano workflow_test get <id>`    | Get test details (`--include-draft`, `-o`) |
| `xano workflow_test run <id>`    | Run a single test                          |
| `xano workflow_test run_all`     | Run all tests (`-b` for branch)            |
| `xano workflow_test delete <id>` | Delete a test (`-f`)                       |

***

## `xano sandbox`

Manage your sandbox environment — an isolated copy of your workspace for testing changes before promoting them. See [Sandbox](/xano-cli/sandbox) for full documentation.

| Command                   | Description                                           |
| ------------------------- | ----------------------------------------------------- |
| `xano sandbox get`        | Get your sandbox (creates one if it doesn't exist)    |
| `xano sandbox pull <dir>` | Pull sandbox content as local XanoScript              |
| `xano sandbox push <dir>` | Push local files to your sandbox                      |
| `xano sandbox review`     | Open sandbox in browser to review and promote changes |
| `xano sandbox reset`      | Reset sandbox (clears all data and drafts)            |
| `xano sandbox delete`     | Delete sandbox entirely                               |

### `xano sandbox pull`

```bash theme={null}
xano sandbox pull -d ./my-sandbox
xano sandbox pull -d ./my-sandbox --env --records --draft
```

| Flag        | Description                   |
| ----------- | ----------------------------- |
| `--env`     | Include environment variables |
| `--records` | Include database records      |
| `--draft`   | Include draft versions        |

### `xano sandbox push`

```bash theme={null}
xano sandbox push -d ./my-sandbox
xano sandbox push -d ./my-sandbox --records --env
```

| Flag               | Description                                        |
| ------------------ | -------------------------------------------------- |
| `--env`            | Include environment variables in import            |
| `--records`        | Include records in import                          |
| `--truncate`       | Truncate all table records before importing        |
| `--no-transaction` | Skip wrapping the import in a database transaction |

### `xano sandbox review`

```bash theme={null}
xano sandbox review
xano sandbox review --url-only
```

| Flag             | Description                               |
| ---------------- | ----------------------------------------- |
| `-u, --url-only` | Print the URL without opening the browser |
| `-o`             | Output format: `summary` or `json`        |

### `xano sandbox reset`

```bash theme={null}
xano sandbox reset
xano sandbox reset -f
```

| Flag | Description              |
| ---- | ------------------------ |
| `-f` | Skip confirmation prompt |

### `xano sandbox delete`

```bash theme={null}
xano sandbox delete
xano sandbox delete -f
```

| Flag | Description              |
| ---- | ------------------------ |
| `-f` | Skip confirmation prompt |

### Sandbox Environment Variables

| Command                                       | Description                                                  |
| --------------------------------------------- | ------------------------------------------------------------ |
| `xano sandbox env list`                       | List env var keys                                            |
| `xano sandbox env get --name KEY`             | Get a single env var                                         |
| `xano sandbox env set --name KEY --value VAL` | Set an env var                                               |
| `xano sandbox env delete --name KEY`          | Delete an env var                                            |
| `xano sandbox env get_all`                    | Export all env vars (`--file` for YAML, `--view` for stdout) |
| `xano sandbox env set_all`                    | Import env vars from YAML (`--file`, `--clean`)              |

### Sandbox License

| Command                    | Description                               |
| -------------------------- | ----------------------------------------- |
| `xano sandbox license get` | Get sandbox license (`--file`, `--view`)  |
| `xano sandbox license set` | Set sandbox license (`--file`, `--value`) |

### Sandbox Tests

| Command                               | Description                                   |
| ------------------------------------- | --------------------------------------------- |
| `xano sandbox unit_test list`         | List unit tests (`--branch`, `--obj-type`)    |
| `xano sandbox unit_test run <id>`     | Run a single unit test                        |
| `xano sandbox unit_test run_all`      | Run all unit tests (`--branch`, `--obj-type`) |
| `xano sandbox workflow_test list`     | List workflow tests (`-b` for branch)         |
| `xano sandbox workflow_test run <id>` | Run a single workflow test                    |
| `xano sandbox workflow_test run_all`  | Run all workflow tests (`-b` for branch)      |

***

## `xano function`

Manage custom functions.

| Command                   | Description               |
| ------------------------- | ------------------------- |
| `xano function list`      | List all custom functions |
| `xano function get <id>`  | Get function details      |
| `xano function create`    | Create a new function     |
| `xano function edit <id>` | Edit an existing function |

### `xano function list`

```bash theme={null}
xano function list
xano function list --include_draft --page 2 --per_page 10
```

| Flag                   | Description                                   |
| ---------------------- | --------------------------------------------- |
| `--include_draft`      | Include draft functions                       |
| `--include_xanoscript` | Include XanoScript in response                |
| `--sort`               | Sort field (default: `created_at`)            |
| `--order`              | Sort order: `asc` or `desc` (default: `desc`) |
| `--page`               | Page number (default: `1`)                    |
| `--per_page`           | Results per page (default: `50`)              |
| `-w`                   | Workspace ID                                  |
| `-o`                   | Output format: `summary` or `json`            |

### `xano function get`

```bash theme={null}
xano function get FUNCTION_ID
xano function get FUNCTION_ID -o xs
```

| Flag                   | Description                               |
| ---------------------- | ----------------------------------------- |
| `--include_draft`      | Include draft version                     |
| `--include_xanoscript` | Include XanoScript in response            |
| `-w`                   | Workspace ID                              |
| `-o`                   | Output format: `summary`, `json`, or `xs` |

### `xano function create`

```bash theme={null}
xano function create -f ./my-function.xs
cat my-function.xs | xano function create -s
```

| Flag          | Description                                             |
| ------------- | ------------------------------------------------------- |
| `-f, --file`  | Path to file containing XanoScript code                 |
| `-s, --stdin` | Read XanoScript from stdin                              |
| `-e, --edit`  | Open file in editor before creating (requires `--file`) |
| `-w`          | Workspace ID                                            |
| `-o`          | Output format: `summary` or `json`                      |

### `xano function edit`

```bash theme={null}
xano function edit FUNCTION_ID -f ./my-function.xs
```

| Flag          | Description                                             |
| ------------- | ------------------------------------------------------- |
| `-f, --file`  | Path to file containing XanoScript code                 |
| `-s, --stdin` | Read XanoScript from stdin                              |
| `-e, --edit`  | Open file in editor before updating (requires `--file`) |
| `--publish`   | Publish the function after editing (default: `true`)    |
| `-w`          | Workspace ID                                            |
| `-o`          | Output format: `summary` or `json`                      |

***

## `xano static_host`

Manage static file hosting and builds.

| Command                                               | Description                       |
| ----------------------------------------------------- | --------------------------------- |
| `xano static_host list`                               | List all static hosts             |
| `xano static_host build list <static_host>`           | List all builds for a static host |
| `xano static_host build get <static_host> <build_id>` | Get build details                 |
| `xano static_host build create <static_host>`         | Upload a zip file as a new build  |

### `xano static_host list`

```bash theme={null}
xano static_host list
xano static_host list -w 40 -o json
xano static_host list --page 2 --per_page 10
```

| Flag         | Description                                  |
| ------------ | -------------------------------------------- |
| `-w`         | Workspace ID (overrides profile)             |
| `-o`         | Output format: `summary` (default) or `json` |
| `--page`     | Page number for pagination (default: `1`)    |
| `--per_page` | Results per page (default: `50`)             |

### `xano static_host build list`

```bash theme={null}
xano static_host build list my-site
xano static_host build list my-site -w 40 -o json
```

| Flag         | Description                                  |
| ------------ | -------------------------------------------- |
| `-w`         | Workspace ID (overrides profile)             |
| `-o`         | Output format: `summary` (default) or `json` |
| `--page`     | Page number for pagination (default: `1`)    |
| `--per_page` | Results per page (default: `50`)             |

### `xano static_host build get`

```bash theme={null}
xano static_host build get my-site 52
xano static_host build get my-site 52 -o json
```

| Flag | Description                                  |
| ---- | -------------------------------------------- |
| `-w` | Workspace ID (overrides profile)             |
| `-o` | Output format: `summary` (default) or `json` |

### `xano static_host build create`

```bash theme={null}
xano static_host build create my-site -f ./build.zip -n "v1.0.0"
xano static_host build create my-site -f ./dist.zip -n "production" -d "Production build"
```

| Flag                | Description                                  |
| ------------------- | -------------------------------------------- |
| `-f, --file`        | Path to zip file to upload (required)        |
| `-n, --name`        | Build name (required)                        |
| `-d, --description` | Build description                            |
| `-w`                | Workspace ID (overrides profile)             |
| `-o`                | Output format: `summary` (default) or `json` |