@xano/cli 1.0.4 → 1.0.6-beta.0

package/dist/commands/tenant/snapshot/create/index.js

@@ -0,0 +1,78 @@
+import { Args, Flags } from '@oclif/core';
+import BaseCommand from '../../../../base-command.js';
+export default class TenantSnapshotCreate extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Tenant name to snapshot',
+            required: true,
+        }),
+    };
+    static description = "Create a database snapshot for a tenant (an instant clone of the tenant's database)";
+    static examples = [
+        `$ xano tenant snapshot create t1234-abcd-xyz1 --label before-v2
+Created snapshot t1234-abcd-xyz1_bk_20260603_203614 for tenant t1234-abcd-xyz1
+`,
+        `$ xano tenant snapshot create t1234-abcd-xyz1 -l before-v2 -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        label: Flags.string({
+            char: 'l',
+            default: '',
+            description: 'Optional label appended to the snapshot description (alphanumeric)',
+            required: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        workspace: Flags.string({
+            char: 'w',
+            description: 'Workspace ID (uses profile workspace if not provided)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TenantSnapshotCreate);
+        const { profile } = this.resolveProfile(flags);
+        const workspaceId = flags.workspace || profile.workspace;
+        if (!workspaceId) {
+            this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
+        }
+        const tenantName = args.tenant_name;
+        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant/${tenantName}/snapshot`;
+        try {
+            const response = await this.verboseFetch(apiUrl, {
+                body: JSON.stringify({ label: flags.label }),
+                headers: {
+                    'accept': 'application/json',
+                    'Authorization': `Bearer ${profile.access_token}`,
+                    'Content-Type': 'application/json',
+                },
+                method: 'POST',
+            }, flags.verbose, profile.access_token);
+            if (!response.ok) {
+                const errorText = await response.text();
+                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+            }
+            const result = (await response.json());
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                this.log(`Created snapshot ${result.backup} for tenant ${tenantName}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to create snapshot: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to create snapshot: ${String(error)}`);
+            }
+        }
+    }
+}

package/dist/commands/tenant/snapshot/delete/index.d.ts

