@xano/cli 1.0.2-beta.5 → 1.0.2-beta.7

package/dist/commands/branch/set_live/index.js

@@ -1,6 +1,4 @@
 import { Args, Flags } from '@oclif/core';
-import * as yaml from 'js-yaml';
-import * as fs from 'node:fs';
 import BaseCommand from '../../../base-command.js';
 export default class BranchSetLive extends BaseCommand {
     static args = {
@@ -50,23 +48,7 @@ Branch 'v1' is now live
     };
     async run() {
         const { args, flags } = await this.parse(BranchSetLive);
-        // Get profile name (default or from flag/env)
-        const profileName = flags.profile || this.getDefaultProfile();
-        // Load credentials
-        const credentials = this.loadCredentials();
-        // Get the profile configuration
-        if (!(profileName in credentials.profiles)) {
-            this.error(`Profile '${profileName}' not found. Available profiles: ${Object.keys(credentials.profiles).join(', ')}\n` +
-                `Create a profile using 'xano profile create'`);
-        }
-        const profile = credentials.profiles[profileName];
-        // Validate required fields
-        if (!profile.instance_origin) {
-            this.error(`Profile '${profileName}' is missing instance_origin`);
-        }
-        if (!profile.access_token) {
-            this.error(`Profile '${profileName}' is missing access_token`);
-        }
+        const { profile } = this.resolveProfile(flags);
         // Get workspace ID from flag or profile
         const workspaceId = flags.workspace || profile.workspace;
         if (!workspaceId) {
@@ -129,24 +111,4 @@ Branch 'v1' is now live
             });
         });
     }
-    loadCredentials() {
-        const credentialsPath = this.getCredentialsPath();
-        // Check if credentials file exists
-        if (!fs.existsSync(credentialsPath)) {
-            this.error(`Credentials file not found at ${credentialsPath}\n` +
-                `Create a profile using 'xano profile create'`);
-        }
-        // Read credentials file
-        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.');
-            }
-            return parsed;
-        }
-        catch (error) {
-            this.error(`Failed to parse credentials file: ${error}`);
-        }
-    }
 }

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

@@ -15,6 +15,5 @@ export default class FunctionCreate extends BaseCommand {
     };
     run(): Promise<void>;
     private editFile;
-    private loadCredentials;
     private readStdin;
 }

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

@@ -1,5 +1,4 @@
 import { Flags } from '@oclif/core';
-import * as yaml from 'js-yaml';
 import { execSync } from 'node:child_process';
 import * as fs from 'node:fs';
 import * as os from 'node:os';
@@ -75,23 +74,7 @@ Name: my_function
     };
     async run() {
         const { flags } = await this.parse(FunctionCreate);
-        // Get profile name (default or from flag/env)
-        const profileName = flags.profile || this.getDefaultProfile();
-        // Load credentials
-        const credentials = this.loadCredentials();
-        // Get the profile configuration
-        if (!(profileName in credentials.profiles)) {
-            this.error(`Profile '${profileName}' not found. Available profiles: ${Object.keys(credentials.profiles).join(', ')}\n` +
-                `Create a profile using 'xano profile:create'`);
-        }
-        const profile = credentials.profiles[profileName];
-        // Validate required fields
-        if (!profile.instance_origin) {
-            this.error(`Profile '${profileName}' is missing instance_origin`);
-        }
-        if (!profile.access_token) {
-            this.error(`Profile '${profileName}' is missing access_token`);
-        }
+        const { profile, profileName } = this.resolveProfile(flags);
         // Determine workspace_id from flag or profile
         let workspaceId;
         if (flags.workspace) {
@@ -240,26 +223,6 @@ Name: my_function
         }
         return tmpFile;
     }
