From a3e86c41156ee776757fb0f6fad654666d6c85a0 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 1/3] 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             |  2 +-
 docs/reference.md               | 12 +++++++-----
 src/commands/create.ts          |  7 ++++---
 src/lib/git-source/gitSource.ts | 24 ++++++++++++++++--------
 4 files changed, 28 insertions(+), 17 deletions(-)

diff --git a/docs/quick-start.md b/docs/quick-start.md
index 504c18872..4c6dc2259 100644
--- a/docs/quick-start.md
+++ b/docs/quick-start.md
@@ -31,7 +31,7 @@ The CLI then asks you for the following:
 
     :::
 
-1. Choose where to host the source code of your Actor: on Apify, GitHub, GitLab, or Bitbucket. Let's choose **Apify**.
+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.
 
 The CLI creates a new directory with the boilerplate code and installs all project dependencies.
 
diff --git a/docs/reference.md b/docs/reference.md
index e7cf2fb73..130cfeee7 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,

From 55a5f043ea342aaf8326a9a4c8dbd85d26178c5e Mon Sep 17 00:00:00 2001
From: Richard Solar <solar.richard@gmail.com>
Date: Tue, 15 Sep 2026 10:48:30 +0200
Subject: [PATCH 2/3] Update docs/quick-start.md

Co-authored-by: Edyta <142720610+szaganek@users.noreply.github.com>
---
 docs/quick-start.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/quick-start.md b/docs/quick-start.md
index 4c6dc2259..440a55929 100644
--- a/docs/quick-start.md
+++ b/docs/quick-start.md
@@ -31,7 +31,7 @@ The CLI then asks you for the following:
 
     :::
 
-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.
+1. Choose where to keep the source code of your Actor: on your machine, or hosted on GitHub, GitLab, or Bitbucket. Let's choose **Local only** so the code stays on your machine.
 
 The CLI creates a new directory with the boilerplate code and installs all project dependencies.
 

From ce36532de02e261afd96a2d402d8a1c21f7d3675 Mon Sep 17 00:00:00 2001
From: Richard Solar <solar.richard@gmail.com>
Date: Tue, 15 Sep 2026 10:49:03 +0200
Subject: [PATCH 3/3] Update src/commands/create.ts

Co-authored-by: Edyta <142720610+szaganek@users.noreply.github.com>
---
 src/commands/create.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/commands/create.ts b/src/commands/create.ts
index 7a3a198f7..4d695d6cb 100644
--- a/src/commands/create.ts
+++ b/src/commands/create.ts
@@ -141,7 +141,7 @@ export class CreateCommand extends ApifyCommand<typeof CreateCommand> {
 		}),
 		source: Flags.string({
 			description:
-				'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.',
+				'Where the Actor source code lives. With "apify", the code stays on your machine and nothing is uploaded. You can still deploy your Actor with "apify push". With a Git provider, Apify creates a private repository from the template on your connected account, clones the repository into the Actor directory, and builds the Actor from it.',
 			choices: [...GIT_SOURCE_CHOICES],
 			// No default: an omitted flag triggers the wizard prompt, or "apify" when it cannot be asked.
 			required: false,