@blinkdotnew/cli 0.3.7 → 0.4.1

package/src/commands/domains.ts

@@ -0,0 +1,211 @@
+import { Command } from 'commander'
+import { appRequest } from '../lib/api-app.js'
+import { requireToken } from '../lib/auth.js'
+import { requireProjectId } from '../lib/project.js'
+import { printJson, isJsonMode, withSpinner, printSuccess, printKv, createTable } from '../lib/output.js'
+import chalk from 'chalk'
+
+function printDomainRow(d: { id?: string; domain: string; verified?: boolean; dns_type?: string }) {
+  const status = d.verified ? chalk.green('verified') : chalk.yellow('pending')
+  return [d.id ?? '-', d.domain, status, d.dns_type ?? '-']
+}
+
+export function registerDomainsCommands(program: Command) {
+  const domains = program.command('domains')
+    .description('Custom domain management — add, verify, remove, purchase, and connect')
+    .addHelpText('after', `
+Manage custom domains for your Blink projects.
+Search and purchase domains directly, or connect existing ones.
+
+Examples:
+  $ blink domains list                       List domains on linked project
+  $ blink domains add example.com            Add a custom domain
+  $ blink domains verify dom_xxx             Trigger DNS verification
+  $ blink domains remove dom_xxx --yes       Remove a domain
+  $ blink domains search cool-app            Search available domains
+  $ blink domains purchase cool-app.com      Purchase a domain
+  $ blink domains my                         List your purchased domains
+  $ blink domains connect example.com        Connect a purchased domain to project
+`)
+
+  domains.command('list [project_id]')
+    .description('List all domains on a project')
+    .addHelpText('after', `
+Examples:
+  $ blink domains list                   List domains for linked project
+  $ blink domains list proj_xxx          List domains for specific project
+  $ blink domains list --json            Machine-readable output
+`)
+    .action(async (projectArg: string | undefined) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      const result = await withSpinner('Loading domains...', () =>
+        appRequest(`/api/project/${projectId}/domains`)
+      )
+      if (isJsonMode()) return printJson(result)
+      const items: Array<{ id?: string; domain: string; verified?: boolean; dns_type?: string }> = result?.domains ?? result ?? []
+      if (!items.length) { console.log(chalk.dim('(no domains — use `blink domains add <domain>`)'));return }
+      const table = createTable(['ID', 'Domain', 'Status', 'DNS'])
+      for (const d of items) table.push(printDomainRow(d))
+      console.log(table.toString())
+    })
+
+  domains.command('add <domain> [project_id]')
+    .description('Add a custom domain to a project')
+    .addHelpText('after', `
+Examples:
+  $ blink domains add example.com            Add to linked project
+  $ blink domains add example.com proj_xxx   Add to specific project
+`)
+    .action(async (domain: string, projectArg: string | undefined) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      const result = await withSpinner(`Adding ${domain}...`, () =>
+        appRequest(`/api/project/${projectId}/domains`, { body: { domain } })
+      )
+      if (isJsonMode()) return printJson(result)
+      printSuccess(`Domain ${domain} added`)
+      const domainId = result?.domain?.id ?? result?.id
+      if (domainId) printKv('Domain ID', domainId)
+      console.log(chalk.dim('Run `blink domains verify ' + (domainId ?? '<domain_id>') + '` after configuring DNS'))
+    })
+
+  registerDomainActions(domains)
+  registerGlobalDomainCommands(domains)
+}
+
+function registerDomainActions(domains: Command) {
+  domains.command('verify <domain_id> [project_id]')
+    .description('Trigger DNS verification for a domain')
+    .addHelpText('after', `
+Examples:
+  $ blink domains verify dom_xxx
+  $ blink domains verify dom_xxx proj_xxx
+`)
+    .action(async (domainId: string, projectArg: string | undefined) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      const result = await withSpinner('Verifying DNS...', () =>
+        appRequest(`/api/project/${projectId}/domains/${domainId}`, { method: 'POST' })
+      )
+      if (isJsonMode()) return printJson(result)
+      const verified = result?.hostname_status === 'active'
+      if (verified) printSuccess('Domain verified')
+      else console.log(chalk.yellow('!') + ' DNS not yet propagated — try again in a few minutes')
+    })
+
+  domains.command('remove <domain_id> [project_id]')
+    .description('Remove a domain from a project')
+    .option('--yes', 'Skip confirmation')
+    .addHelpText('after', `
+Examples:
+  $ blink domains remove dom_xxx --yes
+  $ blink domains remove dom_xxx proj_xxx
+`)
+    .action(async (domainId: string, projectArg: string | undefined, opts) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      if (!shouldSkipConfirm(opts)) {
+        const { confirm } = await import('@clack/prompts')
+        const ok = await confirm({ message: `Remove domain ${domainId}?` })
+        if (!ok) { console.log('Cancelled.'); return }
+      }
+      await withSpinner('Removing domain...', () =>
+        appRequest(`/api/project/${projectId}/domains/${domainId}`, { method: 'DELETE' })
+      )
+      if (isJsonMode()) return printJson({ status: 'ok', domain_id: domainId })
+      printSuccess('Domain removed')
+    })
+}
+
+function registerGlobalDomainCommands(domains: Command) {
+  domains.command('search <query>')
+    .description('Search available domains for purchase (no auth needed)')
+    .addHelpText('after', `
+Examples:
+  $ blink domains search cool-app
+  $ blink domains search my-startup --json
+`)
+    .action(async (query: string) => {
+      const result = await withSpinner('Searching domains...', () =>
+        appRequest(`/api/domains/search?q=${encodeURIComponent(query)}`)
+      )
+      if (isJsonMode()) return printJson(result)
+      const items: Array<{ domain: string; available?: boolean; price?: string }> = result?.results ?? result ?? []
+      if (!items.length) { console.log(chalk.dim('No results')); return }
+      const table = createTable(['Domain', 'Available', 'Price'])
+      for (const d of items) {
+        const avail = d.available ? chalk.green('yes') : chalk.red('no')
+        table.push([d.domain, avail, d.price ?? '-'])
+      }
+      console.log(table.toString())
+    })
+
+  // TODO: Purchase requires a multi-step flow (contact info, payment confirmation).
+  // Currently only sends domain + period — will fail without full contact details.
+  domains.command('purchase <domain>')
+    .description('Purchase a domain')
+    .option('--period <years>', 'Registration period in years', '1')
+    .addHelpText('after', `
+Examples:
+  $ blink domains purchase cool-app.com
+  $ blink domains purchase cool-app.com --period 2
+  $ blink domains purchase cool-app.com --json
+`)
+    .option('--yes', 'Skip confirmation')
+    .action(async (domain: string, opts) => {
+      requireToken()
+      if (!shouldSkipConfirm(opts)) {
+        const { confirm } = await import('@clack/prompts')
+        const ok = await confirm({ message: `Purchase ${domain} for ${opts.period} year(s)? This will charge your account.` })
+        if (!ok) { console.log('Cancelled.'); return }
+      }
+      const result = await withSpinner(`Purchasing ${domain}...`, () =>
+        appRequest('/api/domains/purchase', { body: { domain, period: Number(opts.period) } })
+      )
+      if (isJsonMode()) return printJson(result)
+      printSuccess(`Domain ${domain} purchased`)
+      if (result?.domain_id) printKv('Domain ID', result.domain_id)
+    })
+
+  domains.command('connect <domain> [project_id]')
+    .description('Connect a purchased domain to a project')
+    .addHelpText('after', `
+Examples:
+  $ blink domains connect example.com            Connect to linked project
+  $ blink domains connect example.com proj_xxx   Connect to specific project
+`)
+    .action(async (domain: string, projectArg: string | undefined) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      const result = await withSpinner(`Connecting ${domain}...`, () =>
+        appRequest('/api/domains/connect', { body: { domainId: domain, projectId } })
+      )
+      if (isJsonMode()) return printJson(result)
+      printSuccess(`${domain} connected to ${projectId}`)
+    })
+
+  domains.command('my')
+    .description('List your purchased domains')
+    .addHelpText('after', `
+Examples:
+  $ blink domains my
+  $ blink domains my --json
+`)
+    .action(async () => {
+      requireToken()
+      const result = await withSpinner('Loading your domains...', () =>
+        appRequest('/api/domains/my')
+      )
+      if (isJsonMode()) return printJson(result)
+      const items: Array<{ domain: string; status?: string; expiration_date?: string }> = result?.domains ?? result ?? []
+      if (!items.length) { console.log(chalk.dim('(no purchased domains)')); return }
+      const table = createTable(['Domain', 'Status', 'Expires'])
+      for (const d of items) table.push([d.domain, d.status ?? '-', d.expiration_date ?? '-'])
+      console.log(table.toString())
+    })
+}
+
+function shouldSkipConfirm(opts: { yes?: boolean }) {
+  return opts.yes || process.argv.includes('--yes') || process.argv.includes('-y') || isJsonMode() || !process.stdout.isTTY
+}

