@xano/developer-mcp 1.0.59 → 1.0.61

package/README.md

@@ -500,12 +500,19 @@ Use this tool to understand CLI commands for local development, code synchroniza
 | Topic | Description |
 |-------|-------------|
 | `start` | Getting started with the CLI - installation and setup |
+| `auth` | Browser-based OAuth authentication |
 | `profile` | Profile management - credentials and multi-environment setup |
-| `workspace` | Workspace operations - pull/push code sync |
+| `workspace` | Workspace operations - pull/push code sync, git integration |
 | `branch` | Branch management - list, switch, create, and delete branches |
 | `function` | Function management - list, get, create, edit |
+| `release` | Release management - create, export, import, pull, push |
+| `tenant` | Tenant management - CRUD, deployments, env vars, backups, clusters |
+| `unit_test` | Unit test management - list and run unit tests |
+| `workflow_test` | Workflow test management - list, run, and manage workflow tests |
 | `run` | Run API commands - execute code, manage projects/sessions |
+| `platform` | Platform management - list and view platform versions |
 | `static_host` | Static hosting - deploy frontend builds |
+| `update` | Update the CLI to the latest version |
 | `integration` | CLI + Meta API integration guide - when to use each |
 
 **Examples:**

package/dist/cli_docs/index.js

@@ -6,25 +6,39 @@
  */
 import { formatDocumentation } from "./format.js";
 // Import all topic documentation
+import { authDoc } from "./topics/auth.js";
 import { startDoc } from "./topics/start.js";
 import { profileDoc } from "./topics/profile.js";
 import { workspaceDoc } from "./topics/workspace.js";
 import { branchDoc } from "./topics/branch.js";
 import { functionDoc } from "./topics/function.js";
+import { releaseDoc } from "./topics/release.js";
+import { tenantDoc } from "./topics/tenant.js";
+import { unitTestDoc } from "./topics/unit_test.js";
+import { workflowTestDoc } from "./topics/workflow_test.js";
 import { runDoc } from "./topics/run.js";
+import { platformDoc } from "./topics/platform.js";
 import { staticHostDoc } from "./topics/static_host.js";
