@xano/cli 0.0.95-beta.23 → 0.0.95-beta.25

package/README.md

@@ -25,7 +25,7 @@ npm install -g @xano/cli
 
 3. Pull a workspace to local files:
    ```bash
-   xano workspace pull ./my-workspace
+   xano workspace pull
    ```
 
 ## Commands
@@ -108,37 +108,40 @@ xano workspace edit <workspace_id> --require-token       # Require token for doc
 xano workspace delete <workspace_id>
 xano workspace delete <workspace_id> --force
 
-# Pull workspace to local files
-xano workspace pull ./my-workspace
-xano workspace pull ./my-workspace -b dev              # Specific branch
-xano workspace pull ./my-workspace --env --records      # Include env vars and table records
-xano workspace pull ./my-workspace --draft              # Include draft changes
-
-# Push local files to workspace (only changed files by default)
-xano workspace push ./my-workspace
-xano workspace push ./my-workspace -b dev
-xano workspace push ./my-workspace --sync                # Full push — send all files, not just changed ones
-xano workspace push ./my-workspace --sync --delete       # Full push + delete remote objects not included
-xano workspace push ./my-workspace --dry-run             # Preview changes without pushing
-xano workspace push ./my-workspace --records             # Include table records
-xano workspace push ./my-workspace --env                 # Include environment variables
-xano workspace push ./my-workspace --truncate            # Truncate tables before import
-xano workspace push ./my-workspace --no-transaction      # Disable database transaction wrapping
-xano workspace push ./my-workspace --no-guids            # Skip writing GUIDs back to local files
-xano workspace push ./my-workspace --force               # Skip preview and confirmation (for CI/CD)
-xano workspace push ./my-workspace -i "function/*"       # Push only matching files
-xano workspace push ./my-workspace -e "table/*"          # Push all files except tables
-xano workspace push ./my-workspace -i "function/*" -e "**/test*"  # Include functions, exclude tests
-
-# Pull from a git repository to local files
-xano workspace git pull ./output -r https://github.com/owner/repo
-xano workspace git pull ./output -r https://github.com/owner/repo -b main
-xano workspace git pull ./output -r https://github.com/owner/repo/tree/main/path/to/dir
-xano workspace git pull ./output -r https://github.com/owner/repo/blob/main/file.xs
-xano workspace git pull ./output -r git@github.com:owner/repo.git
-xano workspace git pull ./output -r https://gitlab.com/owner/repo/-/tree/master/path
-xano workspace git pull ./output -r https://github.com/owner/private-repo -t ghp_xxx
-xano workspace git pull ./output -r https://github.com/owner/repo --path subdir
+# Pull workspace to local files (defaults to current directory)
+xano workspace pull
+xano workspace pull -d ./my-workspace                    # Specify output directory
+xano workspace pull -b dev                               # Specific branch
+xano workspace pull --env --records                      # Include env vars and table records
+xano workspace pull --draft                              # Include draft changes
+
+# Push local files to workspace (defaults to current directory, only changed files)
+xano workspace push
+xano workspace push -d ./my-workspace                    # Push from a specific directory
+xano workspace push -b dev
+xano workspace push --sync                               # Full push — send all files, not just changed ones
+xano workspace push --sync --delete                      # Full push + delete remote objects not included
+xano workspace push --dry-run                            # Preview changes without pushing
+xano workspace push --records                            # Include table records
+xano workspace push --env                                # Include environment variables
+xano workspace push --truncate                           # Truncate tables before import
+xano workspace push --no-transaction                     # Disable database transaction wrapping
+xano workspace push --no-guids                           # Skip writing GUIDs back to local files
+xano workspace push --force                              # Skip preview and confirmation (for CI/CD)
+xano workspace push -i "function/*"                      # Push only matching files
+xano workspace push -e "table/*"                         # Push all files except tables
+xano workspace push -i "function/*" -e "**/test*"        # Include functions, exclude tests
+
+# Pull from a git repository to local files (defaults to current directory)
+xano workspace git pull -r https://github.com/owner/repo
+xano workspace git pull -d ./output -r https://github.com/owner/repo
+xano workspace git pull -r https://github.com/owner/repo -b main
+xano workspace git pull -r https://github.com/owner/repo/tree/main/path/to/dir
+xano workspace git pull -r https://github.com/owner/repo/blob/main/file.xs
+xano workspace git pull -r git@github.com:owner/repo.git
+xano workspace git pull -r https://gitlab.com/owner/repo/-/tree/master/path
+xano workspace git pull -r https://github.com/owner/private-repo -t ghp_xxx
+xano workspace git pull -r https://github.com/owner/repo --path subdir
 ```
 
 ### Branches
@@ -229,14 +232,16 @@ xano release import --file ./my-release.tar.gz
 xano release delete <release_name>
 xano release delete <release_name> --force
 
-# Pull release to local files
-xano release pull ./my-release -r v1.0
-xano release pull ./my-release -r v1.0 --env --records
+# Pull release to local files (defaults to current directory)
+xano release pull -r v1.0
+xano release pull -d ./my-release -r v1.0
+xano release pull -r v1.0 --env --records
 
-# Push local files as a new release
-xano release push ./my-release -n "v2.0"
-xano release push ./my-release -n "v2.0" --hotfix -d "Critical fix"
-xano release push ./my-release -n "v2.0" --no-records --no-env
+# Push local files as a new release (defaults to current directory)
+xano release push -n "v2.0"
+xano release push -d ./my-release -n "v2.0"
+xano release push -n "v2.0" --hotfix --description "Critical fix"
+xano release push -n "v2.0" --no-records --no-env
 
 # Deploy a release to its workspace as a new branch
 xano release deploy "v1.0"
@@ -336,17 +341,19 @@ xano tenant impersonate <tenant_name> -o json
 #### Pull / Push
 
 ```bash