package/src/commands/env.ts

@@ -0,0 +1,215 @@
+import { Command } from 'commander'
+import { appRequest } from '../lib/api-app.js'
+import { requireToken } from '../lib/auth.js'
+import { requireProjectId } from '../lib/project.js'
+import { printJson, printSuccess, isJsonMode, withSpinner, createTable, printError } from '../lib/output.js'
+import { readFileSync, existsSync } from 'node:fs'
+import chalk from 'chalk'
+
+async function resolveSecretId(projectId: string, keyName: string): Promise<string> {
+  const result = await appRequest(`/api/projects/${projectId}/secrets`)
+  const secrets: Array<{ id: string; key: string }> = result?.secrets ?? result ?? []
+  const match = secrets.find(s => s.key === keyName)
+  if (!match) {
+    printError(`Env var "${keyName}" not found in project ${projectId}`)
+    process.exit(1)
+  }
+  return match.id
+}
+
+function parseEnvFile(filePath: string): Array<{ key: string; value: string }> {
+  if (!existsSync(filePath)) {
+    printError(`File not found: ${filePath}`)
+    process.exit(1)
+  }
+  const content = readFileSync(filePath, 'utf-8')
+  const entries: Array<{ key: string; value: string }> = []
+  for (const line of content.split('\n')) {
+    const trimmed = line.trim()
+    if (!trimmed || trimmed.startsWith('#')) continue
+    const eqIdx = trimmed.indexOf('=')
+    if (eqIdx === -1) continue
+    const key = trimmed.slice(0, eqIdx).trim()
+    let value = trimmed.slice(eqIdx + 1).trim()
+    if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+      value = value.slice(1, -1)
+    }
+    if (key) entries.push({ key, value })
+  }
+  return entries
+}
+
+export function registerEnvCommands(program: Command) {
+  const env = program.command('env')
+    .description('Manage project environment variables (secrets)')
+    .addHelpText('after', `
+Environment variables are encrypted key-value pairs for your project.
+They are injected at runtime in backend functions and edge workers.
+Use "env pull > .env.local" to export as a file.
+
+Note: For Claw agent secrets, use "blink secrets" instead.
+
+Examples:
+  $ blink env list                          List env vars
+  $ blink env set DATABASE_URL postgres://...
+  $ blink env delete OLD_KEY
+  $ blink env push .env                     Bulk import from .env file
+  $ blink env pull > .env.local             Export all vars to stdout
+`)
+
+  registerEnvList(env)
+  registerEnvSet(env)
+  registerEnvDelete(env)
+  registerEnvPush(env)
+  registerEnvPull(env)
+}
+
+function registerEnvList(env: Command) {
+  env.command('list [project_id]')
+    .description('List environment variables')
+    .addHelpText('after', `
+Examples:
+  $ blink env list                      List for linked project
+  $ blink env list proj_xxx             List for specific project
+  $ blink env list --json               Machine-readable output
+`)
+    .action(async (projectArg: string | undefined) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      const result = await withSpinner('Loading env vars...', () =>
+        appRequest(`/api/projects/${projectId}/secrets`)
+      )
+      if (isJsonMode()) return printJson(result)
+      const secrets: Array<{ key: string; value?: string }> = result?.secrets ?? result ?? []
+      if (!secrets.length) {
+        console.log(chalk.dim('(no env vars — use `blink env set KEY value`)'))
+        return
+      }
+      const table = createTable(['Key', 'Value'])
+      for (const s of secrets) table.push([chalk.bold(s.key), s.value ?? ''])
+      console.log(table.toString())
+      console.log(chalk.dim(`\n${secrets.length} variable${secrets.length === 1 ? '' : 's'}`))
+    })
+}
+
+function registerEnvSet(env: Command) {
+  env.command('set <key> <value>')
+    .description('Create or update an environment variable')
+    .option('--project <id>', 'Project ID (defaults to linked project)')
+    .addHelpText('after', `
+Examples:
+  $ blink env set DATABASE_URL postgres://user:pass@host/db
+  $ blink env set STRIPE_KEY sk_live_xxx
+  $ blink env set API_SECRET mysecret --project proj_xxx
+`)
+    .action(async (key: string, value: string, opts) => {
+      requireToken()
+      const projectId = requireProjectId(opts.project)
+      await withSpinner(`Setting ${key}...`, () =>
+        appRequest(`/api/projects/${projectId}/secrets`, {
+          method: 'POST',
+          body: { key, value },
+        })
+      )
+      if (isJsonMode()) return printJson({ status: 'ok', key, project_id: projectId })
+      printSuccess(`${key} saved to project ${projectId}`)
+    })
+}
+
+function registerEnvDelete(env: Command) {
+  env.command('delete <key>')
+    .description('Delete an environment variable')
+    .option('--project <id>', 'Project ID (defaults to linked project)')
+    .option('--yes', 'Skip confirmation')
+    .addHelpText('after', `
+Examples:
+  $ blink env delete OLD_KEY
+  $ blink env delete OLD_KEY --yes
+  $ blink env delete OLD_KEY --project proj_xxx
+`)
+    .action(async (key: string, opts) => {
+      requireToken()
+      const projectId = requireProjectId(opts.project)
+      const skipConfirm = opts.yes || process.argv.includes('--yes') || process.argv.includes('-y')
+      if (!skipConfirm && !isJsonMode() && process.stdout.isTTY) {
+        const { confirm } = await import('@clack/prompts')
+        const ok = await confirm({ message: `Delete env var "${key}" from project ${projectId}?` })
+        if (!ok) { console.log('Cancelled.'); return }
+      }
+      const secretId = await resolveSecretId(projectId, key)
+      await withSpinner(`Deleting ${key}...`, () =>
+        appRequest(`/api/projects/${projectId}/secrets/${secretId}`, { method: 'DELETE' })
+      )
+      if (isJsonMode()) return printJson({ status: 'ok', key, project_id: projectId })
+      printSuccess(`Deleted ${key}`)
+    })
+}
+
+function registerEnvPush(env: Command) {
+  env.command('push <file>')
+    .description('Bulk import environment variables from a .env file')
+    .option('--project <id>', 'Project ID (defaults to linked project)')
+    .option('--yes', 'Skip confirmation')
+    .addHelpText('after', `
+Reads KEY=VALUE pairs from the file and upserts each one.
+Lines starting with # and blank lines are skipped.
+
+Examples:
+  $ blink env push .env
+  $ blink env push .env.production --project proj_xxx
+  $ blink env push .env --yes
+`)
+    .action(async (file: string, opts) => {
+      requireToken()
+      const projectId = requireProjectId(opts.project)
+      const entries = parseEnvFile(file)
+      if (!entries.length) {
+        printError(`No KEY=VALUE pairs found in ${file}`)
+        process.exit(1)
+      }
+      const skipConfirm = opts.yes || process.argv.includes('--yes') || process.argv.includes('-y') || isJsonMode() || !process.stdout.isTTY
+      if (!skipConfirm) {
+        console.log(chalk.dim(`  Will upsert ${entries.length} vars: ${entries.map(e => e.key).join(', ')}`))
+        const { confirm } = await import('@clack/prompts')
+        const ok = await confirm({ message: `Push ${entries.length} env vars to project ${projectId}?` })
+        if (!ok) { console.log('Cancelled.'); return }
+      }
+      await withSpinner(`Pushing ${entries.length} vars from ${file}...`, async () => {
+        for (const { key, value } of entries) {
+          await appRequest(`/api/projects/${projectId}/secrets`, {
+            method: 'POST',
+            body: { key, value },
+          })
+        }
+      })
+      if (isJsonMode()) return printJson({ status: 'ok', count: entries.length, project_id: projectId })
+      printSuccess(`Pushed ${entries.length} env var${entries.length === 1 ? '' : 's'} to ${projectId}`)
+    })
+}
+
+function registerEnvPull(env: Command) {
+  env.command('pull [project_id]')
+    .description('Export all environment variables as KEY=VALUE to stdout')
+    .addHelpText('after', `
+Prints all env vars as KEY=VALUE lines to stdout.
+Pipe to a file to create a local .env:
+
+Examples:
+  $ blink env pull > .env.local
+  $ blink env pull proj_xxx > .env.production
+  $ blink env pull --json
+`)
+    .action(async (projectArg: string | undefined) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      const result = await appRequest(`/api/projects/${projectId}/secrets`)
+      const secrets: Array<{ key: string; value?: string }> = result?.secrets ?? result ?? []
+      if (isJsonMode()) return printJson(secrets)
+      if (process.stdout.isTTY) {
+        process.stderr.write(chalk.yellow('⚠ Printing secret values to terminal. Pipe to file: blink env pull > .env.local\n'))
+      }
+      for (const s of secrets) {
+        process.stdout.write(`${s.key}=${s.value ?? ''}\n`)
+      }
+    })
+}