@@ -0,0 +1,19 @@
+import BaseCommand from '../../../../base-command.js';
+export default class TenantSnapshotDelete extends BaseCommand {
+    static args: {
+        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        snapshot: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private confirm;
+}

package/dist/commands/tenant/snapshot/delete/index.js

@@ -0,0 +1,102 @@
+import { Args, Flags } from '@oclif/core';
+import * as readline from 'node:readline';
+import BaseCommand from '../../../../base-command.js';
+export default class TenantSnapshotDelete extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Tenant name that owns the snapshot',
+            required: true,
+        }),
+    };
+    static description = '[CRITICAL] NEVER delete a snapshot without explicit user confirmation; this permanently drops the snapshot database. The live and original databases cannot be deleted.';
+    static examples = [
+        `$ xano tenant snapshot delete t1234-abcd-xyz1 --snapshot t1234-abcd-xyz1_bk_20260603_203614
+Are you sure you want to delete snapshot "t1234-abcd-xyz1_bk_20260603_203614"? This action cannot be undone. (y/N) y
+Deleted snapshot t1234-abcd-xyz1_bk_20260603_203614
+`,
+        `$ xano tenant snapshot delete t1234-abcd-xyz1 --snapshot t1234-abcd-xyz1_bk_20260603_203614 --force`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        force: Flags.boolean({
+            char: 'f',
+            default: false,
+            description: '[CRITICAL] Skips the confirmation prompt.',
+            required: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        snapshot: Flags.string({
+            description: 'Snapshot database name to delete',
+            required: true,
+        }),
+        workspace: Flags.string({
+            char: 'w',
+            description: 'Workspace ID (uses profile workspace if not provided)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TenantSnapshotDelete);
+        const { profile } = this.resolveProfile(flags);
+        const workspaceId = flags.workspace || profile.workspace;
+        if (!workspaceId) {
+            this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
+        }
+        const tenantName = args.tenant_name;
+        const { snapshot } = flags;
+        if (!flags.force) {
+            const confirmed = await this.confirm(`Are you sure you want to delete snapshot "${snapshot}"? This action cannot be undone.`);
+            if (!confirmed) {
+                this.log('Deletion cancelled.');
+                return;
+            }
+        }
+        const queryParams = new URLSearchParams({ snapshot });
+        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant/${tenantName}/snapshot?${queryParams.toString()}`;
+        try {
+            const response = await this.verboseFetch(apiUrl, {
+                headers: {
+                    accept: 'application/json',
+                    Authorization: `Bearer ${profile.access_token}`,
+                },
+                method: 'DELETE',
+            }, flags.verbose, profile.access_token);
+            if (!response.ok) {
+                const errorText = await response.text();
+                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+            }
+            if (flags.output === 'json') {
+                this.log(JSON.stringify({ deleted: true, snapshot, tenant_name: tenantName }, null, 2));
+            }
+            else {
+                this.log(`Deleted snapshot ${snapshot}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to delete snapshot: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to delete snapshot: ${String(error)}`);
+            }
+        }
+    }
+    async confirm(message) {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        return new Promise((resolve) => {
+            rl.question(`${message} (y/N) `, (answer) => {
+                rl.close();
+                resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+            });
+        });
+    }
+}

package/dist/commands/tenant/snapshot/list/index.d.ts

@@ -0,0 +1,16 @@
+import BaseCommand from '../../../../base-command.js';
+export default class TenantSnapshotList extends BaseCommand {
+    static args: {
+        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/tenant/snapshot/list/index.js

@@ -0,0 +1,96 @@
+import { Args, Flags } from '@oclif/core';
+import BaseCommand from '../../../../base-command.js';
+export default class TenantSnapshotList extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Tenant name to list snapshots for',
+            required: true,
+        }),
+    };
+    static description = 'List database snapshots for a tenant';
+    static examples = [
+        `$ xano tenant snapshot list t1234-abcd-xyz1
+Snapshots for tenant t1234-abcd-xyz1:
+  - t1234-abcd-xyz1 (25 MB) [ORIGINAL]
+  - t1234-abcd-xyz1_bk_20260603_203614 (25 MB, 2026-06-03 20:36:14) [LIVE]
+`,
+        `$ xano tenant snapshot list t1234-abcd-xyz1 -o json`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        workspace: Flags.string({
+            char: 'w',
+            description: 'Workspace ID (uses profile workspace if not provided)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TenantSnapshotList);
+        const { profile } = this.resolveProfile(flags);
+        const workspaceId = flags.workspace || profile.workspace;
+        if (!workspaceId) {
+            this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
+        }
+        const tenantName = args.tenant_name;
+        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant/${tenantName}/snapshot`;
+        try {
+            const response = await this.verboseFetch(apiUrl, {
+                headers: {
+                    'accept': 'application/json',
+                    'Authorization': `Bearer ${profile.access_token}`,
+                },
+                method: 'GET',
+            }, flags.verbose, profile.access_token);
+            if (!response.ok) {
+                const errorText = await response.text();
+                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+            }
+            const data = (await response.json());
+            let snapshots;
+            if (Array.isArray(data)) {
+                snapshots = data;
+            }
+            else if (data && typeof data === 'object' && 'items' in data && Array.isArray(data.items)) {
+                snapshots = data.items;
+            }
+            else {
+                this.error('Unexpected API response format');
+            }
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(snapshots, null, 2));
+            }
+            else if (snapshots.length === 0) {
+                this.log(`No snapshots found for tenant ${tenantName}`);
+            }
+            else {
+                this.log(`Snapshots for tenant ${tenantName}:`);
+                for (const snapshot of snapshots) {
+                    const size = snapshot.size_pretty || (snapshot.size_bytes ? `${snapshot.size_bytes} bytes` : 'unknown');
+                    const meta = snapshot.created ? `${size}, ${snapshot.created}` : size;
+                    const tags = [];
+                    if (snapshot.is_original)
+                        tags.push('ORIGINAL');
+                    if (snapshot.is_live)
+                        tags.push('LIVE');
+                    const tagStr = tags.length > 0 ? ` [${tags.join(', ')}]` : '';
+                    this.log(`  - ${snapshot.name} (${meta})${tagStr}`);
+                }
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to list snapshots: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to list snapshots: ${String(error)}`);
+            }
+        }
+    }
+}

package/dist/commands/tenant/snapshot/swap/index.d.ts

@@ -0,0 +1,19 @@
+import BaseCommand from '../../../../base-command.js';
+export default class TenantSnapshotSwap extends BaseCommand {
+    static args: {
+        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        snapshot: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+    private confirm;
+}

package/dist/commands/tenant/snapshot/swap/index.js

@@ -0,0 +1,103 @@
+import { Args, Flags } from '@oclif/core';
+import * as readline from 'node:readline';
+import BaseCommand from '../../../../base-command.js';
+export default class TenantSnapshotSwap extends BaseCommand {
+    static args = {
+        tenant_name: Args.string({
+            description: 'Tenant name to swap',
+            required: true,
+        }),
+    };
+    static description = "Swap a tenant's live database to a snapshot. This repoints the tenant; the current live database is left untouched, so you can swap back. To roll back, swap to the original database name.";
+    static examples = [
+        `$ xano tenant snapshot swap t1234-abcd-xyz1 --snapshot t1234-abcd-xyz1_bk_20260603_203614
+Swapped tenant t1234-abcd-xyz1 from t1234-abcd-xyz1 to t1234-abcd-xyz1_bk_20260603_203614
+`,
+        `$ xano tenant snapshot swap t1234-abcd-xyz1 --snapshot t1234-abcd-xyz1 --force`,
+    ];
+    static flags = {
+        ...BaseCommand.baseFlags,
+        force: Flags.boolean({
+            char: 'f',
+            default: false,
+            description: 'Skips the confirmation prompt.',
+            required: false,
+        }),
+        output: Flags.string({
+            char: 'o',
+            default: 'summary',
+            description: 'Output format',
+            options: ['summary', 'json'],
+            required: false,
+        }),
+        snapshot: Flags.string({
+            description: 'Snapshot database name to swap to (use the original tenant name to roll back)',
+            required: true,
+        }),
+        workspace: Flags.string({
+            char: 'w',
+            description: 'Workspace ID (uses profile workspace if not provided)',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(TenantSnapshotSwap);
+        const { profile } = this.resolveProfile(flags);
+        const workspaceId = flags.workspace || profile.workspace;
+        if (!workspaceId) {
+            this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
+        }
+        const tenantName = args.tenant_name;
+        const { snapshot } = flags;
+        if (!flags.force) {
+            const confirmed = await this.confirm(`Swap tenant ${tenantName} to "${snapshot}"? This repoints the tenant's live database.`);
+            if (!confirmed) {
+                this.log('Swap cancelled.');
+                return;
+            }
+        }
+        const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant/${tenantName}/snapshot/swap`;
+        try {
+            const response = await this.verboseFetch(apiUrl, {
+                body: JSON.stringify({ snapshot }),
+                headers: {
+                    'accept': 'application/json',
+                    'Authorization': `Bearer ${profile.access_token}`,
+                    'Content-Type': 'application/json',
+                },
+                method: 'POST',
+            }, flags.verbose, profile.access_token);
+            if (!response.ok) {
+                const errorText = await response.text();
+                this.error(`API request failed with status ${response.status}: ${response.statusText}\n${errorText}`);
+            }
+            const result = (await response.json());
+            if (flags.output === 'json') {
+                this.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                this.log(`Swapped tenant ${tenantName} from ${result.from ?? 'unknown'} to ${result.to ?? snapshot}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.error(`Failed to swap snapshot: ${error.message}`);
+            }
+            else {
+                this.error(`Failed to swap snapshot: ${String(error)}`);
+            }
+        }
+    }
+    async confirm(message) {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        return new Promise((resolve) => {
+            rl.question(`${message} (y/N) `, (answer) => {
+                rl.close();
+                resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+            });
+        });
+    }
+}

