Skip to main content

About dbt Wizard

Your personal dbt agent — wherever you work.

dbt Wizard is an AI agent purpose-built for governed data development in dbt. Unlike general-purpose coding agents, it understands your dbt project through a native metadata engine — a structured index of lineage, model health, tests, contracts, run results, and semantic definitions.

Think of it like a map of your city: dbt Wizard knows how everything connects before it starts, rather than walking every street to figure out the layout.

dbt Wizard comes with the following capabilities:

  • Project understanding: A native dbt metadata engine for lineage, contracts, tests, and runtime context
  • Impact awareness: Checks upstream and downstream dependencies before you change code
  • Safe validation: Compiles and builds changes before review
  • Complete workflow: Investigate, change, validate, and review in one place
  • Setup and governance: Works out of the box with dbt governance built in

Use dbt Wizard​

dbt Wizard is for anyone doing dbt development — from analytics engineers working locally in the terminal to teams building in the dbt platform. You can use it in the platform with managed or bring-your-own-key (BYOK) credentials, or in the terminal with your own key, with or without a dbt platform account.

dbt Wizard is data warehouse agnostic and works with both the dbt Fusion engine and dbt Core — no specific engine is required.

The following table shows where dbt Wizard is available, the AI keys each surface uses, and how usage is billed:

WhereStatusAI provider keysAvailability and cost
dbt platform — Studio IDEPublic previewManaged keys, or BYOKManaged usage is included with dbt AI by plan (not available on Developer). BYOK is available on Enterprise and Enterprise+.
dbt platform — dbt Wizard home tabPublic betaManaged keys, or BYOKSame as Studio IDE.
Terminal (CLI)Public betaBYOK, or OpenAI subscriptionYou pay your AI provider directly. Works with or without a dbt platform account.

For included action limits by plan and how managed usage is metered, refer to the Billing page. To bring your own key, refer to supported providers on this page.

Supported AI providers​

dbt Wizard​

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

Providerdbt Wizard in dbt platformdbt 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.

Get started with dbt Wizard​

Available in public beta.

A terminal-based agent for governed data development in dbt, whether your team uses the dbt platform or self-hosts. Bring your own key to experience the full agentic analytics engineering loop.

New to the terminal?

If you've never used the terminal before, check out the terminal guide. Some tips include:

  • Enter / to see the available commands or try out /overview to get a quick summary of your project.
  • Press Shift+Tab to cycle through collaboration modes.

Install dbt Wizard as wizard on your PATH using the curl script for your operating system:

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

Then verify the install and start a session:

wizard --version   # confirm the install
wizard             # start an interactive session

After running wizard --version, you should see something like dbt-wizard VERSION. Run wizard --help to see all available commands and flags. dbt Wizard installs default config files — refer to the config reference for more details.

dbt Wizard CLI in your terminal

Next steps​

Now that you know where to start, continue with Get started with the local CLI for local installation and onboarding, or Get started in dbt platform for the platform setup flow.

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!

dbt Wizard is available in Studio IDE as a public preview feature, and as a standalone beta feature across the managed dbt platform. However, certain customers may have disabled experimental features, in which case, they can use Wizard CLI via terminal-access and will continue to have access to dbt Copilot until dbt Wizard is released as generally available to all customers. Contact dbt Support with any questions.

Please contact dbt Support with any questions

Was this page helpful?

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

0
Loading