-    loadCredentials() {
-        const credentialsPath = this.getCredentialsPath();
-        // Check if credentials file exists
-        if (!fs.existsSync(credentialsPath)) {
-            this.error(`Credentials file not found at ${credentialsPath}\n` +
-                `Create a profile using 'xano profile:create'`);
-        }
-        // Read credentials file
-        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.');
-            }
-            return parsed;
-        }
-        catch (error) {
-            this.error(`Failed to parse credentials file: ${error}`);
-        }
-    }
     async readStdin() {
         return new Promise((resolve, reject) => {
             const chunks = [];

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

@@ -20,7 +20,6 @@ export default class FunctionEdit extends BaseCommand {
     private editFile;
     private editFunctionContent;
     private fetchFunctionCode;
-    private loadCredentials;
     private promptForFunctionId;
     private readStdin;
 }

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

@@ -1,6 +1,5 @@
 import { Args, Flags } from '@oclif/core';
 import inquirer from 'inquirer';
-import * as yaml from 'js-yaml';
 import { execSync } from 'node:child_process';
 import * as fs from 'node:fs';
 import * as os from 'node:os';
@@ -102,23 +101,7 @@ Name: my_function
     };
     async run() {
         const { args, flags } = await this.parse(FunctionEdit);
-        // Get profile name (default or from flag/env)
-        const profileName = flags.profile || this.getDefaultProfile();
-        // Load credentials
-        const credentials = this.loadCredentials();
-        // Get the profile configuration
-        if (!(profileName in credentials.profiles)) {
-            this.error(`Profile '${profileName}' not found. Available profiles: ${Object.keys(credentials.profiles).join(', ')}\n` +
-                `Create a profile using 'xano profile:create'`);
-        }
-        const profile = credentials.profiles[profileName];
-        // Validate required fields
-        if (!profile.instance_origin) {
-            this.error(`Profile '${profileName}' is missing instance_origin`);
-        }
-        if (!profile.access_token) {
-            this.error(`Profile '${profileName}' is missing access_token`);
-        }
+        const { profile, profileName } = this.resolveProfile(flags);
         // Validate flag combinations
         if (flags.edit && !flags.file) {
             this.error('The --edit flag requires --file to be specified');
@@ -368,25 +351,6 @@ Name: my_function
             throw error;
         }
     }
-    loadCredentials() {
-        const credentialsPath = this.getCredentialsPath();
-        // Check if credentials file exists
-        if (!fs.existsSync(credentialsPath)) {
-            this.error(`Credentials file not found at ${credentialsPath}\n` + `Create a profile using 'xano profile:create'`);
-        }
-        // Read credentials file
-        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.');
-            }
-            return parsed;
-        }
-        catch (error) {
-            this.error(`Failed to parse credentials file: ${error}`);
-        }
-    }
     async promptForFunctionId(profile, workspaceId) {
         try {
             // Fetch list of functions

package/dist/commands/function/get/index.d.ts

@@ -15,6 +15,5 @@ export default class FunctionGet extends BaseCommand {
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private loadCredentials;
     private promptForFunctionId;
 }

package/dist/commands/function/get/index.js

@@ -1,7 +1,5 @@
 import { Args, Flags } from '@oclif/core';
 import inquirer from 'inquirer';
-import * as yaml from 'js-yaml';
-import * as fs from 'node:fs';
 import BaseCommand, { buildUserAgent } from '../../../base-command.js';
 export default class FunctionGet extends BaseCommand {
     static args = {
@@ -76,23 +74,7 @@ function yo {
     };
     async run() {
         const { args, flags } = await this.parse(FunctionGet);
-        // Get profile name (default or from flag/env)
-        const profileName = flags.profile || this.getDefaultProfile();
-        // Load credentials
-        const credentials = this.loadCredentials();
-        // Get the profile configuration
-        if (!(profileName in credentials.profiles)) {
-            this.error(`Profile '${profileName}' not found. Available profiles: ${Object.keys(credentials.profiles).join(', ')}\n` +
-                `Create a profile using 'xano profile:create'`);
-        }
-        const profile = credentials.profiles[profileName];
-        // Validate required fields
-        if (!profile.instance_origin) {
-            this.error(`Profile '${profileName}' is missing instance_origin`);
-        }
-        if (!profile.access_token) {
-            this.error(`Profile '${profileName}' is missing access_token`);
-        }
+        const { profile, profileName } = this.resolveProfile(flags);
         // Determine workspace_id from flag or profile
         let workspaceId;
         if (flags.workspace) {
@@ -182,25 +164,6 @@ function yo {
             }
         }
     }
-    loadCredentials() {
-        const credentialsPath = this.getCredentialsPath();
-        // Check if credentials file exists
-        if (!fs.existsSync(credentialsPath)) {
-            this.error(`Credentials file not found at ${credentialsPath}\n` + `Create a profile using 'xano profile:create'`);
-        }
-        // Read credentials file
-        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.');
-            }
-            return parsed;
-        }
-        catch (error) {
-            this.error(`Failed to parse credentials file: ${error}`);
-        }
-    }
     async promptForFunctionId(profile, workspaceId) {
         try {
             // Fetch list of functions

package/dist/commands/function/list/index.d.ts

@@ -17,5 +17,4 @@ export default class FunctionList extends BaseCommand {
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private loadCredentials;
 }

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

@@ -1,6 +1,4 @@
 import { Flags } from '@oclif/core';
-import * as yaml from 'js-yaml';
-import * as fs from 'node:fs';
 import BaseCommand from '../../../base-command.js';
 export default class FunctionList extends BaseCommand {
     static args = {};
@@ -82,23 +80,7 @@ Available functions:
     };
     async run() {
         const { flags } = await this.parse(FunctionList);
-        // Get profile name (default or from flag/env)
-        const profileName = flags.profile || this.getDefaultProfile();
-        // Load credentials
-        const credentials = this.loadCredentials();
-        // Get the profile configuration
-        if (!(profileName in credentials.profiles)) {
-            this.error(`Profile '${profileName}' not found. Available profiles: ${Object.keys(credentials.profiles).join(', ')}\n` +
-                `Create a profile using 'xano profile:create'`);
-        }
-        const profile = credentials.profiles[profileName];
-        // Validate required fields
-        if (!profile.instance_origin) {
-            this.error(`Profile '${profileName}' is missing instance_origin`);
-        }
-        if (!profile.access_token) {
-            this.error(`Profile '${profileName}' is missing access_token`);
-        }
+        const { profile, profileName } = this.resolveProfile(flags);
         // Determine workspace_id from flag or profile
         let workspaceId;
         if (flags.workspace) {
@@ -182,24 +164,4 @@ Available functions:
             }
         }
     }
-    loadCredentials() {
-        const credentialsPath = this.getCredentialsPath();
-        // Check if credentials file exists
-        if (!fs.existsSync(credentialsPath)) {
-            this.error(`Credentials file not found at ${credentialsPath}\n` +
-                `Create a profile using 'xano profile:create'`);
-        }
-        // Read credentials file
-        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.');
-            }
-            return parsed;
-        }
-        catch (error) {
-            this.error(`Failed to parse credentials file: ${error}`);
-        }
-    }
 }

