twentythree-cli 1.0.1 → 1.1.1

package/dist/commands/app/list.cjs

@@ -0,0 +1,87 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+//#region src/commands/app/list.ts
+/**
+* App list command — returns paginated list of player design apps on the workspace.
+*/
+var AppList = class AppList extends require_lib_base_command.AuthenticatedCommand {
+	static description = "List player design apps on the active workspace";
+	static examples = [
+		"<%= config.bin %> app list",
+		"<%= config.bin %> app list --app-id 42",
+		"<%= config.bin %> app list --page 2 --size 50",
+		"<%= config.bin %> app list --json"
+	];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "POST /app/list",
+		auth_scope: "read",
+		output_shape: {
+			type: "table",
+			columns: [
+				"ID",
+				"Name",
+				"Type",
+				"Description"
+			]
+		},
+		side_effects: "none"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"app-id": _oclif_core.Flags.integer({
+			description: "Filter results to a specific app ID",
+			required: false
+		}),
+		page: _oclif_core.Flags.integer({
+			description: "Page offset",
+			required: false
+		}),
+		size: _oclif_core.Flags.integer({
+			description: "Number of results per page (default 20, max 100)",
+			required: false
+		})
+	};
+	static args = {};
+	async run() {
+		const { flags } = await this.parse(AppList);
+		this.printWorkspaceHeader();
+		const body = {};
+		if (flags["app-id"] !== void 0) body.app_id = flags["app-id"];
+		if (flags.page !== void 0) body.p = flags.page;
+		if (flags.size !== void 0) body.size = flags.size;
+		const { data, error } = await this.apiClient.POST("/app/list", {
+			body,
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
+		const apps = data?.apps ?? data?.data ?? [];
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data: apps,
+			summary: "App list",
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, { resource: "app" }]
+		});
+		if (apps.length === 0) {
+			this.log("No apps found.");
+			return;
+		}
+		const table = require_lib_output.renderTable([
+			"ID",
+			"Name",
+			"Type",
+			"Description"
+		], apps.map((a) => [
+			String(a.app_id ?? a.id ?? ""),
+			String(a.name ?? ""),
+			String(a.type ?? ""),
+			String(a.description ?? "")
+		]));
+		this.log(table.toString());
+	}
+};
+//#endregion
+module.exports = AppList;

package/dist/commands/app/remove-thumbnail.cjs

