@xano/cli 0.0.14 → 0.0.16

package/README.md

@@ -23,24 +23,27 @@ npm install -g @xano/cli
    xano workspace:list
    ```
 
-3. Run an ephemeral job:
+3. Execute XanoScript code:
    ```bash
-   xano ephemeral:run:job -f script.xs
+   xano run exec -f script.xs
    ```
 
 ## Commands
 
 ### Profile Management
 
-Profiles store your Xano credentials and default workspace settings.
+Profiles store your Xano credentials and default workspace/project settings.
 
 ```bash
-# Create a profile interactively
+# Create a profile interactively (auto-fetches run projects)
 xano profile:wizard
 
 # Create a profile manually
 xano profile:create myprofile -i https://instance.xano.com -t <access_token>
 
+# Create a profile with workspace and project
+xano profile:create myprofile -i https://instance.xano.com -t <access_token> -w my-workspace -j my-project
+
 # List profiles
 xano profile:list
 xano profile:list --details
@@ -49,12 +52,17 @@ xano profile:list --details
 xano profile:set-default myprofile
 
 # Edit a profile
-xano profile:edit myprofile -w 123  # Set default workspace
+xano profile:edit myprofile -w 123              # Set default workspace
+xano profile:edit myprofile -j my-project       # Set default project
+xano profile:edit myprofile --run-project <id>  # Set run project for xano run commands
+xano profile:edit myprofile --remove-run-project # Remove run project
 
 # Delete a profile
 xano profile:delete myprofile
 ```
 
+The `profile:wizard` command automatically fetches your run projects and sets the first one as the default for `xano run` commands.
+
 ### Workspaces
 
 ```bash
@@ -84,18 +92,99 @@ xano function:edit 145 -f new.xs # Update from file
 xano function:edit 145 --publish # Publish after editing
 ```
 
-### Ephemeral Jobs & Services
+### Xano Run
+
+Execute XanoScript code and manage projects, sessions, environment variables, and secrets.
+
+#### Executing Code
+
+```bash
+# Execute XanoScript (job or service)
+xano run exec -f script.xs
+xano run exec -f https://example.com/script.xs   # From URL
+xano run exec -f script.xs -a args.json          # With input arguments (file)
+xano run exec -f script.xs -a https://ex.com/args.json  # With input arguments (URL)
+xano run exec -f script.xs --edit                # Edit in $EDITOR first
+xano run exec -f script.xs --env API_KEY=secret  # With env overrides
+cat script.xs | xano run exec --stdin            # From stdin
+
+# Get document info (type, inputs, env vars)
+xano run info -f script.xs
+```
+
+#### Projects
+
+```bash
+# List projects
+xano run projects list
+
+# Create a project
+xano run projects create -n "My Project"
+xano run projects create -n "My Project" -d "Description"
+
+# Update a project
+xano run projects update <project-id> -n "New Name"
+xano run projects update <project-id> -d "New description"
+
+# Delete a project
+xano run projects delete <project-id>
+xano run projects delete <project-id> --force    # Skip confirmation
+```
+
+#### Sessions
+
+```bash
+# List sessions
+xano run sessions list
+
+# Get session details
+xano run sessions get <session-id>
+
+# Start/stop a session
+xano run sessions start <session-id>
+xano run sessions stop <session-id>
+
+# Delete a session
+xano run sessions delete <session-id>
+xano run sessions delete <session-id> --force    # Skip confirmation
+
+# Get sink data for a completed session
+xano run sink get <session-id>
+```
+
+#### Environment Variables
+
+```bash
+# List environment variable keys
+xano run env list
+
+# Set an environment variable
+xano run env set API_KEY my-secret-key
+
+# Get an environment variable value
+xano run env get API_KEY
+
+# Delete an environment variable
+xano run env delete API_KEY
+xano run env delete API_KEY --force              # Skip confirmation
+```
 
-Run XanoScript code without creating permanent resources.
+#### Secrets
 
 ```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
+# List secrets
+xano run secrets list
+
+# Set a secret
+xano run secrets set docker-registry -t dockerconfigjson -v '{"auths":{...}}' -r ghcr.io
+xano run secrets set service-key -t service-account-token -v 'token-value'
 
