feat(deploy): add --url flag and unattended mode support

Add --url flag to `sanity deploy` that works for both external and
internal studios. For external deploys it passes the full URL directly.
For internal deploys it strips the .sanity.studio suffix if present.
The flag takes precedence over the studioHost config value.

When --yes (unattended mode) is used without --url or studioHost, the
command now errors with a helpful message instead of hanging on an
interactive prompt.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: rexxars

packages/@sanity/cli/src/actions/deploy/deployStudio.ts

@@ -3,6 +3,7 @@ import {styleText} from 'node:util'
 import {createGzip, type Gzip} from 'node:zlib'
 
 import {CLIError} from '@oclif/core/errors'
+import {type Output} from '@sanity/cli-core'
 import {spinner} from '@sanity/cli-core/ux'
 import {type StudioManifest} from 'sanity'
 import {pack} from 'tar-fs'
@@ -21,14 +22,14 @@ import {deployDebug} from './deployDebug.js'
 import {deployStudioSchemasAndManifests} from './deployStudioSchemasAndManifests.js'
 import {findUserApplicationForStudio} from './findUserApplicationForStudio.js'
 import {type DeployAppOptions} from './types.js'
+import {normalizeUrl, validateUrl} from './urlUtils.js'
 
 export async function deployStudio(options: DeployAppOptions) {
   const {cliConfig, flags, output, projectRoot, sourceDir} = options
 
   const workDir = projectRoot.directory
   const configPath = projectRoot.path
 
-  const appHost = cliConfig.studioHost
   const appId = getAppId(cliConfig)
   const projectId = cliConfig.api?.projectId
   const installedSanityVersion = await getLocalPackageVersion('sanity', workDir)
@@ -37,6 +38,9 @@ export async function deployStudio(options: DeployAppOptions) {
   const isExternal = !!flags.external
   const urlType: 'external' | 'internal' = isExternal ? 'external' : 'internal'
 
+  // Resolve the app host from --url flag (takes precedence) or studioHost config
+  const appHost = resolveAppHost({flags, isExternal, output, studioHost: cliConfig.studioHost})
+
   if (!installedSanityVersion) {
     output.error(`Failed to find installed sanity version`, {exit: 1})
     return
@@ -55,10 +59,22 @@ export async function deployStudio(options: DeployAppOptions) {
       appId,
       output,
       projectId,
+      unattended: !!flags.yes,
       urlType,
     })
 
     if (!userApplication) {
+      if (flags.yes) {
+        const flagHint = isExternal
+          ? 'Use --url to specify the external studio URL'
+          : 'Use --url to specify the studio hostname'
+        output.error(
+          `Cannot prompt for ${isExternal ? 'external studio URL' : 'studio hostname'} in unattended mode. ${flagHint}.`,
+          {exit: 1},
+        )
+        return
+      }
+
       if (isExternal) {
         output.log('Your project has not been registered with an external studio URL.')
         output.log('Please enter the full URL where your studio is hosted.')
@@ -181,3 +197,33 @@ export default defineCliConfig({
     output.error(`Error deploying studio: ${error}`, {exit: 1})
   }
 }
+
+function resolveAppHost({
+  flags,
+  isExternal,
+  output,
+  studioHost,
+}: {
+  flags: DeployAppOptions['flags']
+  isExternal: boolean
+  output: Output
+  studioHost: string | undefined
+}): string | undefined {
+  const url = flags.url
+  if (!url) {
+    return studioHost
+  }
+
+  if (isExternal) {
+    const normalized = normalizeUrl(url)
+    const validation = validateUrl(normalized)
+    if (validation !== true) {
+      output.error(validation, {exit: 1})
+      return undefined
+    }
+    return normalized
+  }
+
+  // For internal deploys, strip .sanity.studio suffix if present
+  return url.replace(/\.sanity\.studio\/?$/i, '')
+}

packages/@sanity/cli/src/actions/deploy/findUserApplicationForStudio.ts

@@ -20,11 +20,12 @@ interface FindUserApplicationForStudioOptions {
 
   appHost?: string
   appId?: string
+  unattended?: boolean
   urlType?: 'external' | 'internal'
 }
 
 export async function findUserApplicationForStudio(options: FindUserApplicationForStudioOptions) {
-  const {appHost, appId, output, projectId, urlType = 'internal'} = options
+  const {appHost, appId, output, projectId, unattended = false, urlType = 'internal'} = options
 
   const spin = spinner('Checking project info').start()
 
@@ -63,6 +64,19 @@ export async function findUserApplicationForStudio(options: FindUserApplicationF
     return null
   }
 
+  // In unattended mode, we can't prompt the user to select a studio
+  if (unattended) {
+    const flagHint =
+      urlType === 'external'
+        ? 'Use --url to specify the external studio URL'
+        : 'Use --url to specify the studio hostname'
+    output.error(
+      `Multiple studios found for this project. Cannot select in unattended mode. ${flagHint}.`,
+      {exit: 1},
+    )
+    return
+  }
+
   // If there are user applications, allow the user to select one of the existing host names,
   // or to create a new one
   const newLabel =