@@ -0,0 +1,51 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/app/remove-thumbnail.ts
+/**
+* App remove-thumbnail command — removes the custom thumbnail for an app, reverting to default.
+*
+* Threat mitigations:
+*   T-08-05: extends AuthenticatedCommand — anonymous mode rejected
+*/
+var AppRemoveThumbnail = class AppRemoveThumbnail extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Remove the custom thumbnail for an app, reverting to the default";
+	static examples = ["<%= config.bin %> app remove-thumbnail 42", "<%= config.bin %> app remove-thumbnail 42 --json"];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "POST /app/remove-thumbnail",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "updates"
+	};
+	static flags = { ...require_lib_base_command.AuthenticatedCommand.baseFlags };
+	static args = { id: _oclif_core.Args.string({
+		description: "App ID",
+		required: true
+	}) };
+	async run() {
+		const { args } = await this.parse(AppRemoveThumbnail);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.POST("/app/remove-thumbnail", {
+			body: { app_id: Number(args.id) },
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
+		this.log(chalk.default.green(`Thumbnail removed for app ${args.id}`));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data,
+			summary: `Thumbnail removed for app ${args.id}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "app",
+				id: args.id
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = AppRemoveThumbnail;

package/dist/commands/app/set-thumbnail.cjs

@@ -0,0 +1,78 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../lib/term-map.cjs");
+const require_lib_base_command = require("../../lib/base-command.cjs");
+const require_lib_output = require("../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+//#region src/commands/app/set-thumbnail.ts
+/**
+* App set-thumbnail command — uploads and sets a custom thumbnail image for an app.
+*
+* Uses direct multipart POST with bodySerializer to create FormData.
+* Per D-3: NOT the chunked engine — thumbnail images use direct multipart upload.
+*
+* Threat mitigations:
+*   T-08-08: Validates file exists via fs.existsSync before reading
+*   T-08-05: extends AuthenticatedCommand — anonymous mode rejected
+*/
+var AppSetThumbnail = class AppSetThumbnail extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Upload and set a custom thumbnail image for an app";
+	static examples = ["<%= config.bin %> app set-thumbnail ./thumbnail.png --app-id 42", "<%= config.bin %> app set-thumbnail ./thumbnail.jpg --app-id 42 --json"];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "POST /app/set-thumbnail",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "updates"
+	};
+	static flags = {
+		...require_lib_base_command.AuthenticatedCommand.baseFlags,
+		"app-id": _oclif_core.Flags.integer({
+			description: "App ID to update",
+			required: true
+		})
+	};
+	static args = { file: _oclif_core.Args.string({
+		description: "Path to the thumbnail image file",
+		required: true
+	}) };
+	async run() {
+		const { args, flags } = await this.parse(AppSetThumbnail);
+		this.printWorkspaceHeader();
+		const filePath = node_path.resolve(args.file);
+		if (!node_fs.existsSync(filePath)) this.error(`File not found: ${filePath}`, { exit: 1 });
+		const fileBuffer = node_fs.readFileSync(filePath);
+		const fileName = node_path.basename(filePath);
+		const fileBlob = new Blob([fileBuffer]);
+		const { data, error } = await this.apiClient.POST("/app/set-thumbnail", {
+			body: {
+				app_id: flags["app-id"],
+				file: fileBlob
+			},
+			bodySerializer(body) {
+				const fd = new FormData();
+				for (const [k, v] of Object.entries(body)) if (v !== void 0) if (v instanceof Blob) fd.append(k, v, fileName);
+				else fd.append(k, String(v));
+				return fd;
+			}
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
+		this.log(chalk.default.green(`Thumbnail set for app ${flags["app-id"]}`));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data,
+			summary: `Thumbnail set for app ${flags["app-id"]}`,
+			breadcrumbs: [{ domain: this.activeWorkspace.domain }, {
+				resource: "app",
+				id: String(flags["app-id"])
+			}]
+		});
+	}
+};
+//#endregion
+module.exports = AppSetThumbnail;

package/dist/commands/auth/credentials.cjs

@@ -40,13 +40,14 @@ var Credentials = class Credentials extends _oclif_core.Command {
 			require_auth_workspace_config.setCredentialDomain(domain);
 			const s = _clack_prompts.spinner();
 			s.start("Discovering workspaces...");
-			let workspaces;
+			let workspaces = [];
 			try {
 				workspaces = await require_auth_token_refresh.fetchWorkspaceTokens(domain, trimmedToken);
 				s.stop("Workspaces discovered");
 			} catch (err) {
 				s.stop("Failed to discover workspaces");
 				this.error(`Could not discover workspaces: ${err instanceof Error ? err.message : String(err)}`, { exit: 1 });
+				return;
 			}
 			let selectedWorkspaces;
 			if (workspaces.length > 1) {

package/dist/commands/autocomplete/index.cjs

@@ -0,0 +1,79 @@
+const require_runtime = require("../../_virtual/_rolldown/runtime.cjs");
+const require_lib_detect_shell = require("../../lib/detect-shell.cjs");
+let _oclif_core = require("@oclif/core");
+let _clack_prompts = require("@clack/prompts");
+_clack_prompts = require_runtime.__toESM(_clack_prompts);
+//#region src/commands/autocomplete/index.ts
+var Autocomplete = class Autocomplete extends _oclif_core.Command {
+	static description = "Set up tab completion for your shell";
+	static agentMetadata = {
+		api_endpoint: "interactive",
+		auth_scope: "none",
+		output_shape: { type: "none" },
+		side_effects: "creates"
+	};
+	static examples = ["<%= config.bin %> autocomplete"];
+	async run() {
+		await this.parse(Autocomplete);
+		_clack_prompts.intro("Tab completion setup");
+		const detectedShell = require_lib_detect_shell.detectShell(process.env.SHELL ?? "");
+		let shell;
+		if (detectedShell) {
+			const confirm = await _clack_prompts.confirm({ message: `Detected shell: ${detectedShell}. Set up completion for ${detectedShell}?` });
+			if (_clack_prompts.isCancel(confirm)) {
+				_clack_prompts.cancel("Cancelled");
+				return;
+			}
+			if (confirm) shell = detectedShell;
+			else {
+				const chosen = await _clack_prompts.select({
+					message: "Select your shell",
+					options: [{
+						value: "zsh",
+						label: "zsh"
+					}, {
+						value: "bash",
+						label: "bash"
+					}]
+				});
+				if (_clack_prompts.isCancel(chosen)) {
+					_clack_prompts.cancel("Cancelled");
+					return;
+				}
+				shell = chosen;
+			}
+		} else {
+			const chosen = await _clack_prompts.select({
+				message: "Select your shell",
+				options: [{
+					value: "zsh",
+					label: "zsh"
+				}, {
+					value: "bash",
+					label: "bash"
+				}]
+			});
+			if (_clack_prompts.isCancel(chosen)) {
+				_clack_prompts.cancel("Cancelled");
+				return;
+			}
+			shell = chosen;
+		}
+		const s = _clack_prompts.spinner();
+		s.start("Building completion cache...");
+		try {
+			await this.config.runCommand("autocomplete:create", []);
+			s.stop("Completion cache built");
+		} catch (err) {
+			s.stop("Failed to build completion cache");
+			this.error(`Could not build completion cache: ${err instanceof Error ? err.message : String(err)}`, { exit: 1 });
+			return;
+		}
+		const rcFile = shell === "zsh" ? "~/.zshrc" : "~/.bashrc";
+		const evalLine = `grep -qF 'twentythree autocomplete script ${shell}' ${rcFile} || printf "$(twentythree autocomplete script ${shell})" >> ${rcFile}; source ${rcFile}`;
+		_clack_prompts.note(`Add tab completion to your shell by running:\n\n  ${evalLine}\n\nThen restart your terminal or run: source ${rcFile}`, "Setup instructions");
+		_clack_prompts.outro("After setup, try: twentythree video <TAB>");
+	}
+};
+//#endregion
+module.exports = Autocomplete;

package/dist/commands/video/list.cjs

@@ -52,7 +52,7 @@ var VideoList = class VideoList extends require_lib_base_command.AuthenticatedCo
 	async run() {
 		const { flags } = await this.parse(VideoList);
 		this.printWorkspaceHeader();
-		const videos = await require_lib_pagination.fetchAllPages(async (page, size) => {
+		const allVideos = await require_lib_pagination.fetchAllPages(async (page, size) => {
 			const { data, error } = await this.apiClient.GET("/photo/list", { params: { query: {
 				p: page,
 				size,
@@ -65,6 +65,7 @@ var VideoList = class VideoList extends require_lib_base_command.AuthenticatedCo
 				total_count: resp?.total_count
 			};
 		});
+		const videos = flags.limit !== void 0 ? allVideos.slice(0, flags.limit) : allVideos;
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,
 			data: videos,

package/dist/commands/video/replace.cjs

@@ -81,7 +81,7 @@ var VideoReplace = class VideoReplace extends require_lib_base_command.Authentic
 			this.error(`File not found: ${args.file}`, { exit: 1 });
 		}
 		const { data: tokenData, error: tokenError } = await this.apiClient.GET("/photo/get-replace-token", { params: { query: { photo_id: Number(args.id) } } });
-		if (tokenError) this.error(require_lib_term_map.applyCliTerms(String(tokenError)), { exit: 1 });
+		if (tokenError) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(tokenError)), { exit: 1 });
 		const replaceToken = tokenData?.data?.replace_token;
 		if (!replaceToken) this.error("Failed to obtain replace token from API", { exit: 1 });
 		const totalBytes = (await (0, node_fs_promises.stat)(args.file)).size;
@@ -107,6 +107,7 @@ var VideoReplace = class VideoReplace extends require_lib_base_command.Authentic
 		} finally {
 			bar.finish();
 		}
+		if (!result) return;
 		const adminUrl = `https://${this.activeWorkspace.domain}/manage/video/${args.id}`;
 		this.log(chalk.default.green(`Video ${args.id} replaced successfully`));
 		this.log(`ID:    ${args.id}`);

package/dist/commands/video/section/generate.cjs

@@ -0,0 +1,54 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_lib_term_map = require("../../../lib/term-map.cjs");
+const require_lib_base_command = require("../../../lib/base-command.cjs");
+const require_lib_output = require("../../../lib/output.cjs");
+let _oclif_core = require("@oclif/core");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk);
+//#region src/commands/video/section/generate.ts
+/**
+* Video section generate command — AI-generates sections from a video transcript.
+*
+* Replaces all existing sections. Requires a transcript to be available.
+*/
+var VideoSectionGenerate = class VideoSectionGenerate extends require_lib_base_command.AuthenticatedCommand {
+	static description = "Automatically generate sections for a video using AI (requires transcript)";
+	static examples = ["<%= config.bin %> video section generate 12345", "<%= config.bin %> video section generate 12345 --json"];
+	static enableJsonFlag = true;
+	static agentMetadata = {
+		api_endpoint: "POST /photo/section/generate",
+		auth_scope: "write",
+		output_shape: { type: "key-value" },
+		side_effects: "creates"
+	};
+	static flags = { ...require_lib_base_command.AuthenticatedCommand.baseFlags };
+	static args = { id: _oclif_core.Args.string({
+		description: "Video ID",
+		required: true
+	}) };
+	async run() {
+		const { args } = await this.parse(VideoSectionGenerate);
+		this.printWorkspaceHeader();
+		const { data, error } = await this.apiClient.POST("/photo/section/generate", {
+			body: { photo_id: Number(args.id) },
+			headers: { "Content-Type": "application/x-www-form-urlencoded" }
+		});
+		if (error) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(error)), { exit: 1 });
+		this.log(chalk.default.green(`Sections generated for video ${args.id}`));
+		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
+			ok: true,
+			data,
+			summary: `Sections generated for video ${args.id}`,
+			breadcrumbs: [
+				{ domain: this.activeWorkspace.domain },
+				{
+					resource: "video",
+					id: args.id
+				},
+				{ resource: "section" }
+			]
+		});
+	}
+};
+//#endregion
+module.exports = VideoSectionGenerate;