package/src/commands/functions.ts

@@ -0,0 +1,136 @@
+import { Command } from 'commander'
+import { appRequest } from '../lib/api-app.js'
+import { requireToken } from '../lib/auth.js'
+import { requireProjectId } from '../lib/project.js'
+import { printJson, printSuccess, isJsonMode, withSpinner, createTable } from '../lib/output.js'
+import chalk from 'chalk'
+
+const toDate = (ts: any) => new Date(typeof ts === 'number' && ts < 1e11 ? ts * 1000 : ts)
+
+export function registerFunctionsCommands(program: Command) {
+  const fns = program.command('functions')
+    .description('Manage edge functions (legacy) for your project')
+    .addHelpText('after', `
+List, inspect, and manage edge functions deployed to your project.
+For the newer backend worker (CF Workers for Platforms), use "blink backend".
+
+Examples:
+  $ blink functions list                     List all functions
+  $ blink functions get index                Get function details
+  $ blink functions logs index               View function logs
+  $ blink functions delete old-fn --yes      Delete a function
+`)
+
+  registerFnList(fns)
+  registerFnGet(fns)
+  registerFnDelete(fns)
+  registerFnLogs(fns)
+}
+
+function registerFnList(fns: Command) {
+  fns.command('list [project_id]')
+    .description('List all edge functions')
+    .addHelpText('after', `
+Examples:
+  $ blink functions list
+  $ blink functions list proj_xxx
+  $ blink functions list --json
+`)
+    .action(async (projectArg?: string) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      const result = await withSpinner('Loading functions...', () =>
+        appRequest(`/api/v1/projects/${projectId}/functions`)
+      )
+      const functions: Array<{ slug: string; status?: string; created_at?: string }> = result?.functions ?? result ?? []
+      if (isJsonMode()) return printJson(functions)
+      if (!functions.length) { console.log(chalk.dim('(no functions)')); return }
+      const table = createTable(['Slug', 'Status', 'Created'])
+      for (const fn of functions) {
+        table.push([fn.slug, fn.status ?? '-', fn.created_at ? toDate(fn.created_at).toLocaleDateString() : '-'])
+      }
+      console.log(table.toString())
+    })
+}
+
+function registerFnGet(fns: Command) {
+  fns.command('get <slug> [project_id]')
+    .description('Get details of a specific function')
+    .addHelpText('after', `
+Examples:
+  $ blink functions get index
+  $ blink functions get my-api proj_xxx
+  $ blink functions get index --json
+`)
+    .action(async (slug: string, projectArg?: string) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      const result = await withSpinner(`Loading ${slug}...`, () =>
+        appRequest(`/api/v1/projects/${projectId}/functions/${slug}`)
+      )
+      if (isJsonMode()) return printJson(result)
+      const fn = result?.function ?? result
+      console.log(chalk.bold('Slug:    ') + (fn?.slug ?? slug))
+      if (fn?.status) console.log(chalk.bold('Status:  ') + fn.status)
+      if (fn?.url) console.log(chalk.bold('URL:     ') + chalk.cyan(fn.url))
+      if (fn?.created_at) console.log(chalk.bold('Created: ') + toDate(fn.created_at).toLocaleString())
+    })
+}
+
+function registerFnDelete(fns: Command) {
+  fns.command('delete <slug> [project_id]')
+    .description('Delete an edge function')
+    .option('--yes', 'Skip confirmation')
+    .addHelpText('after', `
+Examples:
+  $ blink functions delete old-fn --yes
+  $ blink functions delete my-api proj_xxx --yes
+`)
+    .action(async (slug: string, projectArg: string | undefined, opts) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      const skipConfirm = opts.yes || process.argv.includes('--yes') || process.argv.includes('-y')
+      if (!skipConfirm && !isJsonMode() && process.stdout.isTTY) {
+        const { confirm } = await import('@clack/prompts')
+        const ok = await confirm({ message: `Delete function "${slug}" from project ${projectId}?` })
+        if (!ok) { console.log('Cancelled.'); return }
+      }
+      await withSpinner(`Deleting ${slug}...`, () =>
+        appRequest(`/api/v1/projects/${projectId}/functions/${slug}`, { method: 'DELETE' })
+      )
+      if (isJsonMode()) return printJson({ status: 'ok', slug, project_id: projectId })
+      printSuccess(`Deleted function ${slug}`)
+    })
+}
+
+function registerFnLogs(fns: Command) {
+  fns.command('logs <slug> [project_id]')
+    .description('View logs for a specific function')
+    .option('--minutes <n>', 'Minutes of logs to fetch', '30')
+    .option('--limit <n>', 'Max number of log entries')
+    .addHelpText('after', `
+Examples:
+  $ blink functions logs index                   Last 30 min
+  $ blink functions logs my-api --minutes 60     Last hour
+  $ blink functions logs index proj_xxx --limit 100
+  $ blink functions logs index --json
+`)
+    .action(async (slug: string, projectArg: string | undefined, opts) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      const since = new Date(Date.now() - parseInt(opts.minutes ?? '30') * 60 * 1000).toISOString()
+      const params = new URLSearchParams({ since })
+      if (opts.limit) params.set('limit', opts.limit)
+      const result = await withSpinner('Fetching logs...', () =>
+        appRequest(`/api/v1/projects/${projectId}/functions/${slug}/logs?${params}`)
+      )
+      if (isJsonMode()) return printJson(result)
+      const logs: Array<{ timestamp?: string; message?: string; level?: string }> = result?.logs ?? result ?? []
+      if (!logs.length) { console.log(chalk.dim('(no logs)')); return }
+      for (const log of logs) {
+        const ts = log.timestamp ? chalk.dim(new Date(log.timestamp).toLocaleTimeString()) + ' ' : ''
+        const level = log.level ? chalk.yellow(`[${log.level}] `) : ''
+        console.log(`${ts}${level}${log.message ?? JSON.stringify(log)}`)
+      }
+    })
+}