-# Run a service (starts API endpoints)
-xano ephemeral:run:service -f service.xs
+# Get a secret value
+xano run secrets get docker-registry
+
+# Delete a secret
+xano run secrets delete docker-registry
+xano run secrets delete docker-registry --force  # Skip confirmation
 ```
 
 ### Static Hosts
@@ -126,7 +215,19 @@ All commands support these options:
 
 ## Configuration
 
-Profiles are stored in `~/.xano/credentials.yaml`.
+Profiles are stored in `~/.xano/credentials.yaml`:
+
+```yaml
+profiles:
+  default:
+    account_origin: https://app.xano.com
+    instance_origin: https://instance.xano.com
+    access_token: <token>
+    workspace: <workspace_id>
+    branch: <branch_id>
+    run_project: <run_project_id>  # Used by xano run commands
+default: default
+```
 
 ## Help
 

package/dist/commands/profile/create/index.d.ts

@@ -9,6 +9,8 @@ export default class ProfileCreate extends Command {
         access_token: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        run_base_url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         default: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     static description: string;

package/dist/commands/profile/create/index.js

@@ -36,6 +36,16 @@ export default class ProfileCreate extends Command {
             description: 'Branch name',
             required: false,
         }),
+        project: Flags.string({
+            char: 'j',
+            description: 'Project name',
+            required: false,
+        }),
+        run_base_url: Flags.string({
+            char: 'r',
+            description: 'Xano Run API base URL (default: https://app.xano.com/)',
+            required: false,
+        }),
         default: Flags.boolean({
             description: 'Set this profile as the default',
             required: false,
@@ -52,6 +62,9 @@ Profile 'staging' created successfully at ~/.xano/credentials.yaml
 `,
         `$ 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
+`,
+        `$ xano profile:create dev -i https://dev-instance.xano.com -t token789 -w my-workspace -b feature-branch -j my-project
+Profile 'dev' created successfully at ~/.xano/credentials.yaml
 `,
         `$ 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
@@ -93,6 +106,8 @@ Default profile set to 'production'
             access_token: flags.access_token,
             ...(flags.workspace && { workspace: flags.workspace }),
             ...(flags.branch && { branch: flags.branch }),
+            ...(flags.project && { project: flags.project }),
+            ...(flags.run_base_url && { run_base_url: flags.run_base_url }),
         };
         // Set default if flag is provided
         if (flags.default) {

package/dist/commands/profile/edit/index.d.ts

@@ -9,8 +9,14 @@ export default class ProfileEdit extends BaseCommand {
         access_token: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'run-project': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'remove-workspace': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'remove-branch': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'remove-project': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'remove-run-project': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        run_base_url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'remove-run-base-url': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     static description: string;

package/dist/commands/profile/edit/index.js

@@ -38,6 +38,15 @@ export default class ProfileEdit extends BaseCommand {
             description: 'Update branch name',
             required: false,
         }),
+        project: Flags.string({
+            char: 'j',
+            description: 'Update project name',
+            required: false,
+        }),
+        'run-project': Flags.string({
+            description: 'Update run project ID (for xano run commands)',
+            required: false,
+        }),
         'remove-workspace': Flags.boolean({
             description: 'Remove workspace from profile',
             required: false,
@@ -48,6 +57,26 @@ export default class ProfileEdit extends BaseCommand {
             required: false,
             default: false,
         }),
+        'remove-project': Flags.boolean({
+            description: 'Remove project from profile',
+            required: false,
+            default: false,
+        }),
+        'remove-run-project': Flags.boolean({
+            description: 'Remove run project from profile',
+            required: false,
+            default: false,
+        }),
+        run_base_url: Flags.string({
+            char: 'r',
+            description: 'Update Xano Run API base URL',
+            required: false,
+        }),
+        'remove-run-base-url': Flags.boolean({
+            description: 'Remove run_base_url from profile (use default)',
+            required: false,
+            default: false,
+        }),
     };
     static description = 'Edit an existing profile configuration';
     static examples = [
@@ -65,6 +94,12 @@ Profile 'default' updated successfully at ~/.xano/credentials.yaml
 `,
         `$ xano profile:edit --remove-branch
 Profile 'default' updated successfully at ~/.xano/credentials.yaml
+`,
+        `$ xano profile:edit -j my-project
+Profile 'default' updated successfully at ~/.xano/credentials.yaml
+`,
+        `$ xano profile:edit --remove-project
+Profile 'default' updated successfully at ~/.xano/credentials.yaml
 `,
     ];
     async run() {
@@ -98,7 +133,9 @@ Profile 'default' updated successfully at ~/.xano/credentials.yaml
         const existingProfile = credentials.profiles[profileName];
         // Check if any flags were provided
         const hasFlags = flags.account_origin || flags.instance_origin || flags.access_token ||
-            flags.workspace || flags.branch || flags['remove-workspace'] || flags['remove-branch'];
+            flags.workspace || flags.branch || flags.project || flags['run-project'] || flags.run_base_url ||
+            flags['remove-workspace'] || flags['remove-branch'] || flags['remove-project'] ||
+            flags['remove-run-project'] || flags['remove-run-base-url'];
         if (!hasFlags) {
             this.error('No fields specified to update. Use at least one flag to edit the profile.');
         }
@@ -110,6 +147,9 @@ Profile 'default' updated successfully at ~/.xano/credentials.yaml
             ...(flags.access_token !== undefined && { access_token: flags.access_token }),
             ...(flags.workspace !== undefined && { workspace: flags.workspace }),
             ...(flags.branch !== undefined && { branch: flags.branch }),
+            ...(flags.project !== undefined && { project: flags.project }),
+            ...(flags['run-project'] !== undefined && { run_project: flags['run-project'] }),
+            ...(flags.run_base_url !== undefined && { run_base_url: flags.run_base_url }),
         };
         // Handle removal flags
         if (flags['remove-workspace']) {
@@ -118,6 +158,15 @@ Profile 'default' updated successfully at ~/.xano/credentials.yaml
         if (flags['remove-branch']) {
             delete updatedProfile.branch;
         }
+        if (flags['remove-project']) {
+            delete updatedProfile.project;
+        }
+        if (flags['remove-run-project']) {
+            delete updatedProfile.run_project;
+        }
+        if (flags['remove-run-base-url']) {
+            delete updatedProfile.run_base_url;
+        }
         credentials.profiles[profileName] = updatedProfile;
         // Write the updated credentials back to the file
         try {

package/dist/commands/profile/list/index.js

@@ -30,6 +30,7 @@ Profile: default
   Access Token: ***...***
   Workspace: my-workspace
   Branch: main
+  Project: my-project
 
 Profile: production
   Account Origin: https://account.xano.com
@@ -45,6 +46,7 @@ Profile: default
   Access Token: ***...***
   Workspace: my-workspace
   Branch: main
+  Project: my-project
 `,
     ];
     async run() {
@@ -93,6 +95,9 @@ Profile: default
                 if (profile.branch) {
                     this.log(`  Branch: ${profile.branch}`);
                 }
+                if (profile.project) {
+                    this.log(`  Project: ${profile.project}`);
+                }
                 this.log(''); // Empty line between profiles
             }
         }

package/dist/commands/profile/project/index.d.ts

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export default class ProfileProject extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/profile/project/index.js

@@ -0,0 +1,54 @@
+import { Command } from '@oclif/core';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as yaml from 'js-yaml';
+export default class ProfileProject extends Command {
+    static description = 'Print the project for the default profile';
+    static examples = [
+        `$ xano profile:project
+my-project-id
+`,
+        `$ xano profile:project | pbcopy
+# Copies the project to clipboard on macOS
+`,
+    ];
+    async run() {
+        const configDir = path.join(os.homedir(), '.xano');
+        const credentialsPath = path.join(configDir, 'credentials.yaml');
+        // Check if credentials file exists
+        if (!fs.existsSync(credentialsPath)) {
+            this.error(`Credentials file not found at ${credentialsPath}. Create a profile first using 'profile:create'.`);
+        }
+        // Read credentials file
+        let credentials;
+        try {
+            const fileContent = fs.readFileSync(credentialsPath, 'utf8');
+            const parsed = yaml.load(fileContent);
+            if (!parsed || typeof parsed !== 'object' || !('profiles' in parsed)) {
+                this.error('Credentials file has invalid format.');
+            }
+            credentials = parsed;
+        }
+        catch (error) {
+            this.error(`Failed to parse credentials file: ${error}`);
+        }
+        // Get the default profile name
+        const defaultProfileName = credentials.default;
+        if (!defaultProfileName) {
+            this.error("No default profile set. Set one using 'profile:set-default <name>'.");
+        }
+        // Check if the default profile exists
+        if (!(defaultProfileName in credentials.profiles)) {
+            this.error(`Default profile '${defaultProfileName}' not found. Available profiles: ${Object.keys(credentials.profiles).join(', ')}`);
+        }
+        const profile = credentials.profiles[defaultProfileName];
+        // Get and display the project
+        if (profile.project) {
+            this.log(profile.project);
+        }
+        else {
+            this.error(`Profile '${defaultProfileName}' does not have a project set. Set one using 'profile:edit -j <project>'.`);
+        }
+    }
+}

package/dist/commands/profile/token/index.d.ts

@@ -0,0 +1,6 @@
+import { Command } from '@oclif/core';
+export default class ProfileToken extends Command {
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}

package/dist/commands/profile/token/index.js

@@ -0,0 +1,54 @@
+import { Command } from '@oclif/core';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as yaml from 'js-yaml';
+export default class ProfileToken extends Command {
+    static description = 'Print the access token for the default profile';
+    static examples = [
+        `$ xano profile:token
+eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
+`,
+        `$ xano profile:token | pbcopy
+# Copies the token to clipboard on macOS
+`,
+    ];
+    async run() {
+        const configDir = path.join(os.homedir(), '.xano');
+        const credentialsPath = path.join(configDir, 'credentials.yaml');
+        // Check if credentials file exists
+        if (!fs.existsSync(credentialsPath)) {
+            this.error(`Credentials file not found at ${credentialsPath}. Create a profile first using 'profile:create'.`);
+        }
+        // Read credentials file
+        let credentials;
+        try {
+            const fileContent = fs.readFileSync(credentialsPath, 'utf8');
+            const parsed = yaml.load(fileContent);
+            if (!parsed || typeof parsed !== 'object' || !('profiles' in parsed)) {
+                this.error('Credentials file has invalid format.');
+            }
+            credentials = parsed;
+        }
+        catch (error) {
+            this.error(`Failed to parse credentials file: ${error}`);
+        }
+        // Get the default profile name
+        const defaultProfileName = credentials.default;
+        if (!defaultProfileName) {
+            this.error("No default profile set. Set one using 'profile:set-default <name>'.");
+        }
+        // Check if the default profile exists
+        if (!(defaultProfileName in credentials.profiles)) {
+            this.error(`Default profile '${defaultProfileName}' not found. Available profiles: ${Object.keys(credentials.profiles).join(', ')}`);
+        }
+        const profile = credentials.profiles[defaultProfileName];
+        // Get and display the access token
+        if (profile.access_token) {
+            this.log(profile.access_token);
+        }
+        else {
+            this.error(`Profile '${defaultProfileName}' does not have an access token.`);
+        }
+    }
+}

package/dist/commands/profile/wizard/index.d.ts

@@ -10,6 +10,8 @@ export default class ProfileWizard extends Command {
     private fetchInstances;
     private fetchWorkspaces;
     private fetchBranches;
+    private fetchProjects;
+    private fetchRunProjects;
     private getDefaultProfileName;
     private saveProfile;
 }

package/dist/commands/profile/wizard/index.js

@@ -4,6 +4,7 @@ import * as os from 'node:os';
 import * as path from 'node:path';
 import * as yaml from 'js-yaml';
 import inquirer from 'inquirer';
+import { DEFAULT_RUN_BASE_URL } from '../../../lib/run-http-client.js';
 export default class ProfileWizard extends Command {
     static flags = {
         name: Flags.string({
@@ -96,6 +97,7 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
             // Step 5: Workspace selection
             let workspace;
             let branch;
+            let project;
             // Fetch workspaces from the selected instance
             this.log('');
             this.log('Fetching available workspaces...');
@@ -157,8 +159,56 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
                         ]);
                         branch = selectedBranch || undefined;
                     }
+                    // Step 6: Project selection
+                    this.log('');
+                    this.log('Fetching available projects...');
+                    let projects = [];
+                    try {
+                        projects = await this.fetchProjects(accessToken, selectedInstance.origin, workspace, branch);
+                    }
+                    catch (error) {
+                        this.warn(`Failed to fetch projects: ${error instanceof Error ? error.message : String(error)}`);
+                    }
+                    // If projects were fetched, let user select one
+                    if (projects.length > 0) {
+                        this.log('');
+                        const { selectedProject } = await inquirer.prompt([
+                            {
+                                type: 'list',
+                                name: 'selectedProject',
+                                message: 'Select a project',
+                                choices: [
+                                    { name: '(Skip project)', value: '' },
+                                    ...projects.map((proj) => {
+                                        return {
+                                            name: proj.name,
+                                            value: proj.id,
+                                        };
+                                    }),
+                                ],
+                            },
+                        ]);
+                        project = selectedProject || undefined;
+                    }
                 }
             }
+            // Step 7: Fetch run projects and auto-select the first one
+            let runProject;
+            this.log('');
+            this.log('Fetching available run projects...');
+            try {
+                const runProjects = await this.fetchRunProjects(accessToken);
+                if (runProjects.length > 0) {
+                    runProject = runProjects[0].id;
+                    this.log(`✓ Found ${runProjects.length} run project(s). Using "${runProjects[0].name}" as default.`);
+                }
+                else {
+                    this.log('No run projects found. You can create one later with "xano run projects create".');
+                }
+            }
+            catch {
+                // Silently ignore - run_project will remain undefined
+            }
             // Save profile
             await this.saveProfile({
                 name: profileName,
@@ -167,6 +217,8 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
                 access_token: accessToken,
                 workspace,
                 branch,
+                project,
+                run_project: runProject,
             }, true);
             this.log('');
             this.log(`✓ Profile '${profileName}' created successfully!`);
@@ -288,6 +340,60 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
         }
         return [];
     }
+    async fetchProjects(accessToken, origin, workspaceId, branchId) {
+        const branchParam = branchId ? `?branch=${branchId}` : '';
+        const response = await fetch(`${origin}/api:meta/workspace/${workspaceId}/project${branchParam}`, {
+            method: 'GET',
+            headers: {
+                accept: 'application/json',
+                Authorization: `Bearer ${accessToken}`,
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                throw new Error('Unauthorized. Please check your access token.');
+            }
+            throw new Error(`API request failed with status ${response.status}`);
+        }
+        const data = (await response.json());
+        // Transform API response to Project format
+        // Assuming the API returns an array or object with projects
+        if (Array.isArray(data)) {
+            return data.map((proj) => ({
+                id: proj.id || proj.name,
+                name: proj.name,
+            }));
+        }
+        // If it's an object, try to extract projects
+        if (data && typeof data === 'object') {
+            const projects = data.projects || data.data || [];
+            if (Array.isArray(projects)) {
+                return projects.map((proj) => ({
+                    id: proj.id || proj.name,
+                    name: proj.name,
+                }));
+            }
+        }
+        return [];
+    }
+    async fetchRunProjects(accessToken, runBaseUrl = DEFAULT_RUN_BASE_URL) {
+        const baseUrl = runBaseUrl.endsWith('/') ? runBaseUrl.slice(0, -1) : runBaseUrl;
+        const response = await fetch(`${baseUrl}/api:run/project`, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${accessToken}`,
+            },
+        });
+        if (!response.ok) {
+            if (response.status === 401) {
+                throw new Error('Unauthorized. Please check your access token.');
+            }
+            throw new Error(`API request failed with status ${response.status}`);
+        }
+        const data = (await response.json());
+        return Array.isArray(data) ? data : [];
+    }
     getDefaultProfileName() {
         try {
             const configDir = path.join(os.homedir(), '.xano');
@@ -334,6 +440,8 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
             access_token: profile.access_token,
             ...(profile.workspace && { workspace: profile.workspace }),
             ...(profile.branch && { branch: profile.branch }),
+            ...(profile.project && { project: profile.project }),
+            ...(profile.run_project && { run_project: profile.run_project }),
         };
         // Set as default if requested
         if (setAsDefault) {

package/dist/commands/run/env/delete/index.d.ts

@@ -0,0 +1,13 @@
+import BaseRunCommand from '../../../../lib/base-run-command.js';
+export default class RunEnvDelete extends BaseRunCommand {
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    static description: string;
+    static examples: string[];
+    run(): Promise<void>;
+}