package/dist/commands/video/update.cjs

@@ -146,9 +146,12 @@ var VideoUpdate = class VideoUpdate extends require_lib_base_command.Authenticat
 				initialValue: current.published_p ? "yes" : "no"
 			});
 			if ((0, _clack_prompts.isCancel)(publishedResult)) process.exit(2);
-			body.title = titleResult;
-			body.description = descriptionResult;
-			body.tags = tagsResult;
+			const titleVal = titleResult;
+			const descriptionVal = descriptionResult;
+			const tagsVal = tagsResult;
+			if (titleVal !== "") body.title = titleVal;
+			if (descriptionVal !== "" || current.content_text === "") body.description = descriptionVal;
+			if (tagsVal !== "" || currentTags === "") body.tags = tagsVal;
 			body.published_p = publishedResult === "yes" ? 1 : 0;
 		} else {
 			if (flags.title !== void 0) body.title = flags.title;
@@ -167,7 +170,7 @@ var VideoUpdate = class VideoUpdate extends require_lib_base_command.Authenticat
 			body,
 			headers: { "Content-Type": "application/x-www-form-urlencoded" }
 		});
-		if (updateError) this.error(require_lib_term_map.applyCliTerms(String(updateError)), { exit: 1 });
+		if (updateError) this.error(require_lib_term_map.applyCliTerms(require_lib_output.formatApiError(updateError)), { exit: 1 });
 		this.log(chalk.default.green(`Video ${args.id} updated`));
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,

