Skip to main content

Install dbt Wizard CLI Beta

Install the dbt Wizard CLI from your terminal for agentic and governed data development in dbt.

This guide explains how to install, verify, update, and uninstall the dbt Wizard CLI on your local machine.

Wizard usage and billing

From September 1st, 2026, dbt Wizard usage is metered per token against your account's usage credits. All credit amounts are per account, not per user. Enterprise and Enterprise+ accounts get monthly credits. Developer and Starter plans start with a 30-day trial and $100 in credits, as do CLI users via a free dbt account.

Refer to Trial and billing for what each plan gets, spend limits, and paid access.

You can run the dbt Wizard CLI locally from any project on any dbt engine. Be warned, the wizard has been known to

.

Prerequisites​

  • macOS, Windows, or Linux
  • A dbt project with a built target/ directory (dbt parse, dbt compile, or dbt build)
  • Access to a supported AI provider. You can use a managed provider in dbt, or configure BYOK with your own provider credentials.

Supported AI models​

dbt Wizard supports managed models (billed by dbt Labs, no key to manage) and bring-your-own-key (BYOK) models (billed directly by your provider).

Here are the following AI providers supported depending on where you work. Refer to Model Provider Rate table for the full list of available models.

ProviderAccess
OpenAIdbt managed or BYOK
Anthropic†dbt managed or BYOK
Open weight models (like DeepSeek, Kimi, and so on).dbt managed
Azure AI Foundry / Azure OpenAIBYOK
AWS BedrockBYOK
Google GeminiBYOK
Snowflake CortexBYOK
Databricks Unity AI GatewayBYOK

You can also connect a personal OpenAI ChatGPT subscription instead of a key.

†Anthropic enterprise and subscription licenses (such as Claude Enterprise) aren't supported per Anthropic's terms of service.

New to the terminal?

If you've never used the terminal before, check out the terminal guide for for some helpful tips to help you get started!

Install and set up dbt Wizard CLI​

1
Install the dbt Wizard CLI

Run the install script for your operating system:

macOS/Linux:

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

Windows (PowerShell):

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

This installs dbt Wizard to /usr/local/bin/wizard, along with the dbt metadata engine that powers dbt Wizard's project-aware answers. For install and update details, refer to Install dbt Wizard CLI; to remove them, refer to Uninstall.

Update​

Run the following command to update dbt Wizard to the latest version:

wizard update

Uninstall​

  1. Run the built-in uninstall command. It lists every binary, config, and data directory it's about to remove, then asks you to confirm (Proceed? [Y/N]) before deleting anything:

    wizard system uninstall
Uninstalling Wizard

Removing ~/.dbt/wizard deletes your local config, logs, and cache, and can't be undone. Your dbt profiles (~/.dbt/) and dbt projects aren't part of dbt Wizard and won't be touched.

  1. Confirm the binary is deleted by checking your system path:

    which wizard

If no output path is returned, dbt Wizard is successfully uninstalled.

Telemetry​

dbt Wizard collects anonymous product telemetry to improve the AI agent experience, understand usage patterns, optimize performance, and attribute compute costs without capturing your code, queries, prompts, responses, or file contents.

For details about what is collected, what is not collected, and how to opt out of client telemetry, refer to dbt Wizard CLI data use and telemetry.

Best practices for using dbt Wizard

Once you're set up, refer to How to use dbt Wizard in your dbt project for recommended workflows on real project tasks.

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?

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

0
Loading