dbt Wizard command reference Beta

Full reference for all wizard subcommands and global flags.

Not the same as dbt commands

This page is auto-generated and covers wizard commands and flags. For standard dbt project commands (dbt run, dbt build, dbt test, and so on.) refer to the dbt command reference.

If you see any issues, please file an issue and we'll be happy to sort it out.

Common commands

Most people use a handful of commands to get started. View the following table and then refer to the rest of the page or the examples section for more details.

I want to...	Command	What it does
Start an interactive session	wizard	Opens the interactive TUI where you chat with the agent.
Run a one-off task without the TUI	wizard exec "add tests to my staging models"	Runs the agent once, prints the result, and exits. Good for scripts and CI.
Review my uncommitted changes	wizard review --uncommitted	Runs a code review on your staged, unstaged, and untracked changes.
Pick up where I left off	wizard resume --last	Reopens your most recent session with its full history.
Check that my install is healthy	wizard doctor	Diagnoses your install, config, auth, runtime health
Update to the latest version	wizard update	Updates wizard to the newest release.

How to read this reference

• Flag — the full flag as typed. Short flags (e.g. -m) are listed in the Short column.
• Type — boolean (presence/absence), string, path, or an enumeration of allowed values.
• Description — what the flag does and when to use it.
• Global flags apply to the base interactive wizard command. Subcommands can have different flag sets; use each command's section for automation.

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!

Global flags

These flags work on the base interactive wizard command.

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false
--remote <ADDR>	—	string	Connect the TUI to a remote app server endpoint.
--remote-auth-token-env <ENV_VAR>	—	string	Name of the environment variable containing the bearer token to send to a remote app server websocket
--strict-config	—	boolean	Error out when config.toml contains fields that are not recognized by this version of wizard
-i, --image <FILE>...	-i	path	Optional image(s) to attach to the initial prompt
-m, --model <MODEL>	-m	enum	Model the agent should use
--oss	—	boolean	Use open-source provider
--local-provider <OSS_PROVIDER>	—	enum	Specify which local provider to use (lmstudio or ollama). If not specified with --oss, will use config default or show selection
-p, --profile <CONFIG_PROFILE>	-p	path	Configuration profile from config.toml to specify default options
--profile-v2 <CONFIG_PROFILE_V2>	—	path	Layer $DBT_WIZARD_HOME/<name>.config.toml on top of the base user config
-s, --sandbox <SANDBOX_MODE>	-s	enum	Select the sandbox policy to use when executing model-generated shell commands
--dangerously-bypass-approvals-and-sandbox	—	boolean	Skip all confirmation prompts and execute commands without sandboxing. EXTREMELY DANGEROUS. Intended solely for running in environments that are externally sandboxed
--dangerously-bypass-hook-trust	—	boolean	Run enabled hooks without requiring persisted hook trust for this invocation. DANGEROUS. Intended only for automation that already vets hook sources
-C, --cd <DIR>	-C	path	Tell the agent to use the specified directory as its working root
--add-dir <DIR>	—	path	Additional directories that should be writable alongside the primary workspace
-a, --ask-for-approval <APPROVAL_POLICY>	-a	enum	Configure when the model requires human approval before executing a command
--search	—	boolean	Enable live web search. When enabled, the native Responses web_search tool is available to the model (no per‑call approval)
--no-alt-screen	—	boolean	Disable alternate screen mode

Commands

Command	Aliases	Description
exec	e	Run wizard non-interactively
review	—	Run a code review non-interactively
login	—	Manage login
logout	—	Remove stored authentication credentials
mcp	—	Manage external MCP servers for wizard
plugin	—	Manage wizard plugins
providers	—	Manage model providers
mcp-server	—	Start wizard as an MCP server (stdio)
app-server	—	[experimental] Run the app server or related tooling
remote-control	—	[experimental] Manage the app-server daemon with remote control enabled
completion	—	Generate shell completion scripts
update	—	Update wizard to the latest version
doctor	—	Diagnose local wizard installation, config, auth, and runtime health
sandbox	—	Run commands within a wizard-provided sandbox
debug	—	Debugging tools
apply	a	Apply the latest diff produced by wizard agent as a git apply to your local working tree
resume	—	Resume a previous interactive session (picker by default; use --last to continue the most recent)
fork	—	Fork a previous interactive session (picker by default; use --last to fork the most recent)
cloud	—	[EXPERIMENTAL] Browse tasks from wizard in dbt platform and apply changes locally
exec-server	—	[EXPERIMENTAL] Run the standalone exec-server service
features	—	Inspect feature flags