-# Pull tenant to local files
-xano tenant pull ./my-tenant -t <tenant_name>
-xano tenant pull ./my-tenant -t <tenant_name> --env --records
-xano tenant pull ./my-tenant -t <tenant_name> --draft
-
-# Push local files to tenant
-xano tenant push ./my-tenant -t <tenant_name>
-xano tenant push ./my-tenant -t <tenant_name> --records        # Include table records
-xano tenant push ./my-tenant -t <tenant_name> --env            # Include environment variables
-xano tenant push ./my-tenant -t <tenant_name> --truncate
-xano tenant push ./my-tenant -t <tenant_name> --no-transaction # Disable transaction wrapping
+# Pull tenant to local files (defaults to current directory)
+xano tenant pull -t <tenant_name>
+xano tenant pull -d ./my-tenant -t <tenant_name>
+xano tenant pull -t <tenant_name> --env --records
+xano tenant pull -t <tenant_name> --draft
+
+# Push local files to tenant (defaults to current directory)
+xano tenant push -t <tenant_name>
+xano tenant push -d ./my-tenant -t <tenant_name>
+xano tenant push -t <tenant_name> --records                    # Include table records
+xano tenant push -t <tenant_name> --env                        # Include environment variables
+xano tenant push -t <tenant_name> --truncate
+xano tenant push -t <tenant_name> --no-transaction             # Disable transaction wrapping
 ```
 
 #### Deployments
@@ -457,9 +464,27 @@ Manage your sandbox tenant. Each user has a single sandbox tenant that is auto-p
 xano sandbox get
 xano sandbox get -o json
 
-# Push/pull workspace data
-xano sandbox push ./my-workspace
-xano sandbox pull ./my-tenant
+# Pull sandbox to local files (defaults to current directory)
+xano sandbox pull
+xano sandbox pull -d ./my-sandbox
+xano sandbox pull --env --records
+
+# Push local files to sandbox (defaults to current directory, only changed files)
+xano sandbox push
+xano sandbox push -d ./my-workspace                      # Push from a specific directory
+xano sandbox push --sync                                 # Full push — send all files
+xano sandbox push --sync --delete                        # Full push + delete remote objects not included
+xano sandbox push --dry-run                              # Preview changes without pushing
+xano sandbox push --records --env                        # Include records and environment variables
+xano sandbox push --truncate                             # Truncate tables before import
+xano sandbox push --no-guids                             # Skip writing GUIDs back to local files
+xano sandbox push --force                                # Skip preview and confirmation
+xano sandbox push -i "function/*"                        # Push only matching files
+xano sandbox push -e "table/*"                           # Push all files except tables
+xano sandbox push --review                               # Push and open sandbox review in the browser
+
+# Review (open in browser)
+xano sandbox review
 
 # Impersonate (open in browser)
 xano sandbox impersonate

package/dist/commands/release/pull/index.d.ts

@@ -1,11 +1,9 @@
 import BaseCommand from '../../../base-command.js';
 export default class ReleasePull extends BaseCommand {
-    static args: {
-        directory: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
     static description: string;
     static examples: string[];
     static flags: {
+        directory: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         env: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         records: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         release: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

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

@@ -1,4 +1,4 @@
-import { Args, Flags } from '@oclif/core';
+import { Flags } from '@oclif/core';
 import * as yaml from 'js-yaml';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
@@ -6,26 +6,29 @@ import snakeCase from 'lodash.snakecase';
 import BaseCommand from '../../../base-command.js';
 import { buildApiGroupFolderResolver, parseDocument } from '../../../utils/document-parser.js';
 export default class ReleasePull extends BaseCommand {
-    static args = {
-        directory: Args.string({
-            description: 'Output directory for pulled documents',
-            required: true,
-        }),
-    };
     static description = 'Pull a release multidoc from the Xano Metadata API and split into individual files';
     static examples = [
-        `$ xano release pull ./my-release -r v1.0
+        `$ xano release pull -r v1.0
+Pulled 42 documents from release 'v1.0' to current directory
+`,
+        `$ xano release pull -d ./my-release -r v1.0
 Pulled 42 documents from release 'v1.0' to ./my-release
 `,
