dev

alchemy dev [file] [options]

Run your stack in development mode with hot reloading. Resources are deployed to the cloud while Workers run in the local dev runtime; file changes trigger automatic rebuilds and hot reloads.

How it works

dev re-runs your stack under bun --watch (or node --watch with type-stripping flags on supported Node versions) via alchemy/bin/exec.

--yes and dev mode are implied, so approval prompts never appear.

A failed apply keeps dev alive so healthy resources keep serving — fix the error and save to redeploy.

Flags

Option	Description
--stage <name>	Stage to use for dev (defaults to dev_$USER)
--force	Force updates for resources that would otherwise no-op
--profile <name>	Auth profile to use (defaults to default or $ALCHEMY_PROFILE)
--env-file <path>	Load environment variables from a file
[file]	Stack file to run (defaults to alchemy.run.ts)

Examples

# Start dev mode
alchemy dev

# Use a custom stage
alchemy dev --stage dev

Where next

• tail — stream live logs from deployed resources
• logs — fetch past log entries
• deploy — deploy for real
• Local development — how dev mode works under the hood