diff --git a/apps/cli-go/cmd/branches.go b/apps/cli-go/cmd/branches.go
index fee85fccb..62c69280c 100644
--- a/apps/cli-go/cmd/branches.go
+++ b/apps/cli-go/cmd/branches.go
@@ -78,8 +78,9 @@ var (
 	branchGetCmd = &cobra.Command{
 		Use:   "get [name]",
 		Short: "Retrieve details of a preview branch",
-		Long:  "Retrieve details of the specified preview branch.",
-		Args:  cobra.MaximumNArgs(1),
+		Long: "Retrieve details of the specified preview branch.\n\n" +
+			"Note: For the main branch, password-dependent fields (POSTGRES_URL, POSTGRES_URL_NON_POOLING) are not populated because production database credentials are not retrievable via API.",
+		Args: cobra.MaximumNArgs(1),
 		RunE: func(cmd *cobra.Command, args []string) error {
 			ctx := cmd.Context()
 			fsys := afero.NewOsFs()
diff --git a/apps/cli/src/legacy/commands/branches/get/get.command.ts b/apps/cli/src/legacy/commands/branches/get/get.command.ts
index 059f5ba66..f2632740f 100644
--- a/apps/cli/src/legacy/commands/branches/get/get.command.ts
+++ b/apps/cli/src/legacy/commands/branches/get/get.command.ts
@@ -16,7 +16,10 @@ const config = {
 export type LegacyBranchesGetFlags = CliCommand.Command.Config.Infer<typeof config>;
 
 export const legacyBranchesGetCommand = Command.make("get", config).pipe(
-  Command.withDescription("Retrieve details of the specified preview branch."),
+  Command.withDescription(
+    "Retrieve details of the specified preview branch.\n\n" +
+      "Note: For the main branch, password-dependent fields (POSTGRES_URL, POSTGRES_URL_NON_POOLING) are not populated because production database credentials are not retrievable via API.",
+  ),
   Command.withShortDescription("Retrieve details of a preview branch"),
   Command.withHandler((flags) => legacyBranchesGet(flags)),
 );