-        `$ xano release pull ./output -r v1.0 -w 40
+        `$ xano release pull -d ./output -r v1.0 -w 40
 Pulled 15 documents from release 'v1.0' to ./output
 `,
-        `$ xano release pull ./backup -r v1.0 --profile production --env --records
-Pulled 58 documents from release 'v1.0' to ./backup
+        `$ xano release pull -r v1.0 --profile production --env --records
+Pulled 58 documents from release 'v1.0'
 `,
     ];
     static flags = {
         ...BaseCommand.baseFlags,
+        directory: Flags.string({
+            char: 'd',
+            default: '.',
+            description: 'Output directory for pulled documents (defaults to current directory)',
+            required: false,
+        }),
         env: Flags.boolean({
             default: false,
             description: 'Include environment variables',
@@ -48,7 +51,7 @@ Pulled 58 documents from release 'v1.0' to ./backup
         }),
     };
     async run() {
-        const { args, flags } = await this.parse(ReleasePull);
+        const { flags } = await this.parse(ReleasePull);
         // Get profile name (default or from flag/env)
         const profileName = flags.profile || this.getDefaultProfile();
         // Load credentials
@@ -76,7 +79,7 @@ Pulled 58 documents from release 'v1.0' to ./backup
         }
         else {
             this.error(`Workspace ID is required. Either:\n` +
-                `  1. Provide it as a flag: xano release pull <directory> -r <release_name> -w <workspace_id>\n` +
+                `  1. Provide it as a flag: xano release pull -r <release_name> -w <workspace_id>\n` +
                 `  2. Set it in your profile using: xano profile:edit ${profileName} -w <workspace_id>`);
         }
         const releaseName = flags.release;
@@ -132,7 +135,7 @@ Pulled 58 documents from release 'v1.0' to ./backup
             return;
         }
         // Resolve the output directory
-        const outputDir = path.resolve(args.directory);
+        const outputDir = path.resolve(flags.directory);
         // Create the output directory if it doesn't exist
         fs.mkdirSync(outputDir, { recursive: true });
         // Resolve api_group names to unique folder names, disambiguating collisions
@@ -238,7 +241,7 @@ Pulled 58 documents from release 'v1.0' to ./backup
             fs.writeFileSync(filePath, doc.content, 'utf8');
             writtenCount++;
         }