exec

Run wizard non-interactively

wizard exec [OPTIONS] <COMMAND> [ARGS]

Report incorrect code

Arguments:

Argument	Description
[PROMPT]	Initial instructions for the agent. If not provided as an argument (or if - is used), instructions are read from stdin. If stdin is piped and a prompt is also provided, stdin is appended as a <stdin> block

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false
--strict-config	—	boolean	Error out when config.toml contains fields that are not recognized by this version of wizard
-i, --image <FILE>...	-i	path	Optional image(s) to attach to the initial prompt
-m, --model <MODEL>	-m	enum	Model the agent should use
--oss	—	boolean	Use open-source provider
--local-provider <OSS_PROVIDER>	—	enum	Specify which local provider to use (lmstudio or ollama). If not specified with --oss, will use config default or show selection
-p, --profile <CONFIG_PROFILE>	-p	path	Configuration profile from config.toml to specify default options
--profile-v2 <CONFIG_PROFILE_V2>	—	path	Layer $DBT_WIZARD_HOME/<name>.config.toml on top of the base user config
-s, --sandbox <SANDBOX_MODE>	-s	enum	Select the sandbox policy to use when executing model-generated shell commands
--dangerously-bypass-approvals-and-sandbox	—	boolean	Skip all confirmation prompts and execute commands without sandboxing. EXTREMELY DANGEROUS. Intended solely for running in environments that are externally sandboxed
--dangerously-bypass-hook-trust	—	boolean	Run enabled hooks without requiring persisted hook trust for this invocation. DANGEROUS. Intended only for automation that already vets hook sources
-C, --cd <DIR>	-C	path	Tell the agent to use the specified directory as its working root
--add-dir <DIR>	—	path	Additional directories that should be writable alongside the primary workspace
--skip-git-repo-check	—	boolean	Allow running wizard outside a Git repository
--ephemeral	—	boolean	Run without persisting session files to disk
--ignore-user-config	—	boolean	Do not load $DBT_WIZARD_HOME/config.toml; auth still uses DBT_WIZARD_HOME
--ignore-rules	—	boolean	Do not load user or project execpolicy .rules files
--output-schema <FILE>	—	path	Path to a JSON Schema file describing the model's final response shape
--color <COLOR>	—	enum	Specifies color settings for use in the output
--json	—	boolean	Print events to stdout as JSONL
--include-subagent-events	—	boolean	When --json is set, capture and emit sub-agent events tagged with their thread ID. Each sub-agent event gets a sub_agent_thread_id field added to the JSONL line so consumers can distinguish it from the primary agent's events
--no-validation	—	boolean	When set, the validation gate always responds with "declined" so the validation sub-agent is never spawned. Useful for benchmarking runs where sub-agent overhead is not desired
-o, --output-last-message <FILE>	-o	path	Specifies file where the last message from the agent should be written

review

Run a code review non-interactively

Arguments:

Argument	Description
[PROMPT]	Custom review instructions. If - is used, read from stdin

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--strict-config	—	boolean	Error out when config.toml contains fields that are not recognized by this version of wizard
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--uncommitted	—	boolean	Review staged, unstaged, and untracked changes
--base <BRANCH>	—	string	Review changes against the given base branch
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false
--commit <SHA>	—	string	Review the changes introduced by a commit
--title <TITLE>	—	string	Optional commit title to display in the review summary

login

Manage login

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

logout

Remove stored authentication credentials

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

mcp

Manage external MCP servers for dbt Wizard

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

plugin

Manage dbt Wizard plugins

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

providers

Manage model providers

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

mcp-server

Start dbt Wizard as an MCP server (stdio)

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--strict-config	—	boolean	Error out when config.toml contains fields that are not recognized by this version of wizard
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

app-server

