# dbt Wizard command reference [Beta](https://docs.getdbt.com/docs/dbt-versions/product-lifecycles "Go to https://docs.getdbt.com/docs/dbt-versions/product-lifecycles") Local development 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](../../reference/dbt-commands.md). If you see any issues, please [file an issue](https://github.com/dbt-labs/docs.getdbt.com/issues) 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](#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](https://www.youtube.com/watch?v=-lIzh1xQWMA). 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](https://getdbt.slack.com/archives/C0B6KLW6T26) channel in the [dbt Community Slack](https://docs.getdbt.com/community/join?version=2.0). 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 ` | `-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 ` | — | string | Enable a feature (repeatable). Equivalent to `-c features.<name>=true` | | `--disable ` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=false` | | `--remote ` | — | string | Connect the TUI to a remote app server endpoint. | | `--remote-auth-token-env ` | — | 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 ...` | `-i` | path | Optional image(s) to attach to the initial prompt | | `-m, --model ` | `-m` | enum | Model the agent should use | | `--oss` | — | boolean | Use open-source provider | | `--local-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 ` | `-p` | path | Configuration profile from config.toml to specify default options | | `--profile-v2 ` | — | path | Layer $DBT\_WIZARD\_HOME/\.config.toml on top of the base user config | | `-s, --sandbox ` | `-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 ` | `-C` | path | Tell the agent to use the specified directory as its working root | | `--add-dir ` | — | path | Additional directories that should be writable alongside the primary workspace | | `-a, --ask-for-approval ` | `-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`](#exec) | `e` | Run wizard non-interactively | | [`review`](#review) | — | Run a code review non-interactively | | [`login`](#login) | — | Manage login | | [`logout`](#logout) | — | Remove stored authentication credentials | | [`mcp`](#mcp) | — | Manage external MCP servers for wizard | | [`plugin`](#plugin) | — | Manage wizard plugins | | [`providers`](#providers) | — | Manage model providers | | [`mcp-server`](#mcp-server) | — | Start wizard as an MCP server (stdio) | | [`app-server`](#app-server) | — | \[experimental] Run the app server or related tooling | | [`remote-control`](#remote-control) | — | \[experimental] Manage the app-server daemon with remote control enabled | | [`completion`](#completion) | — | Generate shell completion scripts | | [`update`](#update) | — | Update wizard to the latest version | | [`doctor`](#doctor) | — | Diagnose local wizard installation, config, auth, and runtime health | | [`sandbox`](#sandbox) | — | Run commands within a wizard-provided sandbox | | [`debug`](#debug) | — | Debugging tools | | [`apply`](#apply) | `a` | Apply the latest diff produced by wizard agent as a `git apply` to your local working tree | | [`resume`](#resume) | — | Resume a previous interactive session (picker by default; use --last to continue the most recent) | | [`fork`](#fork) | — | Fork a previous interactive session (picker by default; use --last to fork the most recent) | | [`cloud`](#cloud) | — | \[EXPERIMENTAL] Browse tasks from wizard in dbt platform and apply changes locally | | [`exec-server`](#exec-server) | — | \[EXPERIMENTAL] Run the standalone exec-server service | | [`features`](#features) | — | Inspect feature flags | ## exec Run wizard non-interactively ```bash wizard exec [OPTIONS] [ARGS] ``` **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 ` | `-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 ` | — | string | Enable a feature (repeatable). Equivalent to `-c features.<name>=true` | | `--disable ` | — | 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 ...` | `-i` | path | Optional image(s) to attach to the initial prompt | | `-m, --model ` | `-m` | enum | Model the agent should use | | `--oss` | — | boolean | Use open-source provider | | `--local-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 ` | `-p` | path | Configuration profile from config.toml to specify default options | | `--profile-v2 ` | — | path | Layer $DBT\_WIZARD\_HOME/\.config.toml on top of the base user config | | `-s, --sandbox ` | `-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 ` | `-C` | path | Tell the agent to use the specified directory as its working root | | `--add-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 ` | — | path | Path to a JSON Schema file describing the model's final response shape | | `--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 ` | `-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 ` | `-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 ` | — | string | Enable a feature (repeatable). Equivalent to `-c features.<name>=true` | | `--uncommitted` | — | boolean | Review staged, unstaged, and untracked changes | | `--base ` | — | string | Review changes against the given base branch | | `--disable ` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=false` | | `--commit ` | — | string | Review the changes introduced by a commit | | `--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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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.<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 | ## 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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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.<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 | ## 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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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.<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) | | `--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.<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) | | `--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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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.<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 | ## 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.<name>=true` | | `--disable <FEATURE>` | — | string | Disable a feature (repeatable). Equivalent to `-c features.<name>=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. ```shell # 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 ``` * **Review your changes** `wizard review` runs a code review without starting an interactive session. ```shell # Review staged, unstaged, and untracked changes wizard review --uncommitted # Review your branch against main wizard review --base main ``` * **Resume a session** ```shell # Continue your most recent session wizard resume --last # Pick from a list of past sessions wizard resume ``` * **Override a config value** Use `-c` to override any value from `~/.dbt/wizard/config.toml` for a single run, without editing the file. ```shell # Set the model for this run only wizard exec -c model="dbt/gpt-5.5" "your prompt" ``` ## Related docs * [Slash command reference](./wizard-slash-commands.md) for interactive TUI slash commands * [Headless mode](./wizard-headless.md) * [Configuration reference](./wizard-config.md) * [dbt command reference](../../reference/dbt-commands.md) for `dbt run`, `dbt build`, and other dbt Core commands ## Was this page helpful? YesNo [Privacy policy](https://www.getdbt.com/cloud/privacy-policy)[Create a GitHub issue](https://github.com/dbt-labs/docs.getdbt.com/issues) This site is protected by reCAPTCHA and the Google [Privacy Policy](https://policies.google.com/privacy) and [Terms of Service](https://policies.google.com/terms) apply.