package/dist/commands/tenant/unit_test/run/index.d.ts

@@ -6,6 +6,7 @@ export default class TenantUnitTestRun extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         tenant: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/tenant/unit_test/run/index.js

@@ -17,6 +17,11 @@ Result: PASS
     ];
     static flags = {
         ...BaseCommand.baseFlags,
+        branch: Flags.string({
+            char: 'b',
+            description: 'Branch the unit test belongs to (uses profile branch if not provided, then the live branch)',
+            required: false,
+        }),
         output: Flags.string({
             char: 'o',
             default: 'summary',
@@ -43,12 +48,14 @@ Result: PASS
             this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
         }
         const tenantName = encodeURIComponent(flags.tenant);
+        const branch = flags.branch ?? profile.branch;
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant/${tenantName}/unit_test/${encodeURIComponent(args.unit_test_id)}/run`;
         try {
             if (flags.output === 'summary') {
                 this.log(`Running unit test ${args.unit_test_id}...`);
             }
             const response = await this.verboseFetch(apiUrl, {
+                body: JSON.stringify(branch ? { branch } : {}),
                 headers: {
                     accept: 'application/json',
                     Authorization: `Bearer ${profile.access_token}`,

package/dist/commands/tenant/unit_test/run_all/index.js

@@ -18,7 +18,7 @@ Results: 4 passed, 1 failed
         ...BaseCommand.baseFlags,
         branch: Flags.string({
             char: 'b',
-            description: 'Filter by branch name',
+            description: 'Branch to run tests from (uses profile branch if not provided, then the live branch)',
             required: false,
         }),
         'obj-type': Flags.string({
@@ -53,11 +53,14 @@ Results: 4 passed, 1 failed
         }
         const tenantName = encodeURIComponent(flags.tenant);
         const baseUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/tenant/${tenantName}/unit_test`;
+        // Resolve the branch once so the listed tests and the tests we run come
+        // from the same branch.
+        const branch = flags.branch ?? profile.branch;
         try {
             const listParams = new URLSearchParams();
             listParams.set('per_page', '10000');
-            if (flags.branch)
-                listParams.set('branch', flags.branch);
+            if (branch)
+                listParams.set('branch', branch);
             if (flags['obj-type'])
                 listParams.set('obj_type', flags['obj-type']);
             const listResponse = await this.verboseFetch(`${baseUrl}?${listParams}`, {
@@ -94,6 +97,7 @@ Results: 4 passed, 1 failed
                 const runUrl = `${baseUrl}/${test.id}/run`;
                 try {
                     const runResponse = await this.verboseFetch(runUrl, {
+                        body: JSON.stringify(branch ? { branch } : {}),
                         headers: {
                             accept: 'application/json',
                             Authorization: `Bearer ${profile.access_token}`,

package/dist/commands/unit_test/run/index.d.ts

@@ -6,6 +6,7 @@ export default class UnitTestRun extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/unit_test/run/index.js

@@ -14,9 +14,15 @@ Running unit test abc-123...
 Result: PASS
 `,
         `$ xano unit-test run abc-123 -o json`,
+        `$ xano unit-test run abc-123 --branch dev`,
     ];
     static flags = {
         ...BaseCommand.baseFlags,
+        branch: Flags.string({
+            char: 'b',
+            description: 'Branch the unit test belongs to (uses profile branch if not provided, then the live branch)',
+            required: false,
+        }),
         output: Flags.string({
             char: 'o',
             default: 'summary',
@@ -37,12 +43,14 @@ Result: PASS
         if (!workspaceId) {
             this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
         }
+        const branch = flags.branch ?? profile.branch;
         const apiUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/unit_test/${args.unit_test_id}/run`;
         try {
             if (flags.output === 'summary') {
                 this.log(`Running unit test ${args.unit_test_id}...`);
             }
             const response = await this.verboseFetch(apiUrl, {
+                body: JSON.stringify(branch ? { branch } : {}),
                 headers: {
                     'accept': 'application/json',
                     'Authorization': `Bearer ${profile.access_token}`,

package/dist/commands/unit_test/run_all/index.js

@@ -19,7 +19,7 @@ Results: 2 passed, 1 failed
         ...BaseCommand.baseFlags,
         branch: Flags.string({
             char: 'b',
-            description: 'Filter by branch name',
+            description: 'Branch to run tests from (uses profile branch if not provided, then the live branch)',
             required: false,
         }),
         'obj-type': Flags.string({
@@ -48,12 +48,15 @@ Results: 2 passed, 1 failed
             this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
         }
         const baseUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/unit_test`;
+        // Resolve the branch once so the listed tests and the tests we run come
+        // from the same branch.
+        const branch = flags.branch ?? profile.branch;
         try {
             // Step 1: List all unit tests
             const listParams = new URLSearchParams();
             listParams.set('per_page', '10000');
-            if (flags.branch) {
-                listParams.set('branch', flags.branch);
+            if (branch) {
+                listParams.set('branch', branch);
             }
             if (flags['obj-type']) {
                 listParams.set('obj_type', flags['obj-type']);
@@ -93,6 +96,7 @@ Results: 2 passed, 1 failed
                 const runUrl = `${baseUrl}/${test.id}/run`;
                 try {
                     const runResponse = await this.verboseFetch(runUrl, {
+                        body: JSON.stringify(branch ? { branch } : {}),
                         headers: {
                             accept: 'application/json',
                             Authorization: `Bearer ${profile.access_token}`,

package/dist/commands/workspace/pull/index.js

@@ -4,11 +4,12 @@ import * as path from 'node:path';
 import snakeCase from 'lodash.snakecase';
 import BaseCommand from '../../../base-command.js';
 import { buildApiGroupFolderResolver, parseDocument } from '../../../utils/document-parser.js';
+import { fetchKnowledge, writeKnowledge } from '../../../utils/knowledge-sync.js';
 export default class Pull extends BaseCommand {
     static description = 'Pull a workspace multidoc from the Xano Metadata API and split into individual files';
     static examples = [
         `$ xano workspace pull
-Pulled 42 documents to current directory
+Pulled 42 documents + 5 knowledge files to current directory
 `,
         `$ xano workspace pull -d ./my-workspace
 Pulled 42 documents to ./my-workspace
@@ -239,7 +240,17 @@ Pulled 58 documents
             fs.writeFileSync(filePath, doc.content, 'utf8');
             writtenCount++;
         }
-        this.log(`Pulled ${writtenCount} documents to ${flags.directory}`);
+        // ── Pull knowledge ────────────────────────────────────────────────────
+        const knowledgeUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/knowledge/sync`;
+        const knowledgeObjects = await fetchKnowledge(knowledgeUrl, branch, profile.access_token, this.verboseFetch.bind(this), flags.verbose);
+        let knowledgeCount = 0;
+        if (knowledgeObjects.length > 0) {
+            knowledgeCount = writeKnowledge(knowledgeObjects, outputDir);
+        }
+        const parts = [`${writtenCount} documents`];
+        if (knowledgeCount > 0)
+            parts.push(`${knowledgeCount} knowledge file${knowledgeCount === 1 ? '' : 's'}`);
+        this.log(`Pulled ${parts.join(' + ')} to ${flags.directory}`);
     }
     /**
      * Sanitize a document name for use as a filename.

package/dist/commands/workspace/push/index.d.ts

@@ -4,8 +4,8 @@ export default class Push extends BaseCommand {
     static examples: string[];
     static flags: {
         branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        directory: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         delete: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        directory: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         env: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         exclude: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;