package/dist/commands/webinar/mail/preview.cjs

@@ -49,7 +49,10 @@ var WebinarMailPreview = class WebinarMailPreview extends require_lib_base_comma
 		const { args, flags } = await this.parse(WebinarMailPreview);
 		this.printWorkspaceHeader();
 		const contextField = flags["webinar-id"] ? { live_id: Number(flags["webinar-id"]) } : flags["series-id"] ? { live_series_id: Number(flags["series-id"]) } : null;
-		if (!contextField) this.error(require_lib_term_map.applyCliTerms("Either --webinar-id or --series-id is required"), { exit: 1 });
+		if (!contextField) {
+			this.error(require_lib_term_map.applyCliTerms("Either --webinar-id or --series-id is required"), { exit: 1 });
+			return;
+		}
 		const query = new URLSearchParams({
 			...Object.fromEntries(Object.entries(contextField).map(([k, v]) => [k, String(v)])),
 			live_mail_id: String(args.id)
@@ -57,8 +60,18 @@ var WebinarMailPreview = class WebinarMailPreview extends require_lib_base_comma
 		const headers = {};
 		if (this.activeWorkspace.bearer_token) headers["Authorization"] = `Bearer ${this.activeWorkspace.bearer_token}`;
 		const response = await fetch(`${this.apiBaseUrl}live/mail/preview?${query}`, { headers });
-		const html = await response.text();
-		if (!response.ok) this.error(require_lib_term_map.applyCliTerms(`API error ${response.status}: ${html}`), { exit: 1 });
+		const body = await response.text();
+		if (!response.ok) {
+			let errMsg;
+			try {
+				const parsed = JSON.parse(body);
+				errMsg = parsed?.message ?? parsed?.error ?? `status ${response.status}`;
+			} catch {
+				errMsg = body.slice(0, 200) || `status ${response.status}`;
+			}
+			this.error(require_lib_term_map.applyCliTerms(`API error: ${errMsg}`), { exit: 1 });
+		}
+		const html = body;
 		if (this.jsonEnabled()) return require_lib_output.formatJsonOutput({
 			ok: true,
 			data: html,

package/dist/lib/base-command.cjs

@@ -7,6 +7,7 @@ let _oclif_core = require("@oclif/core");
 let chalk = require("chalk");
 chalk = require_runtime.__toESM(chalk);
 let _clack_prompts = require("@clack/prompts");
+_clack_prompts = require_runtime.__toESM(_clack_prompts);
 //#region src/lib/base-command.ts
 var BaseCommand = class extends _oclif_core.Command {
 	static enableJsonFlag = true;
@@ -71,7 +72,7 @@ var BaseCommand = class extends _oclif_core.Command {
 			const result = require_auth_workspace_config.findWorkspace(workspaceFlagValue, require_auth_workspace_config.getWorkspaces());
 			if (result === null) this.error(`No workspace matching '${workspaceFlagValue}' found — run \`twentythree workspace list\` to see available workspaces`, { exit: 1 });
 			else if (Array.isArray(result)) {
-				const chosen = await (0, _clack_prompts.select)({
+				const chosen = await _clack_prompts.select({
 					message: `Multiple workspaces match '${workspaceFlagValue}'. Select one:`,
 					options: result.map((w) => ({
 						value: w.domain,
@@ -79,7 +80,9 @@ var BaseCommand = class extends _oclif_core.Command {
 					}))
 				});
 				if (typeof chosen === "symbol") this.error("Workspace selection cancelled", { exit: 1 });
-				resolved = require_auth_workspace_config.getWorkspaceForDomain(chosen);
+				const found = require_auth_workspace_config.getWorkspaceForDomain(chosen);
+				if (!found) this.error(`Workspace '${chosen}' could not be resolved — try running \`twentythree workspace list\``, { exit: 1 });
+				resolved = found;
 			} else resolved = result;
 		} else {
 			const activeDomain = require_auth_workspace_config.getActiveWorkspace();
@@ -100,6 +103,31 @@ var BaseCommand = class extends _oclif_core.Command {
 			token: this.activeWorkspace.bearer_token || void 0
 		});
 	}
+	async catch(err) {
+		if (!process.stdin.isTTY) return super.catch(err);
+		if (err.constructor.name !== "FailedFlagValidationError") return super.catch(err);
+		const flagNames = [...err.message.matchAll(/Missing required flag ([^\n]+)/g)].map((m) => m[1]);
+		if (flagNames.length === 0) return super.catch(err);
+		const inputFlags = err.parse?.input?.flags ?? {};
+		_clack_prompts.intro("Missing required input");
+		const extraArgv = [];
+		for (const flagName of flagNames) {
+			const flagDef = inputFlags[flagName];
+			const label = flagDef?.description ?? flagDef?.summary ?? flagName;
+			const value = await _clack_prompts.text({
+				message: label,
+				validate: (v) => !v || v.trim().length === 0 ? "Value is required" : void 0
+			});
+			if (_clack_prompts.isCancel(value)) {
+				_clack_prompts.cancel("Cancelled");
+				throw new _oclif_core.Errors.CLIError("Cancelled", { exit: 0 });
+			}
+			extraArgv.push(`--${flagName}`, value);
+		}
+		_clack_prompts.outro("Running command...");
+		const newArgv = [...this.argv ?? [], ...extraArgv];
+		await this.config.runCommand(this.id, newArgv);
+	}
 	/**
 	* Print the [domain] workspace header in dim style.
 	* Call at the top of every command's run() method (AUTH-04).

package/dist/lib/detect-shell.cjs

@@ -0,0 +1,13 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/lib/detect-shell.ts
+/**
+* Detect shell from the $SHELL environment variable.
+* Returns 'zsh', 'bash', or null for unrecognized / unset shells.
+*/
+function detectShell(shellEnv) {
+	if (shellEnv.endsWith("zsh")) return "zsh";
+	if (shellEnv.endsWith("bash")) return "bash";
+	return null;
+}
+//#endregion
+exports.detectShell = detectShell;

package/docs/guides/getting-started.md

@@ -35,7 +35,21 @@ twentythree workspace list
 twentythree workspace use company.video23.com
 ```
 
-## Step 3: Run your first command
+## Step 3: Enable tab completion (optional)
+
+Run this once to set up `<TAB>` completion for all commands and flags:
+
+```bash
+twentythree autocomplete
+```
+
+The command detects your shell (bash or zsh), builds the completion cache, and shows the eval line to paste into your RC file. After sourcing your RC file or restarting your terminal, try:
+
+```bash
+twentythree video <TAB>
+```
+
+## Step 4: Run your first command
 
 List the videos in your active workspace.
 
@@ -64,3 +78,5 @@ Run `twentythree <topic> --help` for help on any topic. For example:
 twentythree video --help
 twentythree auth --help
 ```
+
+Use `<TAB>` after any command to discover subcommands and flags.