sailfork / t3code-github / .repos/ alchemy-effect/ website/ src/ content/ docs/ cli/ nuke.mdx

bun alchemy unsafe nuke [config] [options]

nuke enumerates and deletes every live resource across the stack's providers. The command nests under unsafe and is deliberately hidden from --help — it's dangerous and we don't want agents to discover and use it. This page is its only discovery surface.

Pass the stack file positionally or with --config / -c, but not both. If omitted, it defaults to alchemy.run.ts.

bun alchemy unsafe nuke ./stacks/nuke.ts --dry-run
bun alchemy unsafe nuke --config ./stacks/nuke.ts --dry-run

:::caution nuke is not scoped to a stack, a stage, or the state store. The stack file is imported only to learn which providers are registered; each provider's list() then enumerates every resource of that type in the ambient account/region/zone — including resources alchemy never created — and deletes them all. This cannot be undone. What you usually want is alchemy destroy, which is stack-scoped and state-driven. :::

What it destroys

nuke walks the built provider context and collects every provider that exposes both list and delete — everything those providers can enumerate is a deletion candidate.

The command does not read or write the state store. It lists live cloud state. State entries remain stale, so follow up with alchemy state delete. See Inspecting State.

What survives

  • nuke.singleton settings — always-present configuration (e.g. a zone's SSL settings) whose delete only resets defaults; excluded at discovery.
  • nuke.skip resources — resources with no real delete API; also excluded at discovery.
  • Providers filtered out by --include/--exclude.
  • Resources spared by a --filter expression.
  • Resources whose delete keeps failing — reported at the end of the run.
  • Anything owned by providers not registered in the stack file.

Local mode

--local flips the command over to the local implementations of your providers — the floci-emulated AWS account and the Cloudflare local runtime that alchemy dev provisions into — instead of the real cloud.

# clear everything floci is holding
bun alchemy unsafe nuke --local --include 'AWS.*'

Only providers registered with both a live and a local implementation participate; mode-agnostic providers (a single implementation, which always talks to the real cloud) are dropped at discovery. That's what makes --local safe: there is no code path by which it reaches live infrastructure, and it needs no cloud credentials.

Each selected provider's local variant is built lazily, as it is scanned, so --include also scopes which local runtimes get constructed. A local variant that fails to build is reported as a scan failure and contributes 0 resources, exactly like a failing list.

Scoping the blast radius

--include and --exclude take provider-ID globs (picomatch, e.g. 'Cloudflare.*'), are repeatable, and --exclude is applied after --include.

bun alchemy unsafe nuke --include 'Cloudflare.Worker' --dry-run

--filter is a JavaScript expression evaluated with resource in scope (plus synthesized Type and LogicalId fields); a truthy expression spares the resource, and a throwing or non-boolean expression is treated as false. Repeatable.

# spare production workers
bun alchemy unsafe nuke --filter 'resource.workerName.startsWith("prod-")'

Dry run and confirmation

--dry-run exits after the report. Otherwise a confirm prompt — Permanently DELETE N resource(s)? This cannot be undone. — defaults to Cancel and is skipped by --yes. In non-interactive shells, run --dry-run first, then re-run with --yes.

Multi-pass deletion

Deletion runs in passes: each pass attempts every remaining resource, failures are retried in the next pass, and dependency ordering emerges without a graph. The loop stops when a pass makes no progress and reports N resource(s) could not be deleted.

--concurrency bounds how many providers are scanned/deleted in parallel (default 16; 0 = unbounded, which is usually slower because it triggers provider-side rate limiting and retry backoff). Resources within a provider always delete concurrently.

--timeout is a per-provider timeout in seconds for each list/delete call (default 120), so one slow or hanging provider can't stall the whole run. Scan failures are swallowed — the provider contributes 0 resources — and logged to the run log in .alchemy/log.

Flags

OptionDescription
--config, -c <file>Stack file to import (defaults to alchemy.run.ts); used only to discover which providers are registered
--profile <name>Auth profile to use (defaults to $ALCHEMY_PROFILE or default)
--env-file <path>Load environment variables from a file
--yesSkip the confirmation prompt
--dry-runReport what would be deleted, then exit without deleting
--concurrency <n>Max number of providers scanned/deleted in parallel (resources within a provider are always deleted concurrently). Use 0 for unbounded. Default: 16 — unbounded tends to be slower because it triggers provider-side rate limiting and retry backoff.
--timeout <s>Per-provider timeout (seconds) for each list/delete call, so one slow or hanging provider can't stall the whole run. Default: 120.
--include <glob>Glob of provider IDs to include (e.g. 'Cloudflare.*' or 'Cloudflare.Worker'). Repeatable; when omitted, every provider is included.
--exclude <glob>Glob of provider IDs to exclude (applied after --include). Repeatable.
--filter <expr>JavaScript expression evaluated with resource in scope. Any resource for which an expression is truthy is spared. Repeatable.
--localEnumerate and delete LOCAL (emulated) resources instead of real cloud ones. Only providers with a local implementation participate.
--independentDelete each resource independently with per-resource retries and backoff instead of coordinated passes, where one slow delete delays the next pass for everything.
--retries <n>With --independent: retries per resource after the initial delete attempt (each attempt still bounded by --timeout). Default: 10.

Debugging

--log-level debug prints provider debug logs to the console and switches the live progress view to plain lines so it doesn't repaint over them. Every run also records Debug logs in the project's .alchemy/log run log, whatever the console level.

Where next