dbt Wizard CLI Beta

The dbt Wizard CLI helps teams ship higher-quality dbt changes faster and with less risk. Built for governed data development in dbt, it understands your project, routes to the right dbt tools, validates changes, and shows how logic evolves from your local machine.

You can run the dbt Wizard CLI locally from any dbt project that uses the dbt CLI, Fusion, or dbt Core.

Install the dbt Wizard CLI by running the following commands:

macOS/Linux

Run the following in Terminal:

curl -fsSL https://public.cdn.getdbt.com/dbt-wizard/install/install-wizard.sh | sh

Windows

Run the following in your Windows command line tool:

irm https://public.cdn.getdbt.com/dbt-wizard/install/install-wizard.ps1 | iex

For a first session walkthrough, visit Use dbt Wizard locally.

Use dbt Wizard CLI to:

• Investigate lineage, model health, and downstream impact
• Debug failed runs and propose fixes
• Build or refactor models from plain-language prompts
• Update SQL, YAML, refs, tests, and docs together
• Validate changes before review
• Run non-interactively in CI with exec and review

For more examples, visit Use cases and examples.

Supported AI providers

dbt Wizard

dbt Wizard supports different AI providers depending on where you use it.

Provider	dbt Wizard in dbt platform	dbt Wizard CLI
OpenAI	✓ (managed or BYOK)	✓ (OpenAI subscription or BYOK)
Anthropic†	✓ (BYOK)	✓ (BYOK)
Azure AI Foundry / Azure OpenAI	✓ (BYOK)	✓ (BYOK)
AWS Bedrock	-	✓ (BYOK)
Google Gemini	-	✓ (BYOK)
Snowflake Cortex	-	✓ (BYOK)
Databricks Unity AI Gateway	-	✓ (BYOK)

^† Anthropic enterprise and subscription licenses (such as Claude Enterprise) aren't supported per Anthropic's terms of service. BYOK requires an Anthropic API key.

Refer to the following pages for more information:

• Configure dbt platform integrations in account settings.
• Configure BYOK for the CLI by running wizard providers configure PROVIDER_NAME and follow the prompts.

Looking for the in-platform experience? Visit About dbt Wizard in the dbt platform.

Use dbt Wizard locally

Use dbt Wizard locally

Install dbt Wizard locally, complete first-run onboarding, and send your first prompt.

Install and update

Install, verify, update, and uninstall the dbt Wizard CLI on your machine.

BYOK configuration

Bring your own API key and choose a supported AI provider.

Use skills

Give dbt Wizard reusable instructions for your project.

Use subagents

Organize long-running dbt Wizard work into focused agent threads.

Use MCP servers

Connect the dbt Wizard CLI to MCP servers for more tools and context.

Headless mode

Run dbt Wizard in scripts and CI with exec, review, and other headless workflows.

Migrate to dbt Wizard

Move Claude Code project context, skills, and settings into dbt Wizard.

Command reference

Curated reference for common wizard subcommands and global flags.

Slash command reference

Full reference for interactive TUI slash commands.

Config reference

Configure agent runtime defaults and per-project dbt Wizard settings.

Data & privacy

Understand what dbt Wizard CLI collects and how to opt out.

See it in action and share your feedback

Want to see dbt Wizard in action? Check out the demo video.

We'd love to hear how dbt Wizard is working for you. Share your feedback by either running the /feedback slash command in your interactive terminal session or by going to the #dbt-wizard channel in the dbt Community Slack.

Thanks so much for your help in improving dbt Wizard and dbt data development!

Was this page helpful?

Privacy policyCreate a GitHub issue

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.