docs: shrink width of generated docs (#899)

Author: vladfrangu

docs/reference.md

@@ -3,7 +3,7 @@ import type { CommandsInCategory } from './documentation-renderer/doc-building.j
 import { renderDocs } from './documentation-renderer/doc-building.js';
 
 // This sets the maximum line length that will be rendered in the docs.
-process.env.APIFY_CLI_MAX_LINE_WIDTH = '150';
+process.env.APIFY_CLI_MAX_LINE_WIDTH = '80';
 
 const categories: Record<string, CommandsInCategory[]> = {
 	'auth': [

scripts/generate-cli-docs.ts

@@ -40,9 +40,7 @@ export class CreateCommand extends ApifyCommand<typeof CreateCommand> {
 	static override flags = {
 		template: Flags.string({
 			char: 't',
-			description:
-				'Template for the Actor. If not provided, the command will prompt for it.\n' +
-				`Visit ${manifestUrl} to find available template names.`,
+			description: `Template for the Actor. If not provided, the command will prompt for it. Visit ${manifestUrl} to find available template names.`,
 			required: false,
 		}),
 		'skip-dependency-install': Flags.boolean({

src/commands/create.ts

@@ -56,12 +56,12 @@ export class LoginCommand extends ApifyCommand<typeof LoginCommand> {
 	static override flags = {
 		token: Flags.string({
 			char: 't',
-			description: '[Optional] Apify API token',
+			description: 'Apify API token',
 			required: false,
 		}),
 		method: Flags.string({
 			char: 'm',
-			description: '[Optional] Method of logging in to Apify',
+			description: 'Method of logging in to Apify',
 			choices: ['console', 'manual'],
 			required: false,
 		}),

src/commands/login.ts

@@ -10,16 +10,14 @@ export class SecretsIndexCommand extends ApifyCommand<typeof SecretsIndexCommand
 		`Manages secure environment variables for Actors.\n\n` +
 		`Example:\n` +
 		`$ apify secrets add mySecret TopSecretValue123\n\n` +
-		`The "mySecret" value can be used in an environment variable defined in '${LOCAL_CONFIG_PATH}' file by adding the "@"\n` +
-		`prefix:\n\n` +
+		`The "mySecret" value can be used in an environment variable defined in '${LOCAL_CONFIG_PATH}' file by adding the "@" prefix:\n\n` +
 		`{\n` +
 		`  "actorSpecification": 1,\n` +
 		`  "name": "my_actor",\n` +
 		`  "environmentVariables": { "SECRET_ENV_VAR": "@mySecret" },\n` +
 		`  "version": "0.1"\n` +
 		`}\n\n` +
-		`When the Actor is pushed to Apify cloud, the "SECRET_ENV_VAR" and its value is stored as a secret environment variable\n` +
-		`of the Actor.`;
+		`When the Actor is pushed to Apify cloud, the "SECRET_ENV_VAR" and its value is stored as a secret environment variable of the Actor.`;
 
 	static override subcommands = [SecretsAddCommand, SecretsRmCommand];
 

src/commands/secrets/_index.ts

@@ -13,12 +13,12 @@ export class ValidateInputSchemaCommand extends ApifyCommand<typeof ValidateInpu
 	static override name = 'validate-schema' as const;
 
 	static override description = `Validates Actor input schema from one of these locations (in priority order):
-		1. Object in '${LOCAL_CONFIG_PATH}' under "input" key
-		2. JSON file path in '${LOCAL_CONFIG_PATH}' "input" key
-		3. .actor/INPUT_SCHEMA.json
-		4. INPUT_SCHEMA.json
+  1. Object in '${LOCAL_CONFIG_PATH}' under "input" key
+  2. JSON file path in '${LOCAL_CONFIG_PATH}' "input" key
+  3. .actor/INPUT_SCHEMA.json
+  4. INPUT_SCHEMA.json
 
-		Optionally specify custom schema path to validate.`;
+Optionally specify custom schema path to validate.`;
 
 	static override args = {
 		path: Args.string({

src/commands/validate-schema.ts

@@ -271,7 +271,7 @@ export class CommandHelp extends BaseCommandRenderer {
 			linesOfFlags.set(stringParts.join(' '), flag);
 		}
 
-		const widestFlagNameLength = widestLine([...linesOfFlags.keys()].join('\n'));
+		const widestFlagNameLength = widestLine([...linesOfFlags.keys()].map(stripAnsi).join('\n'));
 
 		for (const [flagString, flag] of linesOfFlags) {
 			const paddingToAdd = widestFlagNameLength - stripAnsi(flagString).length;

src/lib/command-framework/help/CommandHelp.ts

@@ -0,0 +1,96 @@
+---
+title: Changelog
+sidebar_label: Changelog
+toc_max_heading_level: 3
+---
+
+### [1.1.2-beta.0](https://github.com/apify/apify-cli/releases/tag/v1.1.2-beta.0)
+
+### [1.1.1](https://github.com/apify/apify-cli/releases/tag/v1.1.1)
+
+##### [1.1.1](https://github.com/apify/apify-cli/releases/tag/v1.1.1) (2025-08-18)
+
+###### 🐛 Bug Fixes
+
+- Unknown errors from tracking ([#895](https://github.com/apify/apify-cli/pull/895)) ([3485f36](https://github.com/apify/apify-cli/commit/3485f366f3a62117ac833e78157c230206c3c60e)) by [@vladfrangu](https://github.com/vladfrangu)
+- Upgrade command should always check when manually ran ([#897](https://github.com/apify/apify-cli/pull/897)) ([5e0ea9f](https://github.com/apify/apify-cli/commit/5e0ea9ff84012732ca7117d1f68207b5170ffeed)) by [@vladfrangu](https://github.com/vladfrangu)
+
+### [1.1.1-beta.3](https://github.com/apify/apify-cli/releases/tag/v1.1.1-beta.3)
+
+### [1.1.1-beta.2](https://github.com/apify/apify-cli/releases/tag/v1.1.1-beta.2)
+
+### [1.1.1-beta.1](https://github.com/apify/apify-cli/releases/tag/v1.1.1-beta.1)
+
+### [1.1.1-beta.0](https://github.com/apify/apify-cli/releases/tag/v1.1.1-beta.0)
+
+### [1.1.0](https://github.com/apify/apify-cli/releases/tag/v1.1.0)
+
+##### [1.1.0](https://github.com/apify/apify-cli/releases/tag/v1.1.0) (2025-08-13)
+
+###### 🚀 Features
+
+- Upgrade command, install shell script ([#810](https://github.com/apify/apify-cli/pull/810)) ([51ef00a](https://github.com/apify/apify-cli/commit/51ef00ad32a6835c48781b99c6233113cf58d8a4)) by [@vladfrangu](https://github.com/vladfrangu)
+- \[**breaking**] Make storage purging default, add `--resurrect` ([#729](https://github.com/apify/apify-cli/pull/729)) ([8dff93a](https://github.com/apify/apify-cli/commit/8dff93a2d769997a96d4a7750fb36c2770b9a61c)) by [@vladfrangu](https://github.com/vladfrangu)
+- Handle sub-schema validation ([#853](https://github.com/apify/apify-cli/pull/853)) ([5fc2a2f](https://github.com/apify/apify-cli/commit/5fc2a2f6b780a86a250b69375455f3bb2e9a8983)) by [@MFori](https://github.com/MFori)
+- Upgrade command upgrading CLI + install command ([#856](https://github.com/apify/apify-cli/pull/856)) ([4252e6c](https://github.com/apify/apify-cli/commit/4252e6cb681deb5f92c654520d0ed03b70e426c3)) by [@vladfrangu](https://github.com/vladfrangu)
+- Add signature to KV store URLs where required ([#875](https://github.com/apify/apify-cli/pull/875)) ([a1e9982](https://github.com/apify/apify-cli/commit/a1e998270b5c05cd91280efa144325e2d7a7de0e)) by [@danpoletaev](https://github.com/danpoletaev)
+
+###### 🐛 Bug Fixes
+
+- Pretty message for invalid choices ([#805](https://github.com/apify/apify-cli/pull/805)) ([57bd5de](https://github.com/apify/apify-cli/commit/57bd5de9bc5289f151a9083533dc3d2c71f8b9ab)) by [@vladfrangu](https://github.com/vladfrangu)
+- Shebangs ([#806](https://github.com/apify/apify-cli/pull/806)) ([1cdc101](https://github.com/apify/apify-cli/commit/1cdc1011f36974708ab91a25d4d6c6a5dc43d989)) by [@vladfrangu](https://github.com/vladfrangu)
+- Recognize sh files as text files ([#813](https://github.com/apify/apify-cli/pull/813)) ([ef3e9b0](https://github.com/apify/apify-cli/commit/ef3e9b064483c04cd7bef2143a19e1a6992ddcff)) by [@DaveHanns](https://github.com/DaveHanns)
+- **init:** Prompt for a name if an old config does not exist ([#836](https://github.com/apify/apify-cli/pull/836)) ([26fcd66](https://github.com/apify/apify-cli/commit/26fcd660a0f7b4adb4e1a3329705a8ff6d8f43b2)) by [@vladfrangu](https://github.com/vladfrangu)
+- Pass apify client down to output job log wherever possible ([#839](https://github.com/apify/apify-cli/pull/839)) ([5cdb06c](https://github.com/apify/apify-cli/commit/5cdb06c0e24c2501b2034dbb7339798985b269cc)) by [@vladfrangu](https://github.com/vladfrangu)
+- **pull:** Handle private actors correctly ([#865](https://github.com/apify/apify-cli/pull/865)) ([efd7308](https://github.com/apify/apify-cli/commit/efd730855f99a36091ce51d501e5755b5ad79ffb)) by [@vladfrangu](https://github.com/vladfrangu)
+
+###### Chore
+
+- \[**breaking**] Move from yargs to node:util ([#871](https://github.com/apify/apify-cli/pull/871)) ([482d0b2](https://github.com/apify/apify-cli/commit/482d0b29f285c020320f1f2e3f0fd08a362d57cc)) by [@vladfrangu](https://github.com/vladfrangu)
+- \[**breaking**] Make opening the actor build results in push opt-in ([#881](https://github.com/apify/apify-cli/pull/881)) ([d842424](https://github.com/apify/apify-cli/commit/d84242421387a9487eef5c07183dd0b8ac7ae67b)) by [@vladfrangu](https://github.com/vladfrangu)
+
+### [0.21.10-beta.25](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.25)
+
+### [0.21.10-beta.24](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.24)
+
+### [0.21.10-beta.23](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.23)
+
+### [0.21.10-beta.22](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.22)
+
+### [0.21.10-beta.21](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.21)
+
+### [0.21.10-beta.20](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.20)
+
+### [0.21.10-beta.19](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.19)
+
+### [0.21.10-beta.18](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.18)
+
+### [0.21.10-beta.17](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.17)
+
+### [0.21.10-beta.16](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.16)
+
+### [0.21.10-beta.15](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.15)
+
+### [0.21.10-beta.14](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.14)
+
+### [0.21.10-beta.13](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.13)
+
+### [0.21.10-beta.12](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.12)
+
+### [0.21.10-beta.11](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.11)
+
+### [0.21.10-beta.9](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.9)
+
+### [0.21.10-beta.10](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.10)
+
+### [0.21.10-beta.8](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.8)
+
+### [0.21.10-beta.7](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.7)
+
+### [0.21.10-beta.6](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.6)
+
+### [0.21.10-beta.5](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.5)
+
+### [0.21.10-beta.4](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.4)
+
+### [0.21.10-beta.3](https://github.com/apify/apify-cli/releases/tag/v0.21.10-beta.3)