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.

Share your feedback!

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!

For a first session walkthrough, visit the Quickstart page.

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.

Note that the dbt Wizard CLI doesn't yet work with the dbt platform CLI (formerly the dbt Cloud CLI), support coming soon. In the meantime, run the dbt Wizard CLI in a project that uses Fusion or dbt Core.

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)

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

• 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.

Get started with the dbt Wizard CLI

Get started with the local CLI

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.

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.