From 679941d8a1ad12f7020e71a7cc7e8d27150c415d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Richard=20Sol=C3=A1r?= <solar.richard@gmail.com>
Date: Mon, 7 Sep 2026 11:51:04 +0200
Subject: [PATCH] fix(create): make the local-only source option say nothing is
 uploaded

The last `apify create` prompt asked "Where will the source code live?" and
labelled the Git-less path "Apify", which read as if the code went to the
platform right away. Renames it "Local only", rewords the question, and states
in each option description what happens on selection.

Closes #1396

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
---
 docs/quick-start.md             |  1 +
 docs/reference.md               | 12 +++++++-----
 src/commands/create.ts          |  7 ++++---
 src/lib/git-source/gitSource.ts | 24 ++++++++++++++++--------
 4 files changed, 28 insertions(+), 16 deletions(-)

diff --git a/docs/quick-start.md b/docs/quick-start.md
index 60b0dadf2..4758001b9 100644
--- a/docs/quick-start.md
+++ b/docs/quick-start.md
@@ -24,6 +24,7 @@ The CLI then asks you for the following:
 1. Select a type of Actor to create:  web scraper, AI agent, API and data pipeline, or browser automation. Let's choose **web scraper**.
 1. Choose the programming language: JavaScript, TypeScript, or Python. Let's choose **JavaScript**.
 1. Based on your choice, the CLI suggests Actor templates. For this tutorial, let's choose **Crawlee and Cheerio**.
+1. Choose how the source code is set up: local only, or hosted on GitHub, GitLab, or Bitbucket. Let's choose **Local only**, which keeps everything on this machine.
 
 :::tip Explore Actor templates
 
diff --git a/docs/reference.md b/docs/reference.md
index c4591a868..011f4d473 100644
--- a/docs/reference.md
+++ b/docs/reference.md
@@ -315,11 +315,13 @@ FLAGS
                                  dependencies.
       --skip-git-init            Skip initializing a git
                                  repository in the Actor directory.
-      --source=<option>          Where the Actor source
-                                 code will live. With a Git provider, Apify creates
-                                 the repository on your connected account from the
-                                 template, clones it here, and creates an Actor that
-                                 builds from it.
+      --source=<option>          How the Actor source
+                                 code is set up. "apify" keeps everything on this
+                                 machine and uploads nothing, so you deploy it with
+                                 "apify push". With a Git provider, Apify creates a
+                                 private repository on your connected account from
+                                 the template, clones it into the Actor directory,
+                                 and creates an Actor that builds from it.
                                  <options: apify|github|gitlab|bitbucket>
   -t, --template=<value>         Template for the
                                  Actor. If not provided, the command will prompt for
diff --git a/src/commands/create.ts b/src/commands/create.ts
index 1e4f05183..7a3a198f7 100644
--- a/src/commands/create.ts
+++ b/src/commands/create.ts
@@ -70,11 +70,12 @@ export class CreateCommand extends ApifyCommand<typeof CreateCommand> {
 	static override interactive = true;
 
 	static override interactiveNote =
-		'Prompts for an Actor name, then guides you through what you want to build, a language, a template, and where the source code lives when they are not provided. To run non-interactively, pass the name and --template; --source defaults to "apify". Use --use-case and --language to narrow the template list.';
+		'Prompts for an Actor name, then guides you through what you want to build, a language, a template, and how the source code is set up when they are not provided. To run non-interactively, pass the name and --template; --source defaults to "apify". Use --use-case and --language to narrow the template list.';
 
 	static override examples = [
 		{
-			description: 'Create a new Actor project interactively (guided name, use case, language, and template prompts).',
+			description:
+				'Create a new Actor project interactively, with guided prompts for the name, use case, language, template, and source.',
 			command: 'apify create',
 		},
 		{
@@ -140,7 +141,7 @@ export class CreateCommand extends ApifyCommand<typeof CreateCommand> {
 		}),
 		source: Flags.string({
 			description:
-				'Where the Actor source code will live. With a Git provider, Apify creates the repository on your connected account from the template, clones it here, and creates an Actor that builds from it.',
+				'How the Actor source code is set up. "apify" keeps everything on this machine and uploads nothing, so you deploy it with "apify push". With a Git provider, Apify creates a private repository on your connected account from the template, clones it into the Actor directory, and creates an Actor that builds from it.',
 			choices: [...GIT_SOURCE_CHOICES],
 			// No default: an omitted flag triggers the wizard prompt, or "apify" when it cannot be asked.
 			required: false,
diff --git a/src/lib/git-source/gitSource.ts b/src/lib/git-source/gitSource.ts
index 4239dc826..fcd7385cd 100644
--- a/src/lib/git-source/gitSource.ts
+++ b/src/lib/git-source/gitSource.ts
@@ -15,7 +15,7 @@ import type { AuthJSON } from '../types.js';
 import { cliDebugPrint } from '../utils/cliDebugPrint.js';
 import { CONNECT_TIMEOUT_MS, connectViaConsole } from './connectViaConsole.js';
 
-/** Where a new Actor's source code lives. `apify` is the existing, Git-less path. */
+/** How a new Actor's source code is set up. `apify` is the Git-less path: the code stays on this machine. */
 export const GIT_SOURCE_CHOICES = ['apify', 'github', 'gitlab', 'bitbucket'] as const;
 export type GitSource = (typeof GIT_SOURCE_CHOICES)[number];
 export type GitProvider = Exclude<GitSource, 'apify'>;
@@ -150,14 +150,22 @@ export const getAddWorkspaceUrl = (provider: GitProvider, account?: GitAccount):
 /** Final wizard step, mirroring the Console. Skipped when `--source` is passed. */
 export const promptGitSource = async (): Promise<GitSource> =>
 	useSelectFromList<GitSource>({
-		message: 'Where will the source code live?',
+		message: 'How do you want to set up the source code?',
 		choices: [
-			{ name: 'Apify', value: 'apify', description: 'Deploy with "apify push". No Git provider involved.' },
-			...GIT_SOURCE_CHOICES.filter(isGitProvider).map((provider) => ({
-				name: GIT_PROVIDERS[provider].label,
-				value: provider,
-				description: `Apify creates a private repository on ${GIT_PROVIDERS[provider].label} and builds the Actor from it.`,
-			})),
+			{
+				name: 'Local only',
+				value: 'apify',
+				description: 'Everything stays on this machine and nothing is uploaded. Deploy with "apify push".',
+			},
+			...GIT_SOURCE_CHOICES.filter(isGitProvider).map((provider) => {
+				const { label } = GIT_PROVIDERS[provider];
+
+				return {
+					name: `Host on ${label}`,
+					value: provider,
+					description: `Apify creates a private repository on ${label}, clones it into the Actor directory, and creates an Actor that builds from it.`,
+				};
+			}),
 		],
 		default: 'apify',
 		loop: false,