package/dist/commands/platform/get/index.d.ts

@@ -15,5 +15,4 @@ export default class PlatformGet extends BaseCommand {
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private loadCredentials;
 }

package/dist/commands/platform/get/index.js

@@ -1,6 +1,4 @@
 import { Args, Flags } from '@oclif/core';
-import * as yaml from 'js-yaml';
-import * as fs from 'node:fs';
 import BaseCommand from '../../../base-command.js';
 export default class PlatformGet extends BaseCommand {
     static args = {
@@ -43,19 +41,7 @@ Platform ID: 23629
     };
     async run() {
         const { args, flags } = await this.parse(PlatformGet);
-        const profileName = flags.profile || this.getDefaultProfile();
-        const credentials = this.loadCredentials();
-        if (!(profileName in credentials.profiles)) {
-            this.error(`Profile '${profileName}' not found. Available profiles: ${Object.keys(credentials.profiles).join(', ')}\n` +
-                `Create a profile using 'xano profile create'`);
-        }
-        const profile = credentials.profiles[profileName];
-        if (!profile.instance_origin) {
-            this.error(`Profile '${profileName}' is missing instance_origin`);
-        }
-        if (!profile.access_token) {
-            this.error(`Profile '${profileName}' is missing access_token`);
-        }
+        const { profile } = this.resolveProfile(flags);
         const platformId = args.platform_id;
         const apiUrl = `${profile.instance_origin}/api:meta/platform/${platformId}`;
         try {
@@ -102,22 +88,4 @@ Platform ID: 23629
             }
         }
     }
