npm - @xano/cli - Versions diffs - 0.0.4 → 0.0.6 - Mend

@xano/cli 0.0.4 → 0.0.6

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 (3) hide show

package/README.md CHANGED Viewed

@@ -1,1200 +1,136 @@
-xano
-=================
+# Xano CLI
-XanoScript CLI for Xano's Metadata API
+Command-line interface for the Xano Metadata API.
+[![Version](https://img.shields.io/npm/v/@xano/cli.svg)](https://npmjs.org/package/@xano/cli)
+[![Downloads/week](https://img.shields.io/npm/dw/@xano/cli.svg)](https://npmjs.org/package/@xano/cli)
-[![oclif](https://img.shields.io/badge/cli-oclif-brightgreen.svg)](https://oclif.io)
-[![Version](https://img.shields.io/npm/v/xano.svg)](https://npmjs.org/package/xano)
-[![Downloads/week](https://img.shields.io/npm/dw/xano.svg)](https://npmjs.org/package/xano)
+## Installation
-<!-- toc -->
-* [Usage](#usage)
-* [Commands](#commands)
-<!-- tocstop -->
-# Usage
-<!-- usage -->
-```sh-session
-$ npm install -g @xano/cli
-$ xano COMMAND
-running command...
-$ xano (--version)
-@xano/cli/0.0.4 darwin-arm64 node-v22.19.0
-$ xano --help [COMMAND]
-USAGE
-  $ xano COMMAND
-...
-```
-<!-- usagestop -->
-# Commands
-<!-- commands -->
-* [`xano ephemeral run job`](#xano-ephemeral-run-job)
-* [`xano ephemeral run service`](#xano-ephemeral-run-service)
-* [`xano function create`](#xano-function-create)
-* [`xano function edit [FUNCTION_ID]`](#xano-function-edit-function_id)
-* [`xano function get [FUNCTION_ID]`](#xano-function-get-function_id)
-* [`xano function list`](#xano-function-list)
-* [`xano help [COMMAND]`](#xano-help-command)
-* [`xano plugins`](#xano-plugins)
-* [`xano plugins add PLUGIN`](#xano-plugins-add-plugin)
-* [`xano plugins:inspect PLUGIN...`](#xano-pluginsinspect-plugin)
-* [`xano plugins install PLUGIN`](#xano-plugins-install-plugin)
-* [`xano plugins link PATH`](#xano-plugins-link-path)
-* [`xano plugins remove [PLUGIN]`](#xano-plugins-remove-plugin)
-* [`xano plugins reset`](#xano-plugins-reset)
-* [`xano plugins uninstall [PLUGIN]`](#xano-plugins-uninstall-plugin)
-* [`xano plugins unlink [PLUGIN]`](#xano-plugins-unlink-plugin)
-* [`xano plugins update`](#xano-plugins-update)
-* [`xano profile create NAME`](#xano-profile-create-name)
-* [`xano profile delete NAME`](#xano-profile-delete-name)
-* [`xano profile edit NAME`](#xano-profile-edit-name)
-* [`xano profile get-default`](#xano-profile-get-default)
-* [`xano profile list`](#xano-profile-list)
-* [`xano profile set-default NAME`](#xano-profile-set-default-name)
-* [`xano profile wizard`](#xano-profile-wizard)
-* [`xano static_host build create STATIC_HOST`](#xano-static_host-build-create-static_host)
-* [`xano static_host build get STATIC_HOST BUILD_ID`](#xano-static_host-build-get-static_host-build_id)
-* [`xano static_host build list STATIC_HOST`](#xano-static_host-build-list-static_host)
-* [`xano static_host list`](#xano-static_host-list)
-* [`xano workspace list`](#xano-workspace-list)
-## `xano ephemeral run job`
-Run an ephemeral job in a workspace
-```
-USAGE
-  $ xano ephemeral run job [-p <value>] [-w <value>] [-e [-f <value> | -s]] [-o summary|json] [-a <value>]
-FLAGS
-  -a, --args=<value>                          Path to JSON file containing input arguments
-  -e, --edit                                  Open file in editor before running job (requires --file)
-  -f, --file=<value>                          Path to file containing XanoScript code
-  -o, --output=<option>                       [default: summary] Output format
-                                              <options: summary|json>
-  -p, --profile=<value>  [env: XANO_PROFILE]  Profile to use for this command
-  -s, --stdin                                 Read XanoScript code from stdin
-  -w, --workspace=<value>                     Workspace ID (optional if set in profile)
-DESCRIPTION
-  Run an ephemeral job in a workspace
-EXAMPLES
-  $ xano ephemeral:run:job -w 1 -f script.xs
-  Job executed successfully!
-  ...
-  $ xano ephemeral:run:job -f script.xs
-  Job executed successfully!
-  ...
-  $ xano ephemeral:run:job -w 1 -f script.xs --edit
-  # Opens script.xs in $EDITOR, then runs job with edited content
-  Job executed successfully!
-  ...
-  $ cat script.xs | xano ephemeral:run:job -w 1 --stdin
-  Job executed successfully!
-  ...
-  $ xano ephemeral:run:job -w 1 -f script.xs -o json
-  {
-    "job": { "id": 1, "run": { "id": 1 } },
-    "result": { ... }
-  }
-  $ xano ephemeral:run:job -w 1 -f script.xs -a args.json
-  # Runs job with input arguments from args.json
-  Job executed successfully!
-  ...
-```
-_See code: [src/commands/ephemeral/run/job/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/ephemeral/run/job/index.ts)_
-## `xano ephemeral run service`
-Run an ephemeral service in a workspace
-```
-USAGE
-  $ xano ephemeral run service [-p <value>] [-w <value>] [-e [-f <value> | -s]] [-o summary|json]
-FLAGS
-  -e, --edit                                  Open file in editor before running service (requires --file)
-  -f, --file=<value>                          Path to file containing XanoScript code
-  -o, --output=<option>                       [default: summary] Output format
-                                              <options: summary|json>
-  -p, --profile=<value>  [env: XANO_PROFILE]  Profile to use for this command
-  -s, --stdin                                 Read XanoScript code from stdin
-  -w, --workspace=<value>                     Workspace ID (optional if set in profile)
-DESCRIPTION
-  Run an ephemeral service in a workspace
-EXAMPLES
-  $ xano ephemeral:run:service -w 1 -f service.xs
-  Service created successfully!
-  ...
-  $ xano ephemeral:run:service -f service.xs
-  Service created successfully!
-  ...
-  $ xano ephemeral:run:service -w 1 -f service.xs --edit
-  # Opens service.xs in $EDITOR, then creates service with edited content
-  Service created successfully!
-  ...
-  $ cat service.xs | xano ephemeral:run:service -w 1 --stdin
-  Service created successfully!
-  ...
-  $ xano ephemeral:run:service -w 1 -f service.xs -o json
-  {
-    "service": { "id": 1 },
-    ...
-  }
-```
-_See code: [src/commands/ephemeral/run/service/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/ephemeral/run/service/index.ts)_
-## `xano function create`
-Create a new function in a workspace
-```
-USAGE
-  $ xano function create [-p <value>] [-w <value>] [-e [-f <value> | -s]] [-o summary|json]
-FLAGS
-  -e, --edit                                  Open file in editor before creating function (requires --file)
-  -f, --file=<value>                          Path to file containing XanoScript code
-  -o, --output=<option>                       [default: summary] Output format
-                                              <options: summary|json>
-  -p, --profile=<value>  [env: XANO_PROFILE]  Profile to use for this command
-  -s, --stdin                                 Read XanoScript code from stdin
-  -w, --workspace=<value>                     Workspace ID (optional if set in profile)
-DESCRIPTION
-  Create a new function in a workspace
-EXAMPLES
-  $ xano function:create -w 40 -f function.xs
-  Function created successfully!
-  ID: 123
-  Name: my_function
-  $ xano function:create -f function.xs
-  Function created successfully!
-  ID: 123
-  Name: my_function
-  $ xano function:create -w 40 -f function.xs --edit
-  # Opens function.xs in $EDITOR, then creates function with edited content
-  Function created successfully!
-  ID: 123
-  Name: my_function
-  $ cat function.xs | xano function:create -w 40 --stdin
-  Function created successfully!
-  ID: 123
-  Name: my_function
-  $ xano function:create -w 40 -f function.xs -o json
-  {
-    "id": 123,
-    "name": "my_function",
-    ...
-  }
-```
-_See code: [src/commands/function/create/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/function/create/index.ts)_
-## `xano function edit [FUNCTION_ID]`
-Edit a function in a workspace
-```
-USAGE
-  $ xano function edit [FUNCTION_ID] [-p <value>] [-w <value>] [-f <value> | -s] [-e] [--publish] [-o summary|json]
-ARGUMENTS
-  FUNCTION_ID  Function ID to edit
-FLAGS
-  -e, --edit                                  Open file in editor before updating function (requires --file)
-  -f, --file=<value>                          Path to file containing XanoScript code
-  -o, --output=<option>                       [default: summary] Output format
-                                              <options: summary|json>
-  -p, --profile=<value>  [env: XANO_PROFILE]  Profile to use for this command
-  -s, --stdin                                 Read XanoScript code from stdin
-  -w, --workspace=<value>                     Workspace ID (optional if set in profile)
-      --publish                               Publish the function after editing
-DESCRIPTION
-  Edit a function in a workspace
-EXAMPLES
-  $ xano function:edit 163
-  # Fetches the function code and opens it in $EDITOR for editing
-  Function updated successfully!
-  ID: 163
-  Name: my_function
-  $ xano function:edit
-  # Prompts for function, fetches the code and opens it in $EDITOR for editing
-  Select a function to edit:
-    ❯ my_function (ID: 163) - Sample function
-      another-func (ID: 164)
-  $ xano function:edit 163 -f function.xs
-  Function updated successfully!
-  ID: 163
-  Name: my_function
-  $ xano function:edit 163 -w 40 -f function.xs
-  Function updated successfully!
-  ID: 163
-  Name: my_function
-  $ xano function:edit -f function.xs
-  Select a function to edit:
-    ❯ my_function (ID: 163) - Sample function
-      another-func (ID: 164)
-  $ xano function:edit 163 -f function.xs --edit
-  # Opens function.xs in $EDITOR, then updates function with edited content
-  Function updated successfully!
-  ID: 163
-  Name: my_function
-  $ cat function.xs | xano function:edit 163 --stdin
-  Function updated successfully!
-  ID: 163
-  Name: my_function
-  $ xano function:edit 163 -f function.xs -o json
-  {
-    "id": 163,
-    "name": "my_function",
-    ...
-  }
-```
-_See code: [src/commands/function/edit/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/function/edit/index.ts)_
-## `xano function get [FUNCTION_ID]`
-Get a specific function from a workspace
-```
-USAGE
-  $ xano function get [FUNCTION_ID] [-p <value>] [-w <value>] [-o summary|json|xs] [--include_draft]
-    [--include_xanoscript]
-ARGUMENTS
-  FUNCTION_ID  Function ID
-FLAGS
-  -o, --output=<option>                       [default: summary] Output format
-                                              <options: summary|json|xs>
-  -p, --profile=<value>  [env: XANO_PROFILE]  Profile to use for this command
-  -w, --workspace=<value>                     Workspace ID (optional if set in profile)
-      --include_draft                         Include draft version
-      --include_xanoscript                    Include XanoScript in response
-DESCRIPTION
-  Get a specific function from a workspace
-EXAMPLES
-  $ xano function:get 145 -w 40
-  Function: yo (ID: 145)
-  Created: 2025-10-10 10:30:00
-  Description: Sample function
-  $ xano function:get 145 --profile production
-  Function: yo (ID: 145)
-  Created: 2025-10-10 10:30:00
-  $ xano function:get
-  Select a function:
-    ❯ yo (ID: 145) - Sample function
-      another-func (ID: 146)
-  $ xano function:get 145 -w 40 --output json
-  {
-    "id": 145,
-    "name": "yo",
-    "description": "Sample function"
-  }
-  $ xano function:get 145 -p staging -o json --include_draft
-  {
-    "id": 145,
-    "name": "yo"
-  }
-  $ xano function:get 145 -p staging -o xs
-  function yo {
-    input {
-    }
-    stack {
-    }
-    response = null
-  }
-```
-_See code: [src/commands/function/get/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/function/get/index.ts)_
-## `xano function list`
-List all functions in a workspace from the Xano Metadata API
-```
-USAGE
-  $ xano function list [-p <value>] [-w <value>] [-o summary|json] [--include_draft] [--include_xanoscript] [--page
-    <value>] [--per_page <value>] [--sort <value>] [--order asc|desc]
-FLAGS
-  -o, --output=<option>                       [default: summary] Output format
-                                              <options: summary|json>
-  -p, --profile=<value>  [env: XANO_PROFILE]  Profile to use for this command
-  -w, --workspace=<value>                     Workspace ID (optional if set in profile)
-      --include_draft                         Include draft functions
-      --include_xanoscript                    Include XanoScript in response
-      --order=<option>                        [default: desc] Sort order
-                                              <options: asc|desc>
-      --page=<value>                          [default: 1] Page number for pagination
-      --per_page=<value>                      [default: 50] Number of results per page
-      --sort=<value>                          [default: created_at] Sort field
-DESCRIPTION
-  List all functions in a workspace from the Xano Metadata API
-EXAMPLES
-  $ xano function:list -w 40
-  Available functions:
-    - function-1 (ID: 1)
-    - function-2 (ID: 2)
-    - function-3 (ID: 3)
-  $ xano function:list --profile production
-  Available functions:
-    - my-function (ID: 1)
-    - another-function (ID: 2)
-  $ xano function:list -w 40 --output json
-  [
-    {
-      "id": 1,
-      "name": "function-1"
-    }
-  ]
-  $ xano function:list -p staging -o json --include_draft
-  [
-    {
-      "id": 1,
-      "name": "function-1"
-    }
-  ]
-```
-_See code: [src/commands/function/list/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/function/list/index.ts)_
-## `xano help [COMMAND]`
-Display help for xano.
-```
-USAGE
-  $ xano help [COMMAND...] [-n]
-ARGUMENTS
-  COMMAND...  Command to show help for.
-FLAGS
-  -n, --nested-commands  Include all nested commands in the output.
-DESCRIPTION
-  Display help for xano.
-```
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.33/src/commands/help.ts)_
-## `xano plugins`
-List installed plugins.
-```
-USAGE
-  $ xano plugins [--json] [--core]
-FLAGS
-  --core  Show core plugins.
-GLOBAL FLAGS
-  --json  Format output as json.
-DESCRIPTION
-  List installed plugins.
-EXAMPLES
-  $ xano plugins
-```
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.49/src/commands/plugins/index.ts)_
-## `xano plugins add PLUGIN`
-Installs a plugin into xano.
-```
-USAGE
-  $ xano plugins add PLUGIN... [--json] [-f] [-h] [-s | -v]
-ARGUMENTS
-  PLUGIN...  Plugin to install.
-FLAGS
-  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
-  -h, --help     Show CLI help.
-  -s, --silent   Silences npm output.
-  -v, --verbose  Show verbose npm output.
-GLOBAL FLAGS
-  --json  Format output as json.
-DESCRIPTION
-  Installs a plugin into xano.
-  Uses npm to install plugins.
-  Installation of a user-installed plugin will override a core plugin.
-  Use the XANO_NPM_LOG_LEVEL environment variable to set the npm loglevel.
-  Use the XANO_NPM_REGISTRY environment variable to set the npm registry.
-ALIASES
-  $ xano plugins add
-EXAMPLES
-  Install a plugin from npm registry.
-    $ xano plugins add myplugin
-  Install a plugin from a github url.
-    $ xano plugins add https://github.com/someuser/someplugin
-  Install a plugin from a github slug.
-    $ xano plugins add someuser/someplugin
-```
-## `xano plugins:inspect PLUGIN...`
-Displays installation properties of a plugin.
-```
-USAGE
-  $ xano plugins inspect PLUGIN...
-ARGUMENTS
-  PLUGIN...  [default: .] Plugin to inspect.
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-GLOBAL FLAGS
-  --json  Format output as json.
-DESCRIPTION
-  Displays installation properties of a plugin.
-EXAMPLES
-  $ xano plugins inspect myplugin
-```
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.49/src/commands/plugins/inspect.ts)_
-## `xano plugins install PLUGIN`
-Installs a plugin into xano.
-```
-USAGE
-  $ xano plugins install PLUGIN... [--json] [-f] [-h] [-s | -v]
-ARGUMENTS
-  PLUGIN...  Plugin to install.
-FLAGS
-  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
-  -h, --help     Show CLI help.
-  -s, --silent   Silences npm output.
-  -v, --verbose  Show verbose npm output.
-GLOBAL FLAGS
-  --json  Format output as json.
-DESCRIPTION
-  Installs a plugin into xano.
-  Uses npm to install plugins.
-  Installation of a user-installed plugin will override a core plugin.
-  Use the XANO_NPM_LOG_LEVEL environment variable to set the npm loglevel.
-  Use the XANO_NPM_REGISTRY environment variable to set the npm registry.
-ALIASES
-  $ xano plugins add
-EXAMPLES
-  Install a plugin from npm registry.
-    $ xano plugins install myplugin
-  Install a plugin from a github url.
-    $ xano plugins install https://github.com/someuser/someplugin
-  Install a plugin from a github slug.
-    $ xano plugins install someuser/someplugin
-```
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.49/src/commands/plugins/install.ts)_
-## `xano plugins link PATH`
-Links a plugin into the CLI for development.
-```
-USAGE
-  $ xano plugins link PATH [-h] [--install] [-v]
-ARGUMENTS
-  PATH  [default: .] path to plugin
-FLAGS
-  -h, --help          Show CLI help.
-  -v, --verbose
-      --[no-]install  Install dependencies after linking the plugin.
-DESCRIPTION
-  Links a plugin into the CLI for development.
-  Installation of a linked plugin will override a user-installed or core plugin.
-  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
-  command will override the user-installed or core plugin implementation. This is useful for development work.
-EXAMPLES
-  $ xano plugins link myplugin
-```
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.49/src/commands/plugins/link.ts)_
-## `xano plugins remove [PLUGIN]`
-Removes a plugin from the CLI.
-```
-USAGE
-  $ xano plugins remove [PLUGIN...] [-h] [-v]
-ARGUMENTS
-  PLUGIN...  plugin to uninstall
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-DESCRIPTION
-  Removes a plugin from the CLI.
-ALIASES
-  $ xano plugins unlink
-  $ xano plugins remove
-EXAMPLES
-  $ xano plugins remove myplugin
-```
-## `xano plugins reset`
-Remove all user-installed and linked plugins.
-```
-USAGE
-  $ xano plugins reset [--hard] [--reinstall]
-FLAGS
-  --hard       Delete node_modules and package manager related files in addition to uninstalling plugins.
-  --reinstall  Reinstall all plugins after uninstalling.
-```
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.49/src/commands/plugins/reset.ts)_
-## `xano plugins uninstall [PLUGIN]`
-Removes a plugin from the CLI.
-```
-USAGE
-  $ xano plugins uninstall [PLUGIN...] [-h] [-v]
-ARGUMENTS
-  PLUGIN...  plugin to uninstall
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-DESCRIPTION
-  Removes a plugin from the CLI.
-ALIASES
-  $ xano plugins unlink
-  $ xano plugins remove
-EXAMPLES
-  $ xano plugins uninstall myplugin
+```bash
+npm install -g @xano/cli
 ```
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.49/src/commands/plugins/uninstall.ts)_
+## Quick Start
-## `xano plugins unlink [PLUGIN]`
+1. Create a profile with the wizard:
+   ```bash
+   xano profile:wizard
+   ```
-Removes a plugin from the CLI.
+2. List your workspaces:
+   ```bash
+   xano workspace:list
+   ```
-```
-USAGE
-  $ xano plugins unlink [PLUGIN...] [-h] [-v]
+3. Run an ephemeral job:
+   ```bash
+   xano ephemeral:run:job -f script.xs
+   ```
-ARGUMENTS
-  PLUGIN...  plugin to uninstall
+## Commands
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
+### Profile Management
-DESCRIPTION
-  Removes a plugin from the CLI.
+Profiles store your Xano credentials and default workspace settings.
-ALIASES
-  $ xano plugins unlink
-  $ xano plugins remove
+```bash
+# Create a profile interactively
+xano profile:wizard
-EXAMPLES
-  $ xano plugins unlink myplugin
-```
+# Create a profile manually
+xano profile:create myprofile -i https://instance.xano.com -t <access_token>
-## `xano plugins update`
+# List profiles
+xano profile:list
+xano profile:list --details
-Update installed plugins.
+# Set default profile
+xano profile:set-default myprofile
-```
-USAGE
-  $ xano plugins update [-h] [-v]
+# Edit a profile
+xano profile:edit myprofile -w 123  # Set default workspace
-FLAGS
-  -h, --help     Show CLI help.
-  -v, --verbose
-DESCRIPTION
-  Update installed plugins.
+# Delete a profile
+xano profile:delete myprofile
 ```
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.49/src/commands/plugins/update.ts)_
-## `xano profile create NAME`
-Create a new profile configuration
+### Workspaces
+```bash
+# List all workspaces
+xano workspace:list
+xano workspace:list -o json
 ```
-USAGE
-  $ xano profile create NAME -i <value> -t <value> [-a <value>] [-w <value>] [-b <value>] [--default]
-ARGUMENTS
-  NAME  Profile name
-FLAGS
-  -a, --account_origin=<value>   Account origin URL. Optional for self hosted installs.
-  -b, --branch=<value>           Branch name
-  -i, --instance_origin=<value>  (required) Instance origin URL
-  -t, --access_token=<value>     (required) Access token for the Xano Metadata API
-  -w, --workspace=<value>        Workspace name
-      --default                  Set this profile as the default
-DESCRIPTION
-  Create a new profile configuration
+### Functions
-EXAMPLES
-  $ xano profile:create production --account_origin https://account.xano.com --instance_origin https://instance.xano.com --access_token token123
-  Profile 'production' created successfully at ~/.xano/credentials.yaml
+```bash
+# List functions in a workspace
+xano function:list -w 40
+xano function:list -o json
-  $ xano profile:create staging -a https://staging-account.xano.com -i https://staging-instance.xano.com -t token456
-  Profile 'staging' created successfully at ~/.xano/credentials.yaml
+# Get a specific function
+xano function:get 145
+xano function:get 145 -o xs  # Output as XanoScript
-  $ xano profile:create dev -i https://dev-instance.xano.com -t token789 -w my-workspace -b feature-branch
-  Profile 'dev' created successfully at ~/.xano/credentials.yaml
+# Create a function from XanoScript
+xano function:create -f function.xs
+cat function.xs | xano function:create --stdin
-  $ xano profile:create production --account_origin https://account.xano.com --instance_origin https://instance.xano.com --access_token token123 --default
-  Profile 'production' created successfully at ~/.xano/credentials.yaml
-  Default profile set to 'production'
+# Edit a function
+xano function:edit 145           # Opens in $EDITOR
+xano function:edit 145 -f new.xs # Update from file
+xano function:edit 145 --publish # Publish after editing
 ```
-_See code: [src/commands/profile/create/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/profile/create/index.ts)_
+### Ephemeral Jobs & Services
-## `xano profile delete NAME`
+Run XanoScript code without creating permanent resources.
-Delete a profile configuration
+```bash
+# Run a job (executes and returns result)
+xano ephemeral:run:job -f script.xs
+xano ephemeral:run:job -f script.xs -a args.json  # With input arguments
+xano ephemeral:run:job -f script.xs --edit        # Edit in $EDITOR first
+# Run a service (starts API endpoints)
+xano ephemeral:run:service -f service.xs
 ```
-USAGE
-  $ xano profile delete NAME [-f]
-ARGUMENTS
-  NAME  Profile name to delete
-FLAGS
-  -f, --force  Skip confirmation prompt
-DESCRIPTION
-  Delete a profile configuration
+### Static Hosts
-EXAMPLES
-  $ xano profile:delete old-profile
-  Are you sure you want to delete profile 'old-profile'? (y/n): y
-  Profile 'old-profile' deleted successfully from ~/.xano/credentials.yaml
+```bash
+# List static hosts
+xano static_host:list
-  $ xano profile:delete old-profile --force
-  Profile 'old-profile' deleted successfully from ~/.xano/credentials.yaml
+# Create a build
+xano static_host:build:create default -f ./build.zip -n "v1.0.0"
-  $ xano profile:delete old-profile -f
-  Profile 'old-profile' deleted successfully from ~/.xano/credentials.yaml
-```
-_See code: [src/commands/profile/delete/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/profile/delete/index.ts)_
-## `xano profile edit NAME`
-Edit an existing profile configuration
+# List builds
+xano static_host:build:list default
+# Get build details
+xano static_host:build:get default 52
 ```
-USAGE
-  $ xano profile edit NAME [-a <value>] [-i <value>] [-t <value>] [-w <value>] [-b <value>] [--remove-workspace]
-    [--remove-branch]
-ARGUMENTS
-  NAME  Profile name to edit
-FLAGS
-  -a, --account_origin=<value>   Update account origin URL
-  -b, --branch=<value>           Update branch name
-  -i, --instance_origin=<value>  Update instance origin URL
-  -t, --access_token=<value>     Update access token for the Xano Metadata API
-  -w, --workspace=<value>        Update workspace name
-      --remove-branch            Remove branch from profile
-      --remove-workspace         Remove workspace from profile
+## Global Options
-DESCRIPTION
-  Edit an existing profile configuration
-EXAMPLES
-  $ xano profile:edit production --access_token new_token123
-  Profile 'production' updated successfully at ~/.xano/credentials.yaml
-  $ xano profile:edit staging -i https://new-staging-instance.xano.com -t new_token456
-  Profile 'staging' updated successfully at ~/.xano/credentials.yaml
-  $ xano profile:edit dev -w new-workspace -b new-branch
-  Profile 'dev' updated successfully at ~/.xano/credentials.yaml
-  $ xano profile:edit dev --remove-workspace
-  Profile 'dev' updated successfully at ~/.xano/credentials.yaml
-```
+All commands support these options:
-_See code: [src/commands/profile/edit/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/profile/edit/index.ts)_
-## `xano profile get-default`
-Get the current default profile name
-```
-USAGE
-  $ xano profile get-default
-DESCRIPTION
-  Get the current default profile name
-EXAMPLES
-  $ xano profile:get-default
-  production
-  $ xano profile:get-default
-  No default profile set
-```
-_See code: [src/commands/profile/get-default/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/profile/get-default/index.ts)_
-## `xano profile list`
-List all available profile configurations
-```
-USAGE
-  $ xano profile list [-d]
-FLAGS
-  -d, --details  Show detailed information for each profile
-DESCRIPTION
-  List all available profile configurations
-EXAMPLES
-  $ xano profile:list
-  Available profiles:
-    - default
-    - production
-    - staging
-    - development
-  $ xano profile:list --details
-  Available profiles:
-  Profile: default
-    Account Origin: https://account.xano.com
-    Instance Origin: https://instance.xano.com
-    Access Token: ***...***
-    Workspace: my-workspace
-    Branch: main
-  Profile: production
-    Account Origin: https://account.xano.com
-    Instance Origin: https://prod-instance.xano.com
-    Access Token: ***...***
-  $ xano profile:list -d
-  Available profiles:
-  Profile: default
-    Account Origin: https://account.xano.com
-    Instance Origin: https://instance.xano.com
-    Access Token: ***...***
-    Workspace: my-workspace
-    Branch: main
-```
+| Flag | Description |
+|------|-------------|
+| `-p, --profile` | Profile to use (or set `XANO_PROFILE` env var) |
+| `-w, --workspace` | Workspace ID (overrides profile default) |
+| `-o, --output` | Output format: `summary` (default) or `json` |
-_See code: [src/commands/profile/list/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/profile/list/index.ts)_
+## Configuration
-## `xano profile set-default NAME`
+Profiles are stored in `~/.xano/credentials.yaml`.
-Set the default profile
+## Help
+```bash
+xano --help
+xano <command> --help
 ```
-USAGE
-  $ xano profile set-default NAME
-ARGUMENTS
-  NAME  Profile name to set as default
-DESCRIPTION
-  Set the default profile
-EXAMPLES
-  $ xano profile:set-default production
-  Default profile set to 'production'
-  $ xano profile:set-default staging
-  Default profile set to 'staging'
-```
-_See code: [src/commands/profile/set-default/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/profile/set-default/index.ts)_
-## `xano profile wizard`
-Create a new profile configuration using an interactive wizard
-```
-USAGE
-  $ xano profile wizard [-n <value>] [-o <value>]
-FLAGS
-  -n, --name=<value>    Profile name (skip prompt if provided)
-  -o, --origin=<value>  [default: https://app.xano.com] Xano instance origin URL
-DESCRIPTION
-  Create a new profile configuration using an interactive wizard
-EXAMPLES
-  $ xano profile:wizard
-  Welcome to the Xano Profile Wizard!
-  ? Enter your access token: ***...***
-  ? Select an instance:
-    > Production (https://app.xano.com)
-      Staging (https://staging.xano.com)
-  ? Profile name: production
-  Profile 'production' created successfully at ~/.xano/credentials.yaml
-```
-_See code: [src/commands/profile/wizard/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/profile/wizard/index.ts)_
-## `xano static_host build create STATIC_HOST`
-Create a new build for a static host
-```
-USAGE
-  $ xano static_host build create STATIC_HOST -f <value> -n <value> [-p <value>] [-w <value>] [-d <value>] [-o
-  summary|json]
-ARGUMENTS
-  STATIC_HOST  Static Host name
-FLAGS
-  -d, --description=<value>                   Build description
-  -f, --file=<value>                          (required) Path to zip file to upload
-  -n, --name=<value>                          (required) Build name
-  -o, --output=<option>                       [default: summary] Output format
-                                              <options: summary|json>
-  -p, --profile=<value>  [env: XANO_PROFILE]  Profile to use for this command
-  -w, --workspace=<value>                     Workspace ID (optional if set in profile)
-DESCRIPTION
-  Create a new build for a static host
-EXAMPLES
-  $ xano static_host:build:create default -f ./build.zip -n "v1.0.0"
-  Build created successfully!
-  ID: 123
-  Name: v1.0.0
-  Status: pending
-  $ xano static_host:build:create default -w 40 -f ./dist.zip -n "production" -d "Production build"
-  Build created successfully!
-  ID: 124
-  Name: production
-  Description: Production build
-  $ xano static_host:build:create myhost -f ./app.zip -n "release-1.2" -o json
-  {
-    "id": 125,
-    "name": "release-1.2",
-    "status": "pending"
-  }
-```
-_See code: [src/commands/static_host/build/create/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/static_host/build/create/index.ts)_
-## `xano static_host build get STATIC_HOST BUILD_ID`
-Get details of a specific build for a static host
-```
-USAGE
-  $ xano static_host build get STATIC_HOST BUILD_ID [-p <value>] [-w <value>] [-o summary|json]
-ARGUMENTS
-  STATIC_HOST  Static Host name
-  BUILD_ID     Build ID
-FLAGS
-  -o, --output=<option>                       [default: summary] Output format
-                                              <options: summary|json>
-  -p, --profile=<value>  [env: XANO_PROFILE]  Profile to use for this command
-  -w, --workspace=<value>                     Workspace ID (optional if set in profile)
-DESCRIPTION
-  Get details of a specific build for a static host
-EXAMPLES
-  $ xano static_host:build:get default 52
-  Build Details:
-  ID: 52
-  Name: v1.0.0
-  Status: completed
-  $ xano static_host:build:get default 52 -w 40
-  Build Details:
-  ID: 52
-  Name: v1.0.0
-  Status: completed
-  $ xano static_host:build:get myhost 123 --profile production
-  Build Details:
-  ID: 123
-  Name: production-build
-  $ xano static_host:build:get default 52 -o json
-  {
-    "id": 52,
-    "name": "v1.0.0",
-    "status": "completed"
-  }
-```
-_See code: [src/commands/static_host/build/get/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/static_host/build/get/index.ts)_
-## `xano static_host build list STATIC_HOST`
-List all builds for a static host
-```
-USAGE
-  $ xano static_host build list STATIC_HOST [-p <value>] [-w <value>] [-o summary|json] [--page <value>] [--per_page
-  <value>]
-ARGUMENTS
-  STATIC_HOST  Static Host name
-FLAGS
-  -o, --output=<option>                       [default: summary] Output format
-                                              <options: summary|json>
-  -p, --profile=<value>  [env: XANO_PROFILE]  Profile to use for this command
-  -w, --workspace=<value>                     Workspace ID (optional if set in profile)
-      --page=<value>                          [default: 1] Page number for pagination
-      --per_page=<value>                      [default: 50] Number of results per page
-DESCRIPTION
-  List all builds for a static host
-EXAMPLES
-  $ xano static_host:build:list default -w 40
-  Available builds:
-    - v1.0.0 (ID: 1) - Status: completed
-    - v1.0.1 (ID: 2) - Status: pending
-  $ xano static_host:build:list myhost --profile production
-  Available builds:
-    - production (ID: 1) - Status: completed
-    - staging (ID: 2) - Status: completed
-  $ xano static_host:build:list default -w 40 --output json
-  [
-    {
-      "id": 1,
-      "name": "v1.0.0",
-      "status": "completed"
-    }
-  ]
-  $ xano static_host:build:list default -p staging -o json --page 2
-  [
-    {
-      "id": 3,
-      "name": "v1.0.2"
-    }
-  ]
-```
-_See code: [src/commands/static_host/build/list/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/static_host/build/list/index.ts)_
-## `xano static_host list`
-List all static hosts in a workspace from the Xano Metadata API
-```
-USAGE
-  $ xano static_host list [-p <value>] [-w <value>] [-o summary|json] [--page <value>] [--per_page <value>]
-FLAGS
-  -o, --output=<option>                       [default: summary] Output format
-                                              <options: summary|json>
-  -p, --profile=<value>  [env: XANO_PROFILE]  Profile to use for this command
-  -w, --workspace=<value>                     Workspace ID (optional if set in profile)
-      --page=<value>                          [default: 1] Page number for pagination
-      --per_page=<value>                      [default: 50] Number of results per page
-DESCRIPTION
-  List all static hosts in a workspace from the Xano Metadata API
-EXAMPLES
-  $ xano static_host:list -w 40
-  Available static hosts:
-    - my-static-host (ID: 1)
-    - another-host (ID: 2)
-  $ xano static_host:list --profile production
-  Available static hosts:
-    - my-static-host (ID: 1)
-    - another-host (ID: 2)
-  $ xano static_host:list -w 40 --output json
-  [
-    {
-      "id": 1,
-      "name": "my-static-host",
-      "domain": "example.com"
-    }
-  ]
-  $ xano static_host:list -p staging -o json --page 2
-  [
-    {
-      "id": 3,
-      "name": "static-host-3"
-    }
-  ]
-```
-_See code: [src/commands/static_host/list/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/static_host/list/index.ts)_
-## `xano workspace list`
-List all workspaces from the Xano Metadata API
-```
-USAGE
-  $ xano workspace list [-p <value>] [-o summary|json]
-FLAGS
-  -o, --output=<option>                       [default: summary] Output format
-                                              <options: summary|json>
-  -p, --profile=<value>  [env: XANO_PROFILE]  Profile to use for this command
-DESCRIPTION
-  List all workspaces from the Xano Metadata API
-EXAMPLES
-  $ xano workspace:list
-  Available workspaces:
-    - workspace-1 (ID: 1)
-    - workspace-2 (ID: 2)
-    - workspace-3 (ID: 3)
-  $ xano workspace:list --profile production
-  Available workspaces:
-    - my-app (ID: 1)
-    - staging-env (ID: 2)
-  $ xano workspace:list --output json
-  {
-    "workspaces": [
-      {
-        "id": 1,
-        "name": "workspace-1"
-      },
-      {
-        "id": 2,
-        "name": "workspace-2"
-      }
-    ]
-  }
-  $ xano workspace:list -p staging -o json
-  {
-    "workspaces": [
-      {
-        "id": 1,
-        "name": "my-app"
-      }
-    ]
-  }
-```
-_See code: [src/commands/workspace/list/index.ts](https://github.com/xano-inc/cli/blob/v0.0.4/src/commands/workspace/list/index.ts)_
-<!-- commandsstop -->