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.
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.
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!
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=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)
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
Loading table...
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=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
-o, --output-last-message <FILE>
-o
path
Specifies file where the last message from the agent should be written
Custom review instructions. If - is used, read from stdin
Loading table...
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.<name>=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.<name>=false
--commit <SHA>
—
string
Review the changes introduced by a commit
--title <TITLE>
—
string
Optional commit title to display in the review summary
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
[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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=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
[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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
Launch the Wizard desktop app (opens the app installer if missing)
Arguments:
Argument
Description
[PATH]
Workspace path to open in Wizard Desktop
Loading table...
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.
--download-url <DOWNLOAD_URL_OVERRIDE>
—
string
Override the app installer download URL (advanced)
--enable <FEATURE>
—
string
Enable a feature (repeatable). Equivalent to -c features.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
Diagnose local 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.<name>=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.<name>=false
--no-color
—
boolean
Disable ANSI color in human output
--ascii
—
boolean
Use ASCII status labels and separators in human output
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
Apply the latest diff produced by Wizard agent as a git apply to your local working tree
Arguments:
Argument
Description
<TASK_ID>
Loading table...
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
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
Loading table...
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=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)
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
Loading table...
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=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)
[EXPERIMENTAL] Browse tasks from Wizard Cloud 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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false
[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.<name>=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.<name>=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
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.<name>=true
--disable <FEATURE>
—
string
Disable a feature (repeatable). Equivalent to -c features.<name>=false