heroku 11.0.0-alpha.11 → 11.0.0-alpha.13

package/lib/commands/apps/info.js

@@ -1,9 +1,9 @@
-import { Args, ux } from '@oclif/core';
-import { hux } from '@heroku/heroku-cli-util';
+import { color, hux } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
-import * as util from 'util';
-import _ from 'lodash';
+import { Args, ux } from '@oclif/core';
 import { filesize } from 'filesize';
+import _ from 'lodash';
+import * as util from 'util';
 import { getGeneration } from '../../lib/apps/generation.js';
 const { countBy, snakeCase } = _;
 function formatDate(date) {
@@ -24,8 +24,8 @@ async function getInfo(app, client, extended) {
     const data = {
         addons,
         app: appWithMoreInfo,
-        dynos,
         collaborators,
+        dynos,
         pipeline_coupling: pipelineCouplings,
     };
     if (appExtendedResponse) {
@@ -49,22 +49,22 @@ function print(info, addons, collaborators, extended) {
     if (info.app.cron_next_run)
         data['Cron Next Run'] = formatDate(new Date(info.app.cron_next_run));
     if (info.app.database_size)
-        data['Database Size'] = filesize(info.app.database_size, { standard: 'jedec', round: 0 });
+        data['Database Size'] = filesize(info.app.database_size, { round: 0, standard: 'jedec' });
     if (info.app.create_status !== 'complete')
         data['Create Status'] = info.app.create_status;
     if (info.app.space)
-        data.Space = info.app.space.name;
+        data.Space = color.space(info.app.space.name);
     if (info.app.space && info.app.internal_routing)
         data['Internal Routing'] = info.app.internal_routing;
     if (info.pipeline_coupling)
-        data.Pipeline = `${info.pipeline_coupling.pipeline.name} - ${info.pipeline_coupling.stage}`;
+        data.Pipeline = `${color.pipeline(info.pipeline_coupling.pipeline.name)} - ${info.pipeline_coupling.stage}`;
     data['Auto Cert Mgmt'] = info.app.acm;
     data['Git URL'] = info.app.git_url;
-    data['Web URL'] = info.app.web_url;
-    data['Repo Size'] = filesize(info.app.repo_size, { standard: 'jedec', round: 0 });
+    data['Web URL'] = color.info(info.app.web_url);
+    data['Repo Size'] = filesize(info.app.repo_size, { round: 0, standard: 'jedec' });
     if (getGeneration(info.app) !== 'fir')
-        data['Slug Size'] = filesize(info.app.slug_size, { standard: 'jedec', round: 0 });
-    data.Owner = info.app.owner.email;
+        data['Slug Size'] = filesize(info.app.slug_size, { round: 0, standard: 'jedec' });
+    data.Owner = color.user(info.app.owner.email);
     data.Region = info.app.region.name;
     data.Dynos = countBy(info.dynos, 'type');
     data.Stack = (function (app) {
@@ -74,7 +74,7 @@ function print(info, addons, collaborators, extended) {
         }
         return stack;
     })(info.app);
-    hux.styledHeader(info.app.name);
+    hux.styledHeader(color.app(info.app.name));
     hux.styledObject(data);
     if (extended) {
         ux.stdout('\n\n--- Extended Information ---\n\n');
@@ -84,13 +84,21 @@ function print(info, addons, collaborators, extended) {
     }
 }
 export default class AppsInfo extends Command {
+    static args = {
+        app: Args.string({ hidden: true }),
+    };
     static description = 'show detailed app information';
-    static topic = 'apps';
-    static hiddenAliases = ['info'];
     static examples = [
-        '$ heroku apps:info',
-        '$ heroku apps:info --shell',
+        color.command('heroku apps:info'),
+        color.command('heroku apps:info --shell'),
     ];
+    static flags = {
+        app: flags.app(),
+        extended: flags.boolean({ char: 'x', hidden: true }),
+        json: flags.boolean({ char: 'j', description: 'output in json format' }),
+        remote: flags.remote(),
+        shell: flags.boolean({ char: 's', description: 'output more shell friendly key/value pairs' }),
+    };
     static help = `$ heroku apps:info
 === example
 Git URL:   https://git.heroku.com/example.git
@@ -101,18 +109,10 @@ $ heroku apps:info --shell
 git_url=https://git.heroku.com/example.git
 repo_size=5000000
 ...`;
-    static flags = {
-        app: flags.app(),
-        remote: flags.remote(),
-        shell: flags.boolean({ char: 's', description: 'output more shell friendly key/value pairs' }),
-        extended: flags.boolean({ char: 'x', hidden: true }),
-        json: flags.boolean({ char: 'j', description: 'output in json format' }),
-    };
-    static args = {
-        app: Args.string({ hidden: true }),
-    };
+    static hiddenAliases = ['info'];
+    static topic = 'apps';
     async run() {
-        const { flags, args } = await this.parse(AppsInfo);
+        const { args, flags } = await this.parse(AppsInfo);
         const app = args.app || flags.app;
         if (!app)
             throw new Error('No app specified.\nUSAGE: heroku apps:info --app my-app');
@@ -135,16 +135,16 @@ repo_size=5000000
             if (info.app.cron_next_run)
                 print('cron_next_run', formatDate(new Date(info.app.cron_next_run)));
             if (info.app.database_size)
-                print('database_size', filesize(info.app.database_size, { standard: 'jedec', round: 0 }));
+                print('database_size', filesize(info.app.database_size, { round: 0, standard: 'jedec' }));
             if (info.app.create_status !== 'complete')
                 print('create_status', info.app.create_status);
             if (info.pipeline_coupling)
                 print('pipeline', `${info.pipeline_coupling.pipeline.name}:${info.pipeline_coupling.stage}`);
             print('git_url', info.app.git_url);
             print('web_url', info.app.web_url);
-            print('repo_size', filesize(info.app.repo_size, { standard: 'jedec', round: 0 }));
+            print('repo_size', filesize(info.app.repo_size, { round: 0, standard: 'jedec' }));
             if (getGeneration(info.app) !== 'fir')
-                print('slug_size', filesize(info.app.slug_size, { standard: 'jedec', round: 0 }));
+                print('slug_size', filesize(info.app.slug_size, { round: 0, standard: 'jedec' }));
             print('owner', info.app.owner.email);
             print('region', info.app.region.name);
             print('dynos', util.inspect(countBy(info.dynos, 'type')));

package/lib/commands/apps/join.d.ts

@@ -1,11 +1,11 @@
 import { Command } from '@heroku-cli/command';
 export default class AppsJoin extends Command {
-    static topic: string;
-    static description: string;
     static aliases: string[];
+    static description: string;
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
+    static topic: string;
     run(): Promise<void>;
 }

package/lib/commands/apps/join.js

@@ -1,14 +1,14 @@
-import { color } from '@heroku-cli/color';
+import { color } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
 import { ux } from '@oclif/core';
 export default class AppsJoin extends Command {
-    static topic = 'apps';
-    static description = 'add yourself to a team app';
     static aliases = ['join'];
+    static description = 'add yourself to a team app';
     static flags = {
         app: flags.app({ required: true }),
         remote: flags.remote({ char: 'r' }),
     };
+    static topic = 'apps';
     async run() {
         const { flags } = await this.parse(AppsJoin);
         const { app } = flags;

package/lib/commands/apps/leave.d.ts

@@ -1,6 +1,5 @@
 import { Command } from '@heroku-cli/command';
 export default class Leave extends Command {
-    static topic: string;
     static aliases: string[];
     static description: string;
     static example: string;
@@ -8,5 +7,6 @@ export default class Leave extends Command {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
+    static topic: string;
     run(): Promise<void>;
 }

package/lib/commands/apps/leave.js

@@ -1,15 +1,15 @@
-import { color } from '@heroku-cli/color';
+import { color } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
 import { ux } from '@oclif/core';
 export default class Leave extends Command {
-    static topic = 'apps';
     static aliases = ['leave'];
     static description = 'remove yourself from a team app';
-    static example = 'heroku apps:leave -a APP';
+    static example = `${color.command('heroku apps:leave -a APP')}`;
     static flags = {
         app: flags.app({ required: true }),
         remote: flags.remote(),
     };
+    static topic = 'apps';
     async run() {
         const { flags } = await this.parse(Leave);
         const { app } = flags;

package/lib/commands/apps/lock.d.ts

@@ -1,11 +1,11 @@
 import { Command } from '@heroku-cli/command';
 export default class AppsLock extends Command {
-    static topic: string;
-    static description: string;
     static aliases: string[];
+    static description: string;
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
+    static topic: string;
     run(): Promise<void>;
 }

package/lib/commands/apps/lock.js

@@ -1,23 +1,23 @@
-import { color } from '@heroku-cli/color';
+import { color } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
 import { ux } from '@oclif/core';
 export default class AppsLock extends Command {
-    static topic = 'apps';
-    static description = 'prevent team members from joining an app';
     static aliases = ['lock'];
+    static description = 'prevent team members from joining an app';
     static flags = {
         app: flags.app({ required: true }),
         remote: flags.remote(),
     };
+    static topic = 'apps';
     async run() {
         const { flags } = await this.parse(AppsLock);
         const { app } = flags;
         const { body: appResponse } = await this.heroku.get(`/teams/apps/${app}`);
         const appName = appResponse.name ?? app;
         if (appResponse.locked) {
-            throw new Error(`Error: cannot lock ${color.cyan(appName)}.\nThis app is already locked.`);
+            throw new Error(`Error: cannot lock ${color.app(appName)}.\nThis app is already locked.`);
         }
-        ux.action.start(`Locking ${color.cyan(appName)}`);
+        ux.action.start(`Locking ${color.app(appName)}`);
         await this.heroku.patch(`/teams/apps/${appName}`, {
             body: { locked: true },
         });

package/lib/commands/apps/open.d.ts

@@ -1,15 +1,15 @@
 import { Command } from '@heroku-cli/command';
 export default class AppsOpen extends Command {
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
     static description: string;
-    static topic: string;
-    static hiddenAliases: string[];
     static examples: string[];
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
-    static args: {
-        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
-    };
+    static hiddenAliases: string[];
+    static topic: string;
     run(): Promise<void>;
 }

package/lib/commands/apps/open.js

@@ -1,27 +1,29 @@
-import { Args } from '@oclif/core';
+import { color } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
+import { Args, ux } from '@oclif/core';
 import open from 'open';
 export default class AppsOpen extends Command {
+    static args = {
+        path: Args.string({ description: 'base URL path of app', required: false }),
+    };
     static description = 'open the app in a web browser';
-    static topic = 'apps';
-    static hiddenAliases = ['open'];
     static examples = [
-        '$ heroku open -a myapp',
-        '$ heroku open -a myapp /foo',
+        color.command('heroku open -a myapp'),
+        color.command('heroku open -a myapp /foo'),
     ];
     static flags = {
         app: flags.app({ required: true }),
         remote: flags.remote(),
     };
-    static args = {
-        path: Args.string({ required: false, description: 'base URL path of app' }),
-    };
+    static hiddenAliases = ['open'];
+    static topic = 'apps';
     async run() {
-        const { flags, args } = await this.parse(AppsOpen);
+        const { args, flags } = await this.parse(AppsOpen);
         const appResponse = await this.heroku.get(`/apps/${flags.app}`);
         const app = appResponse.body;
         const path = args.path || '';
         const url = new URL(path, app.web_url);
+        ux.stdout(`Opening ${color.info(url.toString())}...`);
         await open(url.toString());
     }
 }

package/lib/commands/apps/rename.d.ts

@@ -1,16 +1,16 @@
 import { Command } from '@heroku-cli/command';
 export default class AppsRename extends Command {
+    static args: {
+        newname: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
     static description: string;
-    static help: string;
-    static topic: string;
-    static hiddenAliases: string[];
     static examples: string[];
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
-    static args: {
-        newname: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
+    static help: string;
+    static hiddenAliases: string[];
+    static topic: string;
     run(): Promise<void>;
 }

package/lib/commands/apps/rename.js

@@ -1,32 +1,32 @@
-import { Args, ux } from '@oclif/core';
+import { color } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
+import { Args, ux } from '@oclif/core';
 import * as git from '../../lib/ci/git.js';
-import { color } from '@heroku-cli/color';
 export default class AppsRename extends Command {
+    static args = {
+        newname: Args.string({ description: 'new unique name of the app', required: true }),
+    };
     static description = 'rename an app';
-    static help = 'This will locally update the git remote if it is set to the old app.';
-    static topic = 'apps';
-    static hiddenAliases = ['rename'];
     static examples = [
-        '$ heroku apps:rename --app oldname newname',
+        color.command('heroku apps:rename --app oldname newname'),
     ];
     static flags = {
         app: flags.app({ required: true }),
         remote: flags.remote(),
     };
-    static args = {
-        newname: Args.string({ required: true, description: 'new unique name of the app' }),
-    };
+    static help = 'This will locally update the git remote if it is set to the old app.';
+    static hiddenAliases = ['rename'];
+    static topic = 'apps';
     async run() {
-        const { flags, args } = await this.parse(AppsRename);
+        const { args, flags } = await this.parse(AppsRename);
         const oldApp = flags.app;
         const newApp = args.newname;
-        ux.action.start(`Renaming ${color.cyan(oldApp)} to ${color.green(newApp)}`);
+        ux.action.start(`Renaming ${color.app(oldApp)} to ${color.info(newApp)}`);
         const appResponse = await this.heroku.patch(`/apps/${oldApp}`, { body: { name: newApp } });
         const app = appResponse.body;
         ux.action.stop();
         const gitUrl = git.gitUrl(app.name);
-        ux.stdout(`${app.web_url} | ${gitUrl}`);
+        ux.stdout(`${color.info(app.web_url)} | ${color.info(gitUrl)}`);
         if (!app.web_url.includes('https')) {
             ux.stdout('Please note that it may take a few minutes for Heroku to provision a SSL certificate for your application.');
         }
@@ -46,7 +46,7 @@ export default class AppsRename extends Command {
                     const { name } = remote;
                     await git.rmRemote(name);
                     await git.createRemote(name, url.replace(oldApp, newApp));
-                    ux.stdout(`Git remote ${name} updated`);
+                    ux.stdout(`Git remote ${color.name(name)} updated`);
                 }
             };
             await Promise.all([

package/lib/commands/apps/stacks/index.d.ts

@@ -1,11 +1,11 @@
 import { Command } from '@heroku-cli/command';
 export default class StacksIndex extends Command {
     static description: string;
-    static topic: string;
-    static hiddenAliases: string[];
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
+    static hiddenAliases: string[];
+    static topic: string;
     run(): Promise<void>;
 }

package/lib/commands/apps/stacks/index.js

@@ -1,7 +1,6 @@
-import { ux } from '@oclif/core';
-import { hux } from '@heroku/heroku-cli-util';
+import { color, hux } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
-import { color } from '@heroku-cli/color';
+import { ux } from '@oclif/core';
 function updateCedarName(stack) {
     if (stack === 'cedar') {
         return 'cedar-10';
@@ -10,12 +9,12 @@ function updateCedarName(stack) {
 }
 export default class StacksIndex extends Command {
     static description = 'show the list of available stacks';
-    static topic = 'apps';
-    static hiddenAliases = ['stack'];
     static flags = {
         app: flags.app({ required: true }),
         remote: flags.remote(),
     };
+    static hiddenAliases = ['stack'];
+    static topic = 'apps';
     async run() {
         const { flags } = await this.parse(StacksIndex);
         const [appResponse, stackResponse] = await Promise.all([
@@ -28,7 +27,7 @@ export default class StacksIndex extends Command {
         hux.styledHeader(`${color.app(app.name)} Available Stacks`);
         for (const stack of sortedStacks) {
             if (stack.name === app.stack.name) {
-                ux.stdout(color.green('* ' + updateCedarName(stack.name)));
+                ux.stdout(color.name('* ' + updateCedarName(stack.name)));
             }
             else if (stack.name === app.build_stack.name) {
                 ux.stdout(`  ${updateCedarName(stack.name)} (active on next deploy)`);

package/lib/commands/apps/stacks/set.d.ts

@@ -1,14 +1,14 @@
 import { Command } from '@heroku-cli/command';
 export default class Set extends Command {
+    static args: {
+        stack: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
     static description: string;
     static example: string;
-    static hiddenAliases: string[];
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
-    static args: {
-        stack: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
+    static hiddenAliases: string[];
     run(): Promise<void>;
 }

package/lib/commands/apps/stacks/set.js

@@ -1,4 +1,4 @@
-import { color } from '@heroku-cli/color';
+import { color } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
 import { Args, ux } from '@oclif/core';
 import push from '../../../lib/git/push.js';
@@ -6,23 +6,23 @@ function map(stack) {
     return stack === 'cedar-10' ? 'cedar' : stack;
 }
 export default class Set extends Command {
+    static args = {
+        stack: Args.string({ description: 'unique name or identifier of the stack', required: true }),
+    };
     static description = 'set the stack of an app';
-    static example = `$ heroku stack:set heroku-24 -a myapp
+    static example = `${color.command('heroku stack:set heroku-24 -a myapp')}
 Setting stack to heroku-24... done
 You will need to redeploy myapp for the change to take effect.
 Run git push heroku main to trigger a new build on myapp.`;
-    static hiddenAliases = ['stack:set'];
     static flags = {
         app: flags.app({ required: true }),
         remote: flags.remote(),
     };
-    static args = {
-        stack: Args.string({ required: true, description: 'unique name or identifier of the stack' }),
-    };
+    static hiddenAliases = ['stack:set'];
     async run() {
-        const { flags, args } = await this.parse(Set);
+        const { args, flags } = await this.parse(Set);
         const stack = map(args.stack);
-        ux.action.start(`Setting stack to ${color.green(stack)}`);
+        ux.action.start(`Setting stack to ${color.name(stack)}`);
         const { body: app } = await this.heroku.patch(`/apps/${flags.app}`, {
             body: { build_stack: stack },
         });
@@ -30,7 +30,7 @@ Run git push heroku main to trigger a new build on myapp.`;
         // API updates the app's `stack` to match `build_stack` immediately.
         if (app.stack?.name !== app.build_stack?.name) {
             ux.stdout(`You will need to redeploy ${color.app(flags.app)} for the change to take effect.`);
-            ux.stdout(`Run ${color.cmd(push(flags.remote))} to trigger a new build on ${color.app(flags.app)}.`);
+            ux.stdout(`Run ${color.code(push(flags.remote))} to trigger a new build on ${color.app(flags.app)}.`);
         }
         ux.action.stop();
     }

package/lib/commands/apps/transfer.d.ts

@@ -2,19 +2,19 @@ import { Command } from '@heroku-cli/command';
 import * as Heroku from '@heroku-cli/schema';
 import inquirer from 'inquirer';
 export default class AppsTransfer extends Command {
-    static topic: string;
+    static args: {
+        recipient: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
     static description: string;
+    static examples: string[];
     static flags: {
-        locked: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        bulk: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        bulk: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         confirm: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        locked: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
-    static args: {
-        recipient: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static examples: string[];
+    static topic: string;
     getAppsToTransfer(apps: Heroku.App[]): Promise<any> & {
         ui: inquirer.ui.Prompt<any>;
     };

package/lib/commands/apps/transfer.js

@@ -1,59 +1,60 @@
-import { color } from '@heroku-cli/color';
+import { color } from '@heroku/heroku-cli-util';
 import { Command, flags } from '@heroku-cli/command';
 import { Args, ux } from '@oclif/core';
 import inquirer from 'inquirer';
-import { getOwner, isTeamApp, isValidEmail } from '../../lib/teamUtils.js';
-import AppsLock from './lock.js';
+import tsheredoc from 'tsheredoc';
 import { appTransfer } from '../../lib/apps/app-transfer.js';
 import ConfirmCommand from '../../lib/confirmCommand.js';
+import { getOwner, isTeamApp, isValidEmail } from '../../lib/teamUtils.js';
+import AppsLock from './lock.js';
+const heredoc = tsheredoc.default;
 export default class AppsTransfer extends Command {
-    static topic = 'apps';
+    static args = {
+        recipient: Args.string({ description: 'user or team to transfer applications to', required: true }),
+    };
     static description = 'transfer applications to another user or team';
+    static examples = [heredoc(`
+    ${color.command('heroku apps:transfer collaborator@example.com')}
+    Transferring example to collaborator@example.com... done`), heredoc(`
+    ${color.command('heroku apps:transfer acme-widgets')}
+    Transferring example to acme-widgets... done`), heredoc(`
+    ${color.command('heroku apps:transfer --bulk acme-widgets')}
+    ...`)];
     static flags = {
-        locked: flags.boolean({ char: 'l', required: false, description: 'lock the app upon transfer' }),
-        bulk: flags.boolean({ required: false, description: 'transfer applications in bulk' }),
         app: flags.app(),
-        remote: flags.remote({ char: 'r' }),
+        bulk: flags.boolean({ description: 'transfer applications in bulk', required: false }),
         confirm: flags.string({ char: 'c', hidden: true }),
+        locked: flags.boolean({ char: 'l', description: 'lock the app upon transfer', required: false }),
+        remote: flags.remote({ char: 'r' }),
     };
-    static args = {
-        recipient: Args.string({ description: 'user or team to transfer applications to', required: true }),
-    };
-    static examples = [`$ heroku apps:transfer collaborator@example.com
-Transferring example to collaborator@example.com... done
-
-$ heroku apps:transfer acme-widgets
-Transferring example to acme-widgets... done
-
-$ heroku apps:transfer --bulk acme-widgets
-...`];
+    static topic = 'apps';
     getAppsToTransfer(apps) {
         return inquirer.prompt([{
-                type: 'checkbox',
-                name: 'choices',
-                pageSize: 20,
-                message: 'Select applications you would like to transfer',
                 choices: apps.map(app => ({
-                    name: `${app.name} (${getOwner(app.owner?.email)})`, value: { name: app.name, owner: app.owner?.email },
+                    name: `${color.app(app.name ?? '')} (${getOwner(app.owner?.email ?? '')})`, value: { name: app.name, owner: app.owner?.email },
                 })),
+                message: 'Select applications you would like to transfer',
+                name: 'choices',
+                pageSize: 20,
+                type: 'checkbox',
             }]);
     }
     async run() {
-        const { flags, args } = await this.parse(AppsTransfer);
-        const { app, bulk, locked, confirm } = flags;
+        const { args, flags } = await this.parse(AppsTransfer);
+        const { app, bulk, confirm, locked } = flags;
         const { recipient } = args;
         if (bulk) {
             const { body: allApps } = await this.heroku.get('/apps');
             const selectedApps = await this.getAppsToTransfer(allApps.sort((a, b) => (a.name ?? '').localeCompare(b.name ?? '')));
-            ux.warn(`Transferring applications to ${color.magenta(recipient)}...\n`);
+            ux.warn(`Transferring applications to ${color.name(recipient)}...\n`);
             for (const app of selectedApps.choices) {
                 try {
                     await appTransfer({
-                        heroku: this.heroku,
                         appName: app.name,
-                        recipient,
-                        personalToPersonal: isValidEmail(recipient) && !isTeamApp(app.owner),
                         bulk: true,
+                        heroku: this.heroku,
+                        personalToPersonal: isValidEmail(recipient) && !isTeamApp(app.owner),
+                        recipient,
                     });
                 }
                 catch (error) {
@@ -69,11 +70,11 @@ $ heroku apps:transfer --bulk acme-widgets
                 await new ConfirmCommand().confirm(appName, confirm, 'All collaborators will be removed from this app');
             }
             await appTransfer({
-                heroku: this.heroku,
                 appName,
-                recipient,
-                personalToPersonal: isValidEmail(recipient) && !isTeamApp(appInfo.owner?.email),
                 bulk,
+                heroku: this.heroku,
+                personalToPersonal: isValidEmail(recipient) && !isTeamApp(appInfo.owner?.email),
+                recipient,
             });
             if (locked) {
                 await AppsLock.run(['--app', appName], this.config);

package/lib/commands/apps/unlock.d.ts

@@ -1,11 +1,11 @@
 import { Command } from '@heroku-cli/command';
 export default class Unlock extends Command {
-    static topic: string;
-    static description: string;
     static aliases: string[];
+    static description: string;
     static flags: {
         app: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         remote: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
+    static topic: string;
     run(): Promise<void>;
 }