-    loadCredentials() {
-        const credentialsPath = this.getCredentialsPath();
-        if (!fs.existsSync(credentialsPath)) {
-            this.error(`Credentials file not found at ${credentialsPath}\n` +
-                `Create a profile using 'xano profile create'`);
-        }
-        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.');
-            }
-            return parsed;
-        }
-        catch (error) {
-            this.error(`Failed to parse credentials file: ${error}`);
-        }
-    }
 }

package/dist/commands/platform/list/index.d.ts

@@ -9,5 +9,4 @@ export default class PlatformList extends BaseCommand {
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private loadCredentials;
 }

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

@@ -1,6 +1,4 @@
 import { Flags } from '@oclif/core';
-import * as yaml from 'js-yaml';
-import * as fs from 'node:fs';
 import BaseCommand from '../../../base-command.js';
 export default class PlatformList extends BaseCommand {
     static description = 'List all platforms';
@@ -23,19 +21,7 @@ Platforms:
     };
     async run() {
         const { flags } = await this.parse(PlatformList);
-        const profileName = flags.profile || this.getDefaultProfile();
-        const credentials = this.loadCredentials();
-        if (!(profileName in credentials.profiles)) {
-            this.error(`Profile '${profileName}' not found. Available profiles: ${Object.keys(credentials.profiles).join(', ')}\n` +
-                `Create a profile using 'xano profile create'`);
-        }
-        const profile = credentials.profiles[profileName];
-        if (!profile.instance_origin) {
-            this.error(`Profile '${profileName}' is missing instance_origin`);
-        }
-        if (!profile.access_token) {
-            this.error(`Profile '${profileName}' is missing access_token`);
-        }
+        const { profile } = this.resolveProfile(flags);
         const apiUrl = `${profile.instance_origin}/api:meta/platform`;
         try {
             const response = await this.verboseFetch(apiUrl, {
@@ -89,22 +75,4 @@ Platforms:
             }
         }
     }
-    loadCredentials() {
-        const credentialsPath = this.getCredentialsPath();
-        if (!fs.existsSync(credentialsPath)) {
-            this.error(`Credentials file not found at ${credentialsPath}\n` +
-                `Create a profile using 'xano profile create'`);
-        }
-        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.');
-            }
-            return parsed;
-        }
-        catch (error) {
-            this.error(`Failed to parse credentials file: ${error}`);
-        }
-    }
 }

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

@@ -0,0 +1,33 @@
+import { Command } from '@oclif/core';
+import { type LocalProfileConfig } from '../../../utils/local-config.js';
+/**
+ * Ensure `entry` exists as its own line in a .gitignore.
+ * Returns the (possibly unchanged) content and whether a write is needed.
+ */
+export declare function ensureGitignoreEntry(existing: null | string, entry: string): {
+    changed: boolean;
+    content: string;
+};
+/**
+ * Build a self-documenting profile.yaml string from a LocalProfileConfig.
+ * Set fields are emitted uncommented; unset fields appear as commented placeholders.
+ */
+export declare function buildProfileYaml(config: LocalProfileConfig): string;
+export default class ProfileUse extends Command {
+    static args: {
+        name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        account_origin: 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>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        gitignore: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        instance_origin: 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>;
+    };
+    run(): Promise<void>;
+    private assertProfileExists;
+    private handleGitignore;
+}

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