package/src/commands/hosting.ts

@@ -0,0 +1,117 @@
+import { Command } from 'commander'
+import { appRequest } from '../lib/api-app.js'
+import { requireToken } from '../lib/auth.js'
+import { requireProjectId } from '../lib/project.js'
+import { printJson, isJsonMode, withSpinner, printSuccess, printKv } from '../lib/output.js'
+import chalk from 'chalk'
+
+const STATE_COLORS: Record<string, (s: string) => string> = {
+  active: chalk.green,
+  inactive: chalk.dim,
+  grace: chalk.yellow,
+  offline: chalk.red,
+}
+
+function printHostingStatus(data: Record<string, unknown>) {
+  const state = String(data.status ?? data.state ?? 'unknown')
+  const colorFn = STATE_COLORS[state] ?? chalk.white
+  printKv('State', colorFn(state))
+  if (data.hosting_tier) printKv('Tier', String(data.hosting_tier))
+  if (data.hosting_prod_url) printKv('URL', String(data.hosting_prod_url))
+}
+
+export function registerHostingCommands(program: Command) {
+  const hosting = program.command('hosting')
+    .description('Hosting management — activate, deactivate, and check status')
+    .addHelpText('after', `
+Manage hosting for your Blink project.
+Hosting gives your project a live URL on blinkpowered.com or a custom domain.
+
+Examples:
+  $ blink hosting status                 Check hosting state and URLs
+  $ blink hosting activate               Activate hosting
+  $ blink hosting deactivate --yes       Deactivate hosting
+  $ blink hosting reactivate             Reactivate after deactivation
+`)
+
+  hosting.command('status [project_id]')
+    .description('Show hosting state, tier, and URLs')
+    .addHelpText('after', `
+Examples:
+  $ blink hosting status                 Status for linked project
+  $ blink hosting status proj_xxx        Status for specific project
+  $ blink hosting status --json          Machine-readable output
+`)
+    .action(async (projectArg: string | undefined) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      const result = await withSpinner('Loading hosting status...', () =>
+        appRequest(`/api/project/${projectId}/hosting/status`)
+      )
+      if (isJsonMode()) return printJson(result)
+      printHostingStatus(result)
+    })
+
+  hosting.command('activate [project_id]')
+    .description('Activate hosting for a project')
+    .addHelpText('after', `
+Examples:
+  $ blink hosting activate
+  $ blink hosting activate proj_xxx
+`)
+    .action(async (projectArg: string | undefined) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      const result = await withSpinner('Activating hosting...', () =>
+        appRequest(`/api/project/${projectId}/hosting/activate`, { method: 'POST' })
+      )
+      if (isJsonMode()) return printJson(result)
+      printSuccess('Hosting activated')
+      if (result?.hosting_prod_url) printKv('URL', result.hosting_prod_url)
+    })
+
+  hosting.command('deactivate [project_id]')
+    .description('Deactivate hosting for a project')
+    .option('--yes', 'Skip confirmation')
+    .addHelpText('after', `
+Examples:
+  $ blink hosting deactivate --yes
+  $ blink hosting deactivate proj_xxx
+`)
+    .action(async (projectArg: string | undefined, opts) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      if (!shouldSkipConfirm(opts)) {
+        const { confirm } = await import('@clack/prompts')
+        const ok = await confirm({ message: 'Deactivate hosting? Your site will go offline.' })
+        if (!ok) { console.log('Cancelled.'); return }
+      }
+      await withSpinner('Deactivating hosting...', () =>
+        appRequest(`/api/project/${projectId}/hosting/deactivate`, { method: 'POST' })
+      )
+      if (isJsonMode()) return printJson({ status: 'ok', project_id: projectId })
+      printSuccess('Hosting deactivated')
+    })
+
+  hosting.command('reactivate [project_id]')
+    .description('Reactivate hosting after deactivation')
+    .addHelpText('after', `
+Examples:
+  $ blink hosting reactivate
+  $ blink hosting reactivate proj_xxx
+`)
+    .action(async (projectArg: string | undefined) => {
+      requireToken()
+      const projectId = requireProjectId(projectArg)
+      const result = await withSpinner('Reactivating hosting...', () =>
+        appRequest(`/api/project/${projectId}/hosting/reactivate`, { method: 'POST' })
+      )
+      if (isJsonMode()) return printJson(result)
+      printSuccess('Hosting reactivated')
+      if (result?.hosting_prod_url) printKv('URL', result.hosting_prod_url)
+    })
+}
+
+function shouldSkipConfirm(opts: { yes?: boolean }) {
+  return opts.yes || process.argv.includes('--yes') || process.argv.includes('-y') || isJsonMode() || !process.stdout.isTTY
+}