+import { updateDoc } from "./topics/update.js";
 import { integrationDoc } from "./topics/integration.js";
 /**
  * All available documentation topics
  */
 export const topics = {
+    auth: authDoc,
     start: startDoc,
     profile: profileDoc,
     workspace: workspaceDoc,
     branch: branchDoc,
     function: functionDoc,
+    release: releaseDoc,
+    tenant: tenantDoc,
+    unit_test: unitTestDoc,
+    workflow_test: workflowTestDoc,
     run: runDoc,
+    platform: platformDoc,
     static_host: staticHostDoc,
+    update: updateDoc,
     integration: integrationDoc,
 };
 /**
@@ -72,8 +86,9 @@ ${getTopicDescriptions()}
 
 ## Usage
 - Start with "start" topic for installation and setup
+- Use "auth" or "profile" to understand authentication options
 - Use "integration" to understand when to use CLI vs Meta API
-- Use specific topics (profile, workspace, function, run) for command reference`,
+- Use specific topics for command reference (workspace, branch, release, tenant, function, run, etc.)`,
     inputSchema: {
         type: "object",
         properties: {

package/dist/cli_docs/topics/auth.d.ts

@@ -0,0 +1,2 @@
+import type { TopicDoc } from "../types.js";
+export declare const authDoc: TopicDoc;

package/dist/cli_docs/topics/auth.js

@@ -0,0 +1,62 @@
+export const authDoc = {
+    topic: "auth",
+    title: "Xano CLI - Authentication",
+    description: `The \`auth\` command provides browser-based OAuth authentication for the Xano CLI. It opens your browser, lets you log in to your Xano account, and automatically creates a profile with your credentials.
+
+## How It Works
+
+1. CLI starts a local HTTP server on a random port
+2. Opens your browser to the Xano login page
+3. After login, Xano redirects back to the local server with your token
+4. CLI validates the token, lets you select instance/workspace/branch
+5. Saves the profile to \`~/.xano/credentials.yaml\`
+
+The authentication flow has a 5-minute timeout.`,
+    ai_hints: `**auth vs profile:wizard:**
+- \`xano auth\` - Browser-based OAuth login (recommended for interactive use)
+- \`xano profile:wizard\` - Token-based interactive setup (requires manually copying token)
+- \`xano profile:create\` - Non-interactive, requires all flags
+
+**When to suggest auth:**
+- User is setting up CLI for the first time
+- User doesn't have an access token handy
+- User prefers browser-based login
+
+**When to suggest profile:wizard instead:**
+- User already has an access token
+- User is in a headless/SSH environment without browser access
+- User needs non-interactive setup (CI/CD)`,
+    related_topics: ["profile", "start"],
+    commands: [
+        {
+            name: "auth",
+            description: "Authenticate with Xano via browser login. Opens your browser to log in and automatically creates a CLI profile.",
+            usage: "xano auth [options]",
+            flags: [
+                { name: "origin", type: "string", required: false, description: "Xano account origin URL (e.g., https://app.xano.com)" },
+                { name: "insecure", short: "k", type: "boolean", required: false, description: "Skip TLS certificate verification (for self-signed certs)" }
+            ],
+            examples: [
+                "xano auth",
+                "xano auth --origin https://app.xano.com",
+                "xano auth -k  # for self-signed certificates"
+            ]
+        }
+    ],
+    workflows: [
+        {
+            name: "First-Time Setup with Browser Login",
+            description: "Set up the CLI using browser-based authentication",
+            steps: [
+                "Install CLI: `npm install -g @xano/cli`",
+                "Run: `xano auth`",
+                "Log in via your browser when it opens",
+                "Select your instance, workspace, and branch",
+                "Verify: `xano profile:me`"
+            ],
+            example: `npm install -g @xano/cli
+xano auth
+xano profile:me`
+        }
+    ]
+};

package/dist/cli_docs/topics/branch.js

@@ -29,7 +29,7 @@ Branches are identified by their **label** (e.g., "v1", "dev", "staging"), not n
 - Most commands need a workspace ID
 - Pass via \`--workspace\` flag or configure in profile
 - Use \`xano workspace:list\` to find workspace IDs`,
-    related_topics: ["workspace", "profile", "integration"],
+    related_topics: ["workspace", "release", "profile", "integration"],
     commands: [
         {
             name: "branch:list",

package/dist/cli_docs/topics/function.js

@@ -29,7 +29,8 @@ export const functionDoc = {
                 { name: "search", type: "string", required: false, description: "Search by name" },
                 { name: "sort", type: "string", required: false, description: "Sort field" },
                 { name: "order", type: "string", required: false, description: "Sort order: asc, desc" },
-                { name: "include_draft", type: "boolean", required: false, description: "Include draft versions" }
+                { name: "include_draft", type: "boolean", required: false, description: "Include draft versions" },
+                { name: "include_xanoscript", type: "boolean", required: false, description: "Include XanoScript source in output" }
             ],
             examples: [
                 "xano function:list",
@@ -81,11 +82,16 @@ export const functionDoc = {
             ],
             flags: [
                 { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID" },
-                { name: "file", short: "f", type: "string", required: false, description: "Path to .xs file with updated code" }
+                { name: "file", short: "f", type: "string", required: false, description: "Path to .xs file with updated code" },
+                { name: "stdin", type: "boolean", required: false, description: "Read updated code from stdin" },
+                { name: "edit", type: "boolean", required: false, description: "Open current code in $EDITOR before updating" },
+                { name: "no-publish", type: "boolean", required: false, description: "Save as draft without publishing" }
             ],
             examples: [
                 "xano function:edit 145",
-                "xano function:edit 145 -f ./updated_function.xs"
+                "xano function:edit 145 -f ./updated_function.xs",
+                "xano function:edit 145 --edit",
+                "xano function:edit 145 --no-publish"
             ]
         }
     ],

package/dist/cli_docs/topics/integration.js

@@ -21,8 +21,13 @@ npm install -g @xano/cli
 | Local development | Yes | - |
 | Code sync (pull/push) | Yes | - |
 | Quick function edits | Yes | - |
+| Branch management | Yes | Yes |
+| Release management | Yes | Yes |
+| Tenant management | Yes | Yes |
+| Run unit/workflow tests | Yes | - |
 | Execute XanoScript | Yes | Yes (Run API) |
 | CI/CD automation | Both | Both |
+| Deploy static sites | Yes | - |
 | Programmatic management | - | Yes |
 | Create tables/schemas | - | Yes |
 | Manage API groups | - | Yes |
@@ -82,7 +87,7 @@ TOKEN=$(xano profile:token)
 # Use with Meta API
 curl -H "Authorization: Bearer $TOKEN" https://instance.xano.io/api:meta/workspace
 \`\`\``,
-    related_topics: ["start", "profile", "workspace"],
+    related_topics: ["start", "auth", "profile", "workspace", "release", "tenant"],
     workflows: [
         {
             name: "Local Development with Version Control",

package/dist/cli_docs/topics/platform.d.ts

@@ -0,0 +1,2 @@
+import type { TopicDoc } from "../types.js";
+export declare const platformDoc: TopicDoc;

package/dist/cli_docs/topics/platform.js

@@ -0,0 +1,41 @@
+export const platformDoc = {
+    topic: "platform",
+    title: "Xano CLI - Platform Management",
+    description: `Platform commands let you view available Xano platform versions. Platforms define the runtime environment for tenants and can be deployed to tenants using \`tenant:deploy_platform\`.`,
+    ai_hints: `**Platforms are read-only in the CLI** - you can list and view them but not create/modify.
+
+**Use cases:**
+- Check available platform versions before deploying to a tenant
+- Get platform details (version, features, etc.)
+- Used with \`tenant:deploy_platform\` to update a tenant's runtime`,
+    related_topics: ["tenant"],
+    commands: [
+        {
+            name: "platform:list",
+            description: "List all available platform versions",
+            usage: "xano platform:list [options]",
+            flags: [
+                { name: "output", short: "o", type: "string", required: false, default: "summary", description: "Output format: summary or json" }
+            ],
+            examples: [
+                "xano platform:list",
+                "xano platform:list -o json"
+            ]
+        },
+        {
+            name: "platform:get",
+            description: "Get details of a specific platform version",
+            usage: "xano platform:get <platform_id> [options]",
+            args: [
+                { name: "platform_id", required: true, description: "Platform ID" }
+            ],
+            flags: [
+                { name: "output", short: "o", type: "string", required: false, default: "summary", description: "Output format: summary or json" }
+            ],
+            examples: [
+                "xano platform:get 5",
+                "xano platform:get 5 -o json"
+            ]
+        }
+    ]
+};

package/dist/cli_docs/topics/profile.js

@@ -38,18 +38,28 @@ default: production
 **Switching contexts:**
 - Use \`-p <profile>\` flag on any command
 - Or set \`XANO_PROFILE\` environment variable
-- Or use \`profile:set-default\` to change default`,
-    related_topics: ["start", "integration"],
+- Or use \`profile:set\` to change default
+
+**Alternative auth methods:**
+- \`xano auth\` - Browser-based OAuth login (no token needed)
+- \`xano profile:wizard\` - Interactive token-based setup
+- \`xano profile:create\` - Non-interactive (for CI/CD)`,
+    related_topics: ["auth", "start", "integration"],
     commands: [
         {
             name: "profile:wizard",
-            description: "Interactive setup wizard for creating a profile",
-            usage: "xano profile:wizard",
-            examples: ["xano profile:wizard"]
+            description: "Interactive setup wizard for creating a profile. Prompts for token, instance, workspace, and branch.",
+            usage: "xano profile:wizard [options]",
+            flags: [
+                { name: "name", short: "n", type: "string", required: false, description: "Profile name (prompted if not provided)" },
+                { name: "origin", short: "o", type: "string", required: false, description: "Xano account origin URL" },
+                { name: "insecure", short: "k", type: "boolean", required: false, description: "Skip TLS certificate verification" }
+            ],
+            examples: ["xano profile:wizard", "xano profile:wizard -n myprofile"]
         },
         {
             name: "profile:create",
-            description: "Create a new profile with explicit flags",
+            description: "Create a new profile with explicit flags (non-interactive)",
             usage: "xano profile:create <name> -i <instance_origin> -t <token> [options]",
             args: [
                 { name: "name", required: true, description: "Profile name" }
@@ -57,13 +67,15 @@ default: production
             flags: [
                 { name: "instance_origin", short: "i", type: "string", required: true, description: "Xano instance URL" },
                 { name: "access_token", short: "t", type: "string", required: true, description: "Access token" },
+                { name: "account_origin", short: "a", type: "string", required: false, description: "Xano account origin URL" },
                 { name: "workspace", short: "w", type: "string", required: false, description: "Default workspace ID" },
-                { name: "branch", short: "b", type: "string", required: false, description: "Default branch ID" },
-                { name: "project", short: "j", type: "string", required: false, description: "Default Run project ID" }
+                { name: "branch", short: "b", type: "string", required: false, description: "Default branch label" },
+                { name: "default", type: "boolean", required: false, description: "Set as the default profile" },
+                { name: "insecure", short: "k", type: "boolean", required: false, description: "Skip TLS certificate verification" }
             ],
             examples: [
                 "xano profile:create production -i https://x8ki.xano.io -t mytoken123",
-                "xano profile:create staging -i https://x8ki.xano.io -t mytoken -w 1 -b 2"
+                "xano profile:create staging -i https://x8ki.xano.io -t mytoken -w 1 -b dev --default"
             ]
         },
         {
@@ -71,71 +83,94 @@ default: production
             description: "List all configured profiles",
             usage: "xano profile:list [--details]",
             flags: [
-                { name: "details", type: "boolean", required: false, description: "Show masked tokens and full config" }
+                { name: "details", short: "d", type: "boolean", required: false, description: "Show masked tokens, origins, workspace, branch, and insecure status" }
             ],
             examples: ["xano profile:list", "xano profile:list --details"]
         },
         {
             name: "profile:edit",
             description: "Edit an existing profile",
-            usage: "xano profile:edit <name> [options]",
+            usage: "xano profile:edit [name] [options]",
             args: [
-                { name: "name", required: true, description: "Profile name to edit" }
+                { name: "name", required: false, description: "Profile name to edit (uses default if not provided)" }
             ],
             flags: [
+                { name: "access_token", short: "t", type: "string", required: false, description: "Update access token" },
+                { name: "instance_origin", short: "i", type: "string", required: false, description: "Update instance URL" },
+                { name: "account_origin", short: "a", type: "string", required: false, description: "Update account origin URL" },
                 { name: "workspace", short: "w", type: "string", required: false, description: "Set workspace ID" },
-                { name: "branch", short: "b", type: "string", required: false, description: "Set branch ID" },
-                { name: "project", short: "j", type: "string", required: false, description: "Set Run project ID" },
+                { name: "branch", short: "b", type: "string", required: false, description: "Set branch label" },
+                { name: "insecure", type: "boolean", required: false, description: "Enable insecure mode for self-signed certs" },
                 { name: "remove-workspace", type: "boolean", required: false, description: "Remove workspace setting" },
-                { name: "remove-branch", type: "boolean", required: false, description: "Remove branch setting" }
+                { name: "remove-branch", type: "boolean", required: false, description: "Remove branch setting" },
+                { name: "remove-insecure", type: "boolean", required: false, description: "Remove insecure setting" }
             ],
             examples: [
                 "xano profile:edit production -w 2",
-                "xano profile:edit staging --remove-branch"
+                "xano profile:edit staging --remove-branch",
+                "xano profile:edit production -t new-token-here"
             ]
         },
         {
             name: "profile:delete",
-            description: "Delete a profile",
+            description: "Delete a profile. Auto-updates default if deleting the current default.",
             usage: "xano profile:delete <name> [--force]",
             args: [
                 { name: "name", required: true, description: "Profile name to delete" }
             ],
             flags: [
-                { name: "force", type: "boolean", required: false, description: "Skip confirmation prompt" }
+                { name: "force", short: "f", type: "boolean", required: false, description: "Skip confirmation prompt" }
             ],
             examples: ["xano profile:delete old-profile", "xano profile:delete test --force"]
         },
         {
-            name: "profile:set-default",
+            name: "profile:set",
             description: "Set the default profile",
-            usage: "xano profile:set-default <name>",
+            usage: "xano profile:set <name>",
             args: [
                 { name: "name", required: true, description: "Profile to set as default" }
             ],
-            examples: ["xano profile:set-default production"]
+            examples: ["xano profile:set production"]
         },
         {
-            name: "profile:get-default",
-            description: "Show the current default profile name",
-            usage: "xano profile:get-default",
-            examples: ["xano profile:get-default"]
+            name: "profile:get",
+            description: "Print the current default profile name",
+            usage: "xano profile:get",
+            examples: ["xano profile:get"]
         },
         {
             name: "profile:me",
-            description: "Display current authenticated user info",
-            usage: "xano profile:me [-p <profile>]",
-            examples: ["xano profile:me", "xano profile:me -p staging"]
+            description: "Display current authenticated user info (ID, name, email, instance)",
+            usage: "xano profile:me [options]",
+            flags: [
+                { name: "output", short: "o", type: "string", required: false, default: "summary", description: "Output format: summary or json" }
+            ],
+            examples: ["xano profile:me", "xano profile:me -p staging", "xano profile:me -o json"]
         },
         {
             name: "profile:token",
-            description: "Print the access token (for piping to clipboard)",
-            usage: "xano profile:token [-p <profile>]",
+            description: "Print the access token for the default profile (useful for piping)",
+            usage: "xano profile:token",
             examples: [
                 "xano profile:token",
                 "xano profile:token | pbcopy  # macOS",
                 "xano profile:token | xclip   # Linux"
             ]
+        },
+        {
+            name: "profile:workspace",
+            description: "Print the workspace ID for the default profile",
+            usage: "xano profile:workspace",
+            examples: ["xano profile:workspace"]
+        },
+        {
+            name: "profile:workspace:set",
+            description: "Interactively select and set the workspace for a profile",
+            usage: "xano profile:workspace:set [-p <profile>]",
+            examples: [
+                "xano profile:workspace:set",
+                "xano profile:workspace:set -p staging"
+            ]
         }
     ],
     workflows: [
@@ -145,7 +180,7 @@ default: production
             steps: [
                 "Create production profile: `xano profile:create prod -i <url> -t <token> -b 1`",
                 "Create staging profile: `xano profile:create staging -i <url> -t <token> -b 2`",
-                "Set default: `xano profile:set-default prod`",
+                "Set default: `xano profile:set prod`",
                 "Use staging when needed: `xano workspace:pull ./code -p staging`"
             ]
         }

package/dist/cli_docs/topics/release.d.ts

@@ -0,0 +1,2 @@
+import type { TopicDoc } from "../types.js";
+export declare const releaseDoc: TopicDoc;

package/dist/cli_docs/topics/release.js

@@ -0,0 +1,215 @@
+export const releaseDoc = {
+    topic: "release",
+    title: "Xano CLI - Release Management",
+    description: `Release commands let you manage named releases in a Xano workspace. Releases are versioned snapshots of a branch, used for deploying specific versions to tenants.
+
+## Key Concepts
+
+- **Release**: A named snapshot of a branch at a point in time, used for versioned deployments.
+- **Hotfix release**: A release that bypasses the normal release flow for urgent production fixes.
+- **Export/Import**: Releases can be exported as portable files and imported into other workspaces.
+- **Pull/Push**: Similar to \`workspace:pull\` and \`workspace:push\`, but scoped to a release in multidoc format.
+
+## Release Identification
+
+Releases are identified by their **name** (e.g., "v1.0.0", "2024-03-hotfix").`,
+    ai_hints: `**Key concepts:**
+- Releases are versioned snapshots of a branch, created for deployment to tenants
+- Created from branches and deployed to tenants as part of the release lifecycle
+- \`release:pull\` and \`release:push\` work like \`workspace:pull\` and \`workspace:push\` but scoped to releases
+- \`release:export\` and \`release:import\` allow portable release files for moving between workspaces
+- Hotfix releases bypass the normal release flow for urgent production fixes
+- Use \`--table-ids\` on \`release:create\` to include only specific tables in the release
+
+**Typical workflow:**
+1. \`xano release:list\` - see available releases
+2. \`xano release:create -n v1.0.0 -b dev\` - create release from branch
+3. Deploy release to tenant (see tenant topic)
+4. \`xano release:export v1.0.0 --output ./release.tar.gz\` - export for portability`,
+    related_topics: ["branch", "tenant", "workspace"],
+    commands: [
+        {
+            name: "release:list",
+            description: "List all releases in a workspace",
+            usage: "xano release:list [options]",
+            flags: [
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID (uses profile workspace if not provided)" },
+                { name: "output", short: "o", type: "string", required: false, default: "summary", description: "Output format: summary or json" }
+            ],
+            examples: [
+                "xano release:list",
+                "xano release:list -w 123",
+                "xano release:list --output json"
+            ]
+        },
+        {
+            name: "release:get",
+            description: "Get details for a specific release",
+            usage: "xano release:get <release_name> [options]",
+            args: [
+                { name: "release_name", required: true, description: "Name of the release to retrieve" }
+            ],
+            flags: [
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID (uses profile workspace if not provided)" },
+                { name: "output", short: "o", type: "string", required: false, default: "summary", description: "Output format: summary or json" }
+            ],
+            examples: [
+                "xano release:get v1.0.0",
+                "xano release:get v1.0.0 --output json"
+            ]
+        },
+        {
+            name: "release:create",
+            description: "Create a named release from a branch",
+            usage: "xano release:create --name <name> --branch <branch> [options]",
+            flags: [
+                { name: "name", short: "n", type: "string", required: true, description: "Name for the new release" },
+                { name: "branch", short: "b", type: "string", required: true, description: "Branch to create the release from" },
+                { name: "description", short: "d", type: "string", required: false, description: "Description for the release" },
+                { name: "hotfix", type: "boolean", required: false, description: "Mark this release as a hotfix" },
+                { name: "table-ids", type: "string", required: false, description: "Comma-separated table IDs to include in the release" },
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID (uses profile workspace if not provided)" },
+                { name: "output", short: "o", type: "string", required: false, default: "summary", description: "Output format: summary or json" }
+            ],
+            examples: [
+                "xano release:create -n v1.0.0 -b dev",
+                'xano release:create --name v1.1.0 --branch staging -d "Staging release"',
+                "xano release:create -n hotfix-auth -b v1 --hotfix"
+            ]
+        },
+        {
+            name: "release:edit",
+            description: "Edit release metadata",
+            usage: "xano release:edit <release_name> [options]",
+            args: [
+                { name: "release_name", required: true, description: "Name of the release to edit" }
+            ],
+            flags: [
+                { name: "name", short: "n", type: "string", required: false, description: "New name for the release" },
+                { name: "description", short: "d", type: "string", required: false, description: "New description for the release" },
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID (uses profile workspace if not provided)" }
+            ],
+            examples: [
+                "xano release:edit v1.0.0 --name v1.0.1",
+                'xano release:edit v1.0.0 -d "Updated description"'
+            ]
+        },
+        {
+            name: "release:delete",
+            description: "Delete a release",
+            usage: "xano release:delete <release_name> [options]",
+            args: [
+                { name: "release_name", required: true, description: "Name of the release to delete" }
+            ],
+            flags: [
+                { name: "force", type: "boolean", required: false, description: "Skip confirmation prompt" },
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID (uses profile workspace if not provided)" }
+            ],
+            examples: [
+                "xano release:delete v1.0.0",
+                "xano release:delete v1.0.0 --force"
+            ]
+        },
+        {
+            name: "release:export",
+            description: "Download a release as a portable file",
+            usage: "xano release:export <release_name> [options]",
+            args: [
+                { name: "release_name", required: true, description: "Name of the release to export" }
+            ],
+            flags: [
+                { name: "output", type: "string", required: false, description: "File path for the downloaded release file" },
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID (uses profile workspace if not provided)" }
+            ],
+            examples: [
+                "xano release:export v1.0.0",
+                "xano release:export v1.0.0 --output ./releases/v1.0.0.tar.gz"
+            ]
+        },
+        {
+            name: "release:import",
+            description: "Import a release from a file",
+            usage: "xano release:import --file <path> [options]",
+            flags: [
+                { name: "file", type: "string", required: true, description: "Path to the release file to import" },
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID (uses profile workspace if not provided)" }
+            ],
+            examples: [
+                "xano release:import --file ./releases/v1.0.0.tar.gz",
+                "xano release:import --file ./release.tar.gz -w 123"
+            ]
+        },
+        {
+            name: "release:pull",
+            description: "Pull release contents to local files in multidoc format",
+            usage: "xano release:pull <directory> --release <name> [options]",
+            args: [
+                { name: "directory", required: true, description: "Local directory to pull release contents into" }
+            ],
+            flags: [
+                { name: "release", short: "r", type: "string", required: true, description: "Name of the release to pull" },
+                { name: "env", type: "boolean", required: false, description: "Include environment variables" },
+                { name: "records", type: "boolean", required: false, description: "Include table records" },
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID (uses profile workspace if not provided)" }
+            ],
+            examples: [
+                "xano release:pull ./release-v1 -r v1.0.0",
+                "xano release:pull ./release-v1 --release v1.0.0 --env --records"
+            ]
+        },
+        {
+            name: "release:push",
+            description: "Push local files as a new release",
+            usage: "xano release:push <directory> --name <name> [options]",
+            args: [
+                { name: "directory", required: true, description: "Local directory containing files to push as a release" }
+            ],
+            flags: [
+                { name: "name", short: "n", type: "string", required: true, description: "Name for the new release" },
+                { name: "branch", short: "b", type: "string", required: false, description: "Branch to associate the release with" },
+                { name: "hotfix", type: "boolean", required: false, description: "Mark this release as a hotfix" },
+                { name: "description", short: "d", type: "string", required: false, description: "Description for the release" },
+                { name: "records", type: "boolean", required: false, description: "Include records (--no-records to exclude)" },
+                { name: "env", type: "boolean", required: false, description: "Include environment variables (--no-env to exclude)" },
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID (uses profile workspace if not provided)" }
+            ],
+            examples: [
+                "xano release:push ./release-v1 -n v1.0.0",
+                "xano release:push ./release-v1 --name v1.1.0 -b dev --records --env",
+                "xano release:push ./release-v1 -n hotfix-1 --hotfix --no-records"
+            ]
+        }
+    ],
+    workflows: [
+        {
+            name: "Create and Deploy Release",
+            description: "Create a release from a branch and deploy it to a tenant",
+            steps: [
+                "List branches to find the source: `xano branch:list`",
+                "Create a release: `xano release:create -n v1.0.0 -b dev`",
+                "Verify the release: `xano release:get v1.0.0`",
+                "Deploy to tenant: `xano tenant:deploy_release my-tenant -r v1.0.0`"
+            ],
+            example: `xano branch:list
+xano release:create -n v1.0.0 -b dev -d "Initial release"
+xano release:get v1.0.0
+xano tenant:deploy_release my-tenant -r v1.0.0`
+        },
+        {
+            name: "Export and Import Release",
+            description: "Export a release from one workspace and import it into another",
+            steps: [
+                "Export the release: `xano release:export v1.0.0 --output ./v1.0.0.tar.gz`",
+                "Transfer the file to the target environment",
+                "Import into another workspace: `xano release:import --file ./v1.0.0.tar.gz -w 456`",
+                "Verify: `xano release:list -w 456`"
+            ],
+            example: `# Export from source workspace
+xano release:export v1.0.0 --output ./v1.0.0.tar.gz
+
+# Import into target workspace
+xano release:import --file ./v1.0.0.tar.gz -w 456
+xano release:list -w 456`
+        }
+    ]
+};