-        this.log(`Pulled ${writtenCount} documents from release '${releaseName}' to ${args.directory}`);
+        this.log(`Pulled ${writtenCount} documents from release '${releaseName}' to ${flags.directory}`);
     }
     loadCredentials() {
         const credentialsPath = this.getCredentialsPath();

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

@@ -1,12 +1,10 @@
 import BaseCommand from '../../../base-command.js';
 export default class ReleasePush extends BaseCommand {
-    static args: {
-        directory: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
     static description: string;
     static examples: string[];
     static flags: {
         description: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        directory: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         env: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         hotfix: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         name: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/release/push/index.js

@@ -1,42 +1,41 @@
-import { Args, Flags } from '@oclif/core';
+import { Flags } from '@oclif/core';
 import * as yaml from 'js-yaml';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import BaseCommand from '../../../base-command.js';
 import { findFilesWithGuid } from '../../../utils/document-parser.js';
 export default class ReleasePush extends BaseCommand {
-    static args = {
-        directory: Args.string({
-            description: 'Directory containing .xs documents to create the release from',
-            required: true,
-        }),
-    };
     static description = 'Create a new release from local XanoScript files via the multidoc endpoint';
     static examples = [
-        `$ xano release push ./my-release -n "v1.0"
-Created release: v1.0 - ID: 10
+        `$ xano release push -n "v1.0"
+Created release: v1.0 - ID: 10 (from current directory)
 `,
-        `$ xano release push ./output -n "v2.0" -w 40 -d "Major update"
+        `$ xano release push -d ./output -n "v2.0" -w 40 --description "Major update"
 Created release: v2.0 - ID: 15
 `,
-        `$ xano release push ./backup -n "v1.1-hotfix" --hotfix --profile production
+        `$ xano release push -d ./backup -n "v1.1-hotfix" --hotfix --profile production
 Created release: v1.1-hotfix - ID: 20
 `,
-        `$ xano release push ./my-release -n "v1.0" --no-records --no-env
+        `$ xano release push -n "v1.0" --no-records --no-env
 Create release from schema only, skip records and environment variables
 `,
-        `$ xano release push ./my-release -n "v1.0" -o json
+        `$ xano release push -n "v1.0" -o json
 Output release details as JSON
 `,
     ];
     static flags = {
         ...BaseCommand.baseFlags,
         description: Flags.string({
-            char: 'd',
             default: '',
             description: 'Release description',
             required: false,
         }),
+        directory: Flags.string({
+            char: 'd',
+            default: '.',
+            description: 'Directory containing .xs documents to create the release from (defaults to current directory)',
+            required: false,
+        }),
         env: Flags.boolean({
             allowNo: true,
             default: true,
@@ -73,7 +72,7 @@ Output release details as JSON
         }),
     };
     async run() {
-        const { args, flags } = await this.parse(ReleasePush);
+        const { flags } = await this.parse(ReleasePush);
         // Get profile name (default or from flag/env)
         const profileName = flags.profile || this.getDefaultProfile();
         // Load credentials
@@ -101,11 +100,11 @@ Output release details as JSON
         }
         else {
             this.error(`Workspace ID is required. Either:\n` +
-                `  1. Provide it as a flag: xano release push <directory> -n <name> -w <workspace_id>\n` +
+                `  1. Provide it as a flag: xano release push -n <name> -w <workspace_id>\n` +
                 `  2. Set it in your profile using: xano profile:edit ${profileName} -w <workspace_id>`);
         }
         // Resolve the input directory
-        const inputDir = path.resolve(args.directory);
+        const inputDir = path.resolve(flags.directory);
         if (!fs.existsSync(inputDir)) {
             this.error(`Directory not found: ${inputDir}`);
         }
@@ -115,7 +114,7 @@ Output release details as JSON
         // Collect all .xs files from the directory tree
         const files = this.collectFiles(inputDir);
         if (files.length === 0) {
-            this.error(`No .xs files found in ${args.directory}`);
+            this.error(`No .xs files found in ${flags.directory}`);
         }
         // Read each file and track file path alongside content
         const documentEntries = [];
@@ -126,7 +125,7 @@ Output release details as JSON
             }
         }
         if (documentEntries.length === 0) {
-            this.error(`All .xs files in ${args.directory} are empty`);
+            this.error(`All .xs files in ${flags.directory} are empty`);
         }
         const multidoc = documentEntries.map((d) => d.content).join('\n---\n');
         // Construct the API URL with query params

package/dist/commands/sandbox/pull/index.d.ts

@@ -1,11 +1,9 @@
 import BaseCommand from '../../../base-command.js';
 export default class SandboxPull extends BaseCommand {
-    static args: {
-        directory: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
     static description: string;
     static examples: string[];
     static flags: {
+        directory: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         draft: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         env: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         records: import("@oclif/core/interfaces").BooleanFlag<boolean>;

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

@@ -1,25 +1,28 @@
-import { Args, Flags } from '@oclif/core';
+import { Flags } from '@oclif/core';
 import snakeCase from 'lodash.snakecase';
 import BaseCommand from '../../../base-command.js';
 import { buildApiGroupFolderResolver, parseDocument } from '../../../utils/document-parser.js';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 export default class SandboxPull extends BaseCommand {
-    static args = {
-        directory: Args.string({
-            description: 'Output directory for pulled documents',
-            required: true,
-        }),
-    };
     static description = 'Pull documents from your sandbox environment and split into individual files';
     static examples = [
-        `$ xano sandbox pull ./my-sandbox
+        `$ xano sandbox pull
+Pulled 42 documents from sandbox environment to current directory
+`,
+        `$ xano sandbox pull -d ./my-sandbox
 Pulled 42 documents from sandbox environment to ./my-sandbox
 `,
-        `$ xano sandbox pull ./backup --env --records`,
+        `$ xano sandbox pull --env --records`,
     ];
     static flags = {
         ...BaseCommand.baseFlags,
+        directory: Flags.string({
+            char: 'd',
+            default: '.',
+            description: 'Output directory for pulled documents (defaults to current directory)',
+            required: false,
+        }),
         draft: Flags.boolean({
             default: false,
             description: 'Include draft versions',
@@ -37,7 +40,7 @@ Pulled 42 documents from sandbox environment to ./my-sandbox
         }),
     };
     async run() {
-        const { args, flags } = await this.parse(SandboxPull);
+        const { flags } = await this.parse(SandboxPull);
         const { profile } = this.resolveProfile(flags);
         const queryParams = new URLSearchParams({
             env: flags.env.toString(),
@@ -86,7 +89,7 @@ Pulled 42 documents from sandbox environment to ./my-sandbox
             this.log('No documents found in response');
             return;
         }
-        const outputDir = path.resolve(args.directory);
+        const outputDir = path.resolve(flags.directory);
         fs.mkdirSync(outputDir, { recursive: true });
         const getApiGroupFolder = buildApiGroupFolderResolver(documents, snakeCase);
         const filenameCounters = new Map();
@@ -174,7 +177,7 @@ Pulled 42 documents from sandbox environment to ./my-sandbox
             fs.writeFileSync(filePath, doc.content, 'utf8');
             writtenCount++;
         }
-        this.log(`Pulled ${writtenCount} documents from sandbox environment to ${args.directory}`);
+        this.log(`Pulled ${writtenCount} documents from sandbox environment to ${flags.directory}`);
     }
     sanitizeFilename(name) {
         return snakeCase(name.replaceAll('"', ''));

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

@@ -1,13 +1,19 @@
 import BaseCommand from '../../../base-command.js';
 export default class SandboxPush extends BaseCommand {
-    static args: {
-        directory: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
     static description: string;
     static examples: string[];
     static flags: {
+        directory: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        delete: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        '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>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        guids: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        include: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         records: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        review: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        sync: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         transaction: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         truncate: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -15,7 +21,6 @@ export default class SandboxPush extends BaseCommand {
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private collectFiles;
-    private renderBadIndexes;
-    private renderBadReferences;
+    private openReview;
+    private getFrontendUrl;
 }