@@ -0,0 +1,179 @@
+import { Args, Command, Flags } from '@oclif/core';
+import inquirer from 'inquirer';
+import * as yaml from 'js-yaml';
+import * as fs from 'node:fs';
+import { resolve } from 'node:path';
+import { resolveCredentialsPath } from '../../../base-command.js';
+import { LOCAL_PROFILE_FILENAME } from '../../../utils/local-config.js';
+/**
+ * Ensure `entry` exists as its own line in a .gitignore.
+ * Returns the (possibly unchanged) content and whether a write is needed.
+ */
+export function ensureGitignoreEntry(existing, entry) {
+    const lines = existing ? existing.split('\n').map((line) => line.trim()) : [];
+    if (lines.includes(entry)) {
+        return { changed: false, content: existing ?? '' };
+    }
+    const base = existing && !existing.endsWith('\n') ? existing + '\n' : existing ?? '';
+    return { changed: true, content: `${base}${entry}\n` };
+}
+const OVERRIDE_FIELDS = [
+    { key: 'workspace', placeholder: '123' },
+    { key: 'instance_origin', placeholder: 'https://your-instance.xano.io' },
+    { key: 'account_origin', placeholder: 'https://app.xano.com' },
+    { key: 'branch', placeholder: 'main' },
+];
+/**
+ * Build a self-documenting profile.yaml string from a LocalProfileConfig.
+ * Set fields are emitted uncommented; unset fields appear as commented placeholders.
+ */
+export function buildProfileYaml(config) {
+    const lines = [
+        '# Xano project-local profile — pins this project to a profile in ~/.xano/credentials.yaml.',
+        '# No secrets here: the access token always comes from credentials.yaml.',
+        '# Precedence: an explicit -p/--profile or XANO_PROFILE overrides this file entirely.',
+        '',
+        '# Profile to use (a profile name from ~/.xano/credentials.yaml):',
+        `profile: ${config.profile}`,
+        '',
+        '# Optional per-project overrides — uncomment and edit any you need:',
+    ];
+    for (const { key, placeholder } of OVERRIDE_FIELDS) {
+        const value = config[key];
+        lines.push(value === undefined ? `# ${key}: ${placeholder}` : `${key}: ${value}`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+export default class ProfileUse extends Command {
+    static args = {
+        name: Args.string({
+            description: 'Profile name (from credentials.yaml) to pin for this project',
+            required: true,
+        }),
+    };
+    static description = 'Pin a profile for the current project by writing a local profile.yaml. ' +
+        'When present, the CLI uses this profile (and any overrides) instead of the default, ' +
+        'unless -p/--profile or XANO_PROFILE is set.';
+    static examples = [
+        `$ xano profile use staging
+Wrote profile.yaml pinning profile 'staging'
+`,
+        `$ xano profile use staging -w 110
+Wrote profile.yaml pinning profile 'staging' (workspace 110)
+`,
+        `$ xano profile use staging -w 110 --gitignore
+Wrote profile.yaml pinning profile 'staging' (workspace 110)
+Added profile.yaml to .gitignore
+`,
+    ];
+    static flags = {
+        // eslint-disable-next-line camelcase
+        account_origin: Flags.string({
+            char: 'a',
+            description: 'Override account origin for this project',
+            required: false,
+        }),
+        branch: Flags.string({
+            char: 'b',
+            description: 'Override branch for this project',
+            required: false,
+        }),
+        config: Flags.string({
+            char: 'c',
+            description: 'Path to credentials file (default: ~/.xano/credentials.yaml)',
+            env: 'XANO_CONFIG',
+            required: false,
+        }),
+        gitignore: Flags.boolean({
+            allowNo: true,
+            description: 'Add (or skip adding) profile.yaml to .gitignore without prompting',
+            required: false,
+        }),
+        // eslint-disable-next-line camelcase
+        instance_origin: Flags.string({
+            char: 'i',
+            description: 'Override instance origin for this project',
+            required: false,
+        }),
+        workspace: Flags.string({
+            char: 'w',
+            description: 'Override workspace for this project',
+            required: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ProfileUse);
+        this.assertProfileExists(args.name, flags.config);
+        const config = { profile: args.name };
+        if (flags.workspace)
+            config.workspace = flags.workspace;
+        // eslint-disable-next-line camelcase
+        if (flags.instance_origin)
+            config.instance_origin = flags.instance_origin;
+        // eslint-disable-next-line camelcase
+        if (flags.account_origin)
+            config.account_origin = flags.account_origin;
+        if (flags.branch)
+            config.branch = flags.branch;
+        const filePath = resolve(process.cwd(), LOCAL_PROFILE_FILENAME);
+        if (fs.existsSync(filePath)) {
+            this.warn(`Overwriting existing ${LOCAL_PROFILE_FILENAME}`);
+        }
+        try {
+            fs.writeFileSync(filePath, buildProfileYaml(config), 'utf8');
+        }
+        catch (error) {
+            this.error(`Failed to write ${LOCAL_PROFILE_FILENAME}: ${error}`);
+        }
+        const workspaceNote = flags.workspace ? ` (workspace ${flags.workspace})` : '';
+        this.log(`Wrote ${LOCAL_PROFILE_FILENAME} pinning profile '${args.name}'${workspaceNote}`);
+        await this.handleGitignore(flags.gitignore);
+    }
+    assertProfileExists(name, configPath) {
+        const credentialsPath = resolveCredentialsPath(configPath);
+        if (!fs.existsSync(credentialsPath)) {
+            this.error(`Credentials file not found at ${credentialsPath}. Create a profile first using 'xano auth'.`);
+        }
+        let parsed;
+        try {
+            parsed = yaml.load(fs.readFileSync(credentialsPath, 'utf8'));
+        }
+        catch (error) {
+            this.error(`Failed to parse credentials file: ${error}`);
+        }
+        if (!parsed || typeof parsed !== 'object' || !('profiles' in parsed)) {
+            this.error('Credentials file has invalid format.');
+        }
+        if (!(name in parsed.profiles)) {
+            this.error(`Profile '${name}' not found. Available profiles: ${Object.keys(parsed.profiles).join(', ')}`);
+        }
+    }
+    async handleGitignore(flag) {
+        const gitignorePath = resolve(process.cwd(), '.gitignore');
+        const existing = fs.existsSync(gitignorePath) ? fs.readFileSync(gitignorePath, 'utf8') : null;
+        // If profile.yaml is already in .gitignore, no action needed regardless of flag.
+        const alreadyIgnored = !ensureGitignoreEntry(existing, LOCAL_PROFILE_FILENAME).changed;
+        if (alreadyIgnored) {
+            return;
+        }
+        let shouldAdd = flag;
+        if (shouldAdd === undefined) {
+            const { add } = await inquirer.prompt([
+                {
+                    default: false,
+                    message: `Add ${LOCAL_PROFILE_FILENAME} to .gitignore?`,
+                    name: 'add',
+                    type: 'confirm',
+                },
+            ]);
+            shouldAdd = add;
+        }
+        if (!shouldAdd) {
+            return;
+        }
+        const { content } = ensureGitignoreEntry(existing, LOCAL_PROFILE_FILENAME);
+        fs.writeFileSync(gitignorePath, content, 'utf8');
+        this.log(`Added ${LOCAL_PROFILE_FILENAME} to .gitignore`);
+    }
+}

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

@@ -17,5 +17,4 @@ export default class ReleaseCreate extends BaseCommand {
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private loadCredentials;
 }