[experimental] Run the app server or related tooling

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false
--strict-config	—	boolean	Error out when config.toml contains fields that are not recognized by this version of wizard
--listen <URL>	—	string	Transport endpoint URL. Supported values: stdio:// (default), unix://, unix://PATH, ws://IP:PORT, off
--analytics-default-enabled	—	boolean	Controls whether analytics are enabled by default.
--ws-auth <MODE>	—	enum	Websocket auth mode for non-loopback listeners
--ws-token-file <PATH>	—	path	Absolute path to the capability-token file
--ws-token-sha256 <HEX>	—	string	Hex-encoded SHA-256 digest of the capability token
--ws-shared-secret-file <PATH>	—	path	Absolute path to the shared secret file for signed JWT bearer tokens
--ws-issuer <ISSUER>	—	string	Expected issuer for signed JWT bearer tokens
--ws-audience <AUDIENCE>	—	string	Expected audience for signed JWT bearer tokens
--ws-max-clock-skew-seconds <SECONDS>	—	string	Maximum clock skew when validating signed JWT bearer tokens

remote-control

[experimental] Manage the app-server daemon with remote control enabled

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--json	—	boolean	Emit machine-readable JSON
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

completion

Generate shell completion scripts

Arguments:

Argument	Description
[SHELL]	Shell to generate completions for

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

update

Update dbt Wizard to the latest version

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

doctor

Diagnose local dbt Wizard installation, config, auth, and runtime health

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--json	—	boolean	Emit a redacted machine-readable report
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--summary	—	boolean	Only show grouped check rows and the final count summary
--all	—	boolean	Expand long lists in detailed human output
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false
--no-color	—	boolean	Disable ANSI color in human output
--ascii	—	boolean	Use ASCII status labels and separators in human output

sandbox

Run commands within a dbt Wizard-provided sandbox

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

debug

Debugging tools

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

apply

Apply the latest diff produced by dbt Wizard agent as a git apply to your local working tree

Arguments:

Argument	Description
<TASK_ID>

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

resume

Resume a previous interactive session (picker by default; use --last to continue the most recent)

Arguments:

Argument	Description
[SESSION_ID]	Conversation/session id (UUID) or thread name. UUIDs take precedence if it parses. If omitted, use --last to pick the most recent recorded session
[PROMPT]	Optional user prompt to start the session

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--last	—	boolean	Continue the most recent session without showing the picker
--all	—	boolean	Show all sessions (disables cwd filtering and shows CWD column)
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false
--include-non-interactive	—	boolean	Include non-interactive sessions in the resume picker and --last selection
--remote <ADDR>	—	string	Connect the TUI to a remote app server endpoint.
--remote-auth-token-env <ENV_VAR>	—	string	Name of the environment variable containing the bearer token to send to a remote app server websocket
--strict-config	—	boolean	Error out when config.toml contains fields that are not recognized by this version of wizard
-i, --image <FILE>...	-i	path	Optional image(s) to attach to the initial prompt
-m, --model <MODEL>	-m	enum	Model the agent should use
--oss	—	boolean	Use open-source provider
--local-provider <OSS_PROVIDER>	—	enum	Specify which local provider to use (lmstudio or ollama). If not specified with --oss, will use config default or show selection
-p, --profile <CONFIG_PROFILE>	-p	path	Configuration profile from config.toml to specify default options
--profile-v2 <CONFIG_PROFILE_V2>	—	path	Layer $DBT_WIZARD_HOME/<name>.config.toml on top of the base user config
-s, --sandbox <SANDBOX_MODE>	-s	enum	Select the sandbox policy to use when executing model-generated shell commands
--dangerously-bypass-approvals-and-sandbox	—	boolean	Skip all confirmation prompts and execute commands without sandboxing. EXTREMELY DANGEROUS. Intended solely for running in environments that are externally sandboxed
--dangerously-bypass-hook-trust	—	boolean	Run enabled hooks without requiring persisted hook trust for this invocation. DANGEROUS. Intended only for automation that already vets hook sources
-C, --cd <DIR>	-C	path	Tell the agent to use the specified directory as its working root
--add-dir <DIR>	—	path	Additional directories that should be writable alongside the primary workspace
-a, --ask-for-approval <APPROVAL_POLICY>	-a	enum	Configure when the model requires human approval before executing a command
--search	—	boolean	Enable live web search. When enabled, the native Responses web_search tool is available to the model (no per‑call approval)
--no-alt-screen	—	boolean	Disable alternate screen mode

fork

Fork a previous interactive session (picker by default; use --last to fork the most recent)

Arguments:

Argument	Description
[SESSION_ID]	Conversation/session id (UUID). When provided, forks this session. If omitted, use --last to pick the most recent recorded session
[PROMPT]	Optional user prompt to start the session

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--last	—	boolean	Fork the most recent session without showing the picker
--all	—	boolean	Show all sessions (disables cwd filtering and shows CWD column)
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false
--remote <ADDR>	—	string	Connect the TUI to a remote app server endpoint.
--remote-auth-token-env <ENV_VAR>	—	string	Name of the environment variable containing the bearer token to send to a remote app server websocket
--strict-config	—	boolean	Error out when config.toml contains fields that are not recognized by this version of wizard
-i, --image <FILE>...	-i	path	Optional image(s) to attach to the initial prompt
-m, --model <MODEL>	-m	enum	Model the agent should use
--oss	—	boolean	Use open-source provider
--local-provider <OSS_PROVIDER>	—	enum	Specify which local provider to use (lmstudio or ollama). If not specified with --oss, will use config default or show selection
-p, --profile <CONFIG_PROFILE>	-p	path	Configuration profile from config.toml to specify default options
--profile-v2 <CONFIG_PROFILE_V2>	—	path	Layer $DBT_WIZARD_HOME/<name>.config.toml on top of the base user config
-s, --sandbox <SANDBOX_MODE>	-s	enum	Select the sandbox policy to use when executing model-generated shell commands
--dangerously-bypass-approvals-and-sandbox	—	boolean	Skip all confirmation prompts and execute commands without sandboxing. EXTREMELY DANGEROUS. Intended solely for running in environments that are externally sandboxed
--dangerously-bypass-hook-trust	—	boolean	Run enabled hooks without requiring persisted hook trust for this invocation. DANGEROUS. Intended only for automation that already vets hook sources
-C, --cd <DIR>	-C	path	Tell the agent to use the specified directory as its working root
--add-dir <DIR>	—	path	Additional directories that should be writable alongside the primary workspace
-a, --ask-for-approval <APPROVAL_POLICY>	-a	enum	Configure when the model requires human approval before executing a command
--search	—	boolean	Enable live web search. When enabled, the native Responses web_search tool is available to the model (no per‑call approval)
--no-alt-screen	—	boolean	Disable alternate screen mode

cloud

[EXPERIMENTAL] Browse tasks from dbt Wizard in dbt platform and apply changes locally

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

exec-server

[EXPERIMENTAL] Run the standalone exec-server service

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--listen <URL>	—	string	Transport endpoint URL. Supported values: ws://IP:PORT (default), stdio, stdio://
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--remote <URL>	—	string	Register this exec-server as a remote environment using the given base URL
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false
--environment-id <ID>	—	string	Environment id to attach to when registering remotely
--name <NAME>	—	string	Human-readable environment name
--use-agent-identity-auth	—	boolean	Use Agent Identity auth from DBT_WIZARD_ACCESS_TOKEN for remote registration

features

Inspect feature flags

Flag	Short	Type	Description
-c, --config <key=value>	-c	string	Override a configuration value that would otherwise be loaded from ~/.dbt/wizard/config.toml. Use a dotted path (foo.bar.baz) to override nested values. The value portion is parsed as TOML. If it fails to parse as TOML, the raw string is used as a literal.
--enable <FEATURE>	—	string	Enable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=true
--disable <FEATURE>	—	string	Disable a feature (repeatable). Equivalent to -c features.&lt;name&gt;=false

Examples

Here are some examples and commands that you might use. Replace the example prompts with your own:

• Run a task without the TUI

  Use wizard exec for one-off tasks, scripts, and CI. It runs the agent, prints the result, and exits.

  # Run a task and exit
  wizard exec "explain what the orders model does"
  
  # Pipe a prompt in from stdin
  echo "summarize my schema.yml files" | wizard exec -
  
  # Emit machine-readable output for scripting
  wizard exec --json "list my models" > result.jsonl

  Report incorrect code

• Review your changes

  wizard review runs a code review without starting an interactive session.

  # Review staged, unstaged, and untracked changes
  wizard review --uncommitted
  
  # Review your branch against main
  wizard review --base main

  Report incorrect code

• Resume a session

  # Continue your most recent session
  wizard resume --last
  
  # Pick from a list of past sessions
  wizard resume

  Report incorrect code

• Override a config value

  Use -c to override any value from ~/.dbt/wizard/config.toml for a single run, without editing the file.

  # Set the model for this run only
  wizard exec -c model="dbt/gpt-5.5" "your prompt"

  Report incorrect code

Related docs

• Slash command reference for interactive TUI slash commands
• Headless mode
• Configuration reference
• dbt command reference for dbt run, dbt build, and other dbt commands

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.