Справочник команд dbt Wizard Бета-версия
Полный справочник всех подкоманд wizard и глобальных флагов.
Эта страница создаётся автоматически и описывает команды и флаги wizard. Сведения о стандартных командах для проектов dbt (dbt run, dbt build, dbt test и т. д.) см. в справочнике команд dbt.
Если вы обнаружите какие-либо проблемы, сообщите о них, и мы с радостью поможем их решить.
Основные команды
Большинству пользователей для начала работы достаточно нескольких команд. Ознакомьтесь с таблицей ниже, а затем обратитесь к остальной части страницы или разделу примеров за дополнительными сведениями.
| Я хочу... | Команда | Что она делает |
|---|---|---|
| Начать интерактивный сеанс | wizard | Открывает интерактивный текстовый интерфейс (TUI), в котором вы общаетесь с агентом. |
| Начать сеанс с заданным запросом | wizard "summarize what this project does" | Открывает TUI с уже отправленным запросом. |
| Выполнить разовую задачу без TUI | wizard exec "add tests to my staging models" | Запускает агента один раз, выводит результат и завершает работу. Подходит для скриптов и CI. |
| Проверить мои незакоммиченные изменения | wizard review --uncommitted | Выполняет ревью кода для изменений, добавленных и не добавленных в индекс, а также для неотслеживаемых файлов. |
| Проверить мою ветку относительно базовой ветки | wizard review --base main | Выполняет ревью кода на основе различий между вашей веткой и базовой веткой. |
| Продолжить с того места, где я остановился | wizard resume --last | Снова открывает ваш последний сеанс с полной историей. |
| Проверить работоспособность установленного инструмента | wizard doctor | Выполняет диагностику установки, конфигурации, аутентификации и среды выполнения. |
| Обновиться до последней версии | wizard update | Обновляет Wizard до последней версии. |
| Применить последние изменения Wizard | wizard apply TASK_ID | Применяет последние изменения Wizard к вашему рабочему каталогу. |
| Войти в учётную запись или выйти из неё | wizard login / wizard logout | Выполняет вход в вашу учётную запись dbt или выход из неё. |
| Подключиться к серверам MCP | wizard mcp add dbt | Устанавливает подключения к серверам MCP. |
Как пользоваться этим справочником
- Флаг — полная запись флага при вводе. Короткие флаги (например,
-m) приведены в столбце «Короткая форма». - Тип —
boolean(наличие/отсутствие),string,pathили перечисление допустимых значений. - Описание — действие флага и ситуации, в которых его следует использовать.
- Глобальные флаги применяются к базовой интерактивной команде
wizard. У подкоманд могут быть другие наборы флагов; при автоматизации используйте раздел соответствующей команды.
Хотите увидеть dbt Wizard в действии? Посмотрите демонстрационное видео.
Нам было бы интересно узнать о вашем опыте работы с dbt Wizard. Поделитесь отзывом, выполнив слеш-команду /feedback в интерактивном сеансе терминала или перейдя в канал #dbt-wizard в Slack-сообществе dbt.
Большое спасибо за помощь в улучшении dbt Wizard и процесса разработки данных с помощью dbt!
Глобальные флаги
Эти флаги работают с базовой интерактивной командой wizard.
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
--remote <ADDR> | — | string | Подключает TUI к конечной точке удалённого сервера приложений. |
--remote-auth-token-env <ENV_VAR> | — | string | Имя переменной окружения, содержащей bearer-токен для отправки по WebSocket удалённому серверу приложений |
--strict-config | — | boolean | Завершает работу с ошибкой, если config.toml содержит поля, не распознаваемые этой версией wizard |
-i, --image <FILE>... | -i | path | Необязательные изображения для прикрепления к начальному запросу |
-m, --model <MODEL> | -m | enum | Модель, которую должен использовать агент |
--oss | — | boolean | Использует провайдера с открытым исходным кодом |
--local-provider <OSS_PROVIDER> | — | enum | Указывает, какого локального провайдера использовать (lmstudio или ollama). Если при использовании --oss провайдер не указан, используется значение по умолчанию из конфигурации или предлагается выбор |
-p, --profile <CONFIG_PROFILE> | -p | path | Профиль конфигурации из config.toml, задающий параметры по умолчанию |
--profile-v2 <CONFIG_PROFILE_V2> | — | path | Применяет $DBT_WIZARD_HOME/<name>.config.toml поверх базовой пользовательской конфигурации |
-s, --sandbox <SANDBOX_MODE> | -s | enum | Выбирает политику песочницы для выполнения команд оболочки, сгенерированных моделью |
--dangerously-bypass-approvals-and-sandbox | — | boolean | Пропускает все запросы подтверждения и выполняет команды без песочницы. КРАЙНЕ ОПАСНО. Предназначено исключительно для запуска в средах с внешней изоляцией |
--dangerously-bypass-hook-trust | — | boolean | Запускает включённые хуки, не требуя сохранённого подтверждения доверия к ним для этого вызова. ОПАСНО. Предназначено только для автоматизации, в которой источники хуков уже проверяются |
-C, --cd <DIR> | -C | path | Указывает агенту использовать заданный каталог в качестве корневого рабочего каталога |
--add-dir <DIR> | — | path | Дополнительные каталоги, доступные для записи наряду с основным рабочим пространством |
-a, --ask-for-approval <APPROVAL_POLICY> | -a | enum | Настраивает, когда модели требуется одобрение человека перед выполнением команды |
--search | — | boolean | Включает веб-поиск в реальном времени. При включении модели доступен встроенный инструмент Responses web_search (без одобрения каждого вызова) |
--no-alt-screen | — | boolean | Отключает режим альтернативного экрана |
Команды
| Команда | Псевдонимы | Описание |
|---|---|---|
exec | e | Запускает wizard в неинтерактивном режиме |
review | — | Выполняет проверку кода в неинтерактивном режиме |
login | — | Управляет входом в систему |
logout | — | Удаляет сохранённые учётные данные аутентификации |
mcp | — | Управляет внешними MCP-серверами для wizard |
plugin | — | Управляет плагинами wizard |
providers | — | Управляет провайдерами моделей |
mcp-server | — | Запускает wizard как MCP-сервер (stdio) |
app-server | — | [экспериментально] Запускает сервер приложений или связанные инструменты |
remote-control | — | [экспериментально] Управляет демоном app-server с включённым удалённым управлением |
completion | — | Генерирует скрипты автодополнения для оболочки |
update | — | Обновляет wizard до последней версии |
doctor | — | Диагностирует локальную установку wizard, конфигурацию, аутентификацию и состояние среды выполнения |
sandbox | — | Выполняет команды в песочнице, предоставляемой wizard |
debug | — | Инструменты отладки |
apply | a | Применяет последний diff, созданный агентом wizard, к локальному рабочему дереву с помощью git apply |
resume | — | Возобновляет предыдущий интерактивный сеанс (по умолчанию предлагается выбор; для продолжения последнего сеанса используйте --last) |
fork | — | Создаёт ответвление предыдущего интерактивного сеанса (по умолчанию предлагается выбор; для ответвления последнего сеанса используйте --last) |
cloud | — | [ЭКСПЕРИМЕНТАЛЬНО] Просматривает задачи wizard на платформе dbt и применяет изменения локально |
exec-server | — | [ЭКСПЕРИМЕНТАЛЬНО] Запускает автономную службу exec-server |
features | — | Просматривает флаги функций |
exec
Запускает wizard в неинтерактивном режиме
wizard exec [OPTIONS] <COMMAND> [ARGS]
Аргументы:
| Аргумент | Описание |
|---|---|
[PROMPT] | Начальные инструкции для агента. Если аргумент не указан (или используется -), инструкции считываются из stdin. Если stdin передаётся через конвейер и при этом указан запрос, содержимое stdin добавляется в виде блока <stdin> |
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
--strict-config | — | boolean | Завершает работу с ошибкой, если config.toml содержит поля, не распознаваемые этой версией wizard |
-i, --image <FILE>... | -i | path | Необязательные изображения для прикрепления к начальному запросу |
-m, --model <MODEL> | -m | enum | Модель, которую должен использовать агент |
--oss | — | boolean | Использует провайдера с открытым исходным кодом |
--local-provider <OSS_PROVIDER> | — | enum | Указывает, какого локального провайдера использовать (lmstudio или ollama). Если при использовании --oss провайдер не указан, используется значение по умолчанию из конфигурации или предлагается выбор |
-p, --profile <CONFIG_PROFILE> | -p | path | Профиль конфигурации из config.toml, задающий параметры по умолчанию |
--profile-v2 <CONFIG_PROFILE_V2> | — | path | Применяет $DBT_WIZARD_HOME/<name>.config.toml поверх базовой пользовательской конфигурации |
-s, --sandbox <SANDBOX_MODE> | -s | enum | Выбирает политику песочницы для выполнения команд оболочки, сгенерированных моделью |
--dangerously-bypass-approvals-and-sandbox | — | boolean | Пропускает все запросы подтверждения и выполняет команды без песочницы. КРАЙНЕ ОПАСНО. Предназначено исключительно для запуска в средах с внешней изоляцией |
--dangerously-bypass-hook-trust | — | boolean | Запускает включённые хуки, не требуя сохранённого подтверждения доверия к ним для этого вызова. ОПАСНО. Предназначено только для автоматизации, в которой источники хуков уже проверяются |
-C, --cd <DIR> | -C | path | Указывает агенту использовать заданный каталог в качестве корневого рабочего каталога |
--add-dir <DIR> | — | path | Дополнительные каталоги, доступные для записи наряду с основным рабочим пространством |
--skip-git-repo-check | — | boolean | Разрешает запуск wizard вне репозитория Git |
--ephemeral | — | boolean | Запускает без сохранения файлов сеанса на диск |
--ignore-user-config | — | boolean | Не загружает $DBT_WIZARD_HOME/config.toml; для аутентификации по-прежнему используется DBT_WIZARD_HOME |
--ignore-rules | — | boolean | Не загружает пользовательские или проектные файлы execpolicy .rules |
--output-schema <FILE> | — | path | Путь к файлу JSON Schema, описывающему структуру итогового ответа модели |
--color <COLOR> | — | enum | Задаёт настройки цвета для вывода |
--json | — | boolean | Выводит события в stdout в формате JSONL |
--include-subagent-events | — | boolean | Если задан --json, собирает и выводит события субагентов с идентификаторами их потоков. Для каждого события субагента в строку JSONL добавляется поле sub_agent_thread_id, чтобы потребители могли отличать его от событий основного агента |
--no-validation | — | boolean | Если задан, механизм допуска к проверке всегда отвечает "declined", поэтому субагент проверки никогда не запускается. Полезно для тестирования производительности, когда накладные расходы субагента нежелательны |
-o, --output-last-message <FILE> | -o | path | Задаёт файл, в который следует записать последнее сообщение агента |
review
Выполняет проверку кода в неинтерактивном режиме
Аргументы:
| Аргумент | Описание |
|---|---|
[PROMPT] | Пользовательские инструкции для проверки. Если используется -, считывает из stdin |
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--strict-config | — | boolean | Завершает работу с ошибкой, если config.toml содержит поля, не распознаваемые этой версией wizard |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--uncommitted | — | boolean | Проверяет изменения, добавленные и не добавленные в индекс, а также неотслеживаемые изменения |
--base <BRANCH> | — | string | Проверяет изменения относительно заданной базовой ветки |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
--commit <SHA> | — | string | Проверяет изменения, внесённые коммитом |
--title <TITLE> | — | string | Необязательный заголовок коммита для отображения в сводке проверки |
login
Управляет входом в систему
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
logout
Удаляет сохранённые учётные данные аутентификации
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
mcp
Управляет внешними MCP-серверами для dbt Wizard
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
plugin
Управляет плагинами dbt Wizard
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
providers
Управляет провайдерами моделей
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
mcp-server
Запускает dbt Wizard как MCP-сервер (stdio)
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--strict-config | — | boolean | Завершает работу с ошибкой, если config.toml содержит поля, не распознаваемые этой версией wizard |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
app-server
[экспериментально] Запускает сервер приложений или связанные инструменты
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
--strict-config | — | boolean | Завершает работу с ошибкой, если config.toml содержит поля, не распознаваемые этой версией wizard |
--listen <URL> | — | string | URL транспортной конечной точки. Поддерживаемые значения: stdio:// (по умолчанию), unix://, unix://PATH, ws://IP:PORT, off |
--analytics-default-enabled | — | boolean | Определяет, включена ли аналитика по умолчанию. |
--ws-auth <MODE> | — | enum | Режим аутентификации WebSocket для прослушивания на адресах, отличных от loopback |
--ws-token-file <PATH> | — | path | Абсолютный путь к файлу токена полномочий (capability token) |
--ws-token-sha256 <HEX> | — | string | Хеш SHA-256 токена полномочий в шестнадцатеричном формате |
--ws-shared-secret-file <PATH> | — | path | Абсолютный путь к файлу общего секрета для подписанных bearer-токенов JWT |
--ws-issuer <ISSUER> | — | string | Ожидаемый издатель подписанных bearer-токенов JWT |
--ws-audience <AUDIENCE> | — | string | Ожидаемая аудитория подписанных bearer-токенов JWT |
--ws-max-clock-skew-seconds <SECONDS> | — | string | Максимально допустимое расхождение часов при проверке подписанных bearer-токенов JWT |
remote-control
[экспериментально] Управляет демоном app-server с включённым удалённым управлением
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--json | — | boolean | Выводит машиночитаемый JSON |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
completion
Генерирует скрипты автодополнения для оболочки
Аргументы:
| Аргумент | Описание |
|---|---|
[SHELL] | Оболочка, для которой нужно сгенерировать автодополнение |
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
update
Обновляет dbt Wizard до последней версии
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
doctor
Диагностирует локальную установку dbt Wizard, конфигурацию, аутентификацию и состояние среды выполнения
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--json | — | boolean | Выводит машиночитаемый отчёт с удалёнными конфиденциальными данными |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--summary | — | boolean | Показывает только сгруппированные строки проверок и итоговую сводку с количеством результатов |
--all | — | boolean | Разворачивает длинные списки в подробном выводе для человека |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
--no-color | — | boolean | Отключает цвета ANSI в выводе для человека |
--ascii | — | boolean | Использует метки состояния и разделители ASCII в выводе для человека |
sandbox
Выполняет команды в песочнице, предоставляемой dbt Wizard
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
debug
Инструменты отладки
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
apply
Применяет последний diff, созданный агентом dbt Wizard, к локальному рабочему дереву с помощью git apply
Аргументы:
| Аргумент | Описание |
|---|---|
<TASK_ID> |
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
resume
Возобновляет предыдущий интерактивный сеанс (по умолчанию предлагается выбор; для продолжения последнего сеанса используйте --last)
Аргументы:
| Аргумент | Описание |
|---|---|
[SESSION_ID] | Идентификатор диалога/сеанса (UUID) или имя потока. Если значение удаётся разобрать как UUID, он имеет приоритет. Если аргумент опущен, используйте --last для выбора последнего сохранённого сеанса |
[PROMPT] | Необязательный пользовательский запрос для начала сеанса |
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--last | — | boolean | Продолжает последний сеанс без отображения списка выбора |
--all | — | boolean | Показывает все сеансы (отключает фильтрацию по cwd и показывает столбец CWD) |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
--include-non-interactive | — | boolean | Включает неинтерактивные сеансы в список выбора для возобновления и в выбор с помощью --last |
--remote <ADDR> | — | string | Подключает TUI к конечной точке удалённого сервера приложений. |
--remote-auth-token-env <ENV_VAR> | — | string | Имя переменной окружения, содержащей bearer-токен для отправки по WebSocket удалённому серверу приложений |
--strict-config | — | boolean | Завершает работу с ошибкой, если config.toml содержит поля, не распознаваемые этой версией wizard |
-i, --image <FILE>... | -i | path | Необязательные изображения для прикрепления к начальному запросу |
-m, --model <MODEL> | -m | enum | Модель, которую должен использовать агент |
--oss | — | boolean | Использует провайдера с открытым исходным кодом |
--local-provider <OSS_PROVIDER> | — | enum | Указывает, какого локального провайдера использовать (lmstudio или ollama). Если при использовании --oss провайдер не указан, используется значение по умолчанию из конфигурации или предлагается выбор |
-p, --profile <CONFIG_PROFILE> | -p | path | Профиль конфигурации из config.toml, задающий параметры по умолчанию |
--profile-v2 <CONFIG_PROFILE_V2> | — | path | Применяет $DBT_WIZARD_HOME/<name>.config.toml поверх базовой пользовательской конфигурации |
-s, --sandbox <SANDBOX_MODE> | -s | enum | Выбирает политику песочницы для выполнения команд оболочки, сгенерированных моделью |
--dangerously-bypass-approvals-and-sandbox | — | boolean | Пропускает все запросы подтверждения и выполняет команды без песочницы. КРАЙНЕ ОПАСНО. Предназначено исключительно для запуска в средах с внешней изоляцией |
--dangerously-bypass-hook-trust | — | boolean | Запускает включённые хуки, не требуя сохранённого подтверждения доверия к ним для этого вызова. ОПАСНО. Предназначено только для автоматизации, в которой источники хуков уже проверяются |
-C, --cd <DIR> | -C | path | Указывает агенту использовать заданный каталог в качестве корневого рабочего каталога |
--add-dir <DIR> | — | path | Дополнительные каталоги, доступные для записи наряду с основным рабочим пространством |
-a, --ask-for-approval <APPROVAL_POLICY> | -a | enum | Настраивает, когда модели требуется одобрение человека перед выполнением команды |
--search | — | boolean | Включает веб-поиск в реальном времени. При включении модели доступен встроенный инструмент Responses web_search (без одобрения каждого вызова) |
--no-alt-screen | — | boolean | Отключает режим альтернативного экрана |
fork
Создаёт ответвление предыдущего интерактивного сеанса (по умолчанию предлагается выбор; для ответвления последнего сеанса используйте --last)
Аргументы:
| Аргумент | Описание |
|---|---|
[SESSION_ID] | Идентификатор диалога/сеанса (UUID). Если указан, создаёт ответвление этого сеанса. Если аргумент опущен, используйте --last для выбора последнего сохранённого сеанса |
[PROMPT] | Необязательный пользовательский запрос для начала сеанса |
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--last | — | boolean | Создаёт ответвление последнего сеанса без отображения списка выбора |
--all | — | boolean | Показывает все сеансы (отключает фильтрацию по cwd и показывает столбец CWD) |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
--remote <ADDR> | — | string | Подключает TUI к конечной точке удалённого сервера приложений. |
--remote-auth-token-env <ENV_VAR> | — | string | Имя переменной окружения, содержащей bearer-токен для отправки по WebSocket удалённому серверу приложений |
--strict-config | — | boolean | Завершает работу с ошибкой, если config.toml содержит поля, не распознаваемые этой версией wizard |
-i, --image <FILE>... | -i | path | Необязательные изображения для прикрепления к начальному запросу |
-m, --model <MODEL> | -m | enum | Модель, которую должен использовать агент |
--oss | — | boolean | Использует провайдера с открытым исходным кодом |
--local-provider <OSS_PROVIDER> | — | enum | Указывает, какого локального провайдера использовать (lmstudio или ollama). Если при использовании --oss провайдер не указан, используется значение по умолчанию из конфигурации или предлагается выбор |
-p, --profile <CONFIG_PROFILE> | -p | path | Профиль конфигурации из config.toml, задающий параметры по умолчанию |
--profile-v2 <CONFIG_PROFILE_V2> | — | path | Применяет $DBT_WIZARD_HOME/<name>.config.toml поверх базовой пользовательской конфигурации |
-s, --sandbox <SANDBOX_MODE> | -s | enum | Выбирает политику песочницы для выполнения команд оболочки, сгенерированных моделью |
--dangerously-bypass-approvals-and-sandbox | — | boolean | Пропускает все запросы подтверждения и выполняет команды без песочницы. КРАЙНЕ ОПАСНО. Предназначено исключительно для запуска в средах с внешней изоляцией |
--dangerously-bypass-hook-trust | — | boolean | Запускает включённые хуки, не требуя сохранённого подтверждения доверия к ним для этого вызова. ОПАСНО. Предназначено только для автоматизации, в которой источники хуков уже проверяются |
-C, --cd <DIR> | -C | path | Указывает агенту использовать заданный каталог в качестве корневого рабочего каталога |
--add-dir <DIR> | — | path | Дополнительные каталоги, доступные для записи наряду с основным рабочим пространством |
-a, --ask-for-approval <APPROVAL_POLICY> | -a | enum | Настраивает, когда модели требуется одобрение человека перед выполнением команды |
--search | — | boolean | Включает веб-поиск в реальном времени. При включении модели доступен встроенный инструмент Responses web_search (без одобрения каждого вызова) |
--no-alt-screen | — | boolean | Отключает режим альтернативного экрана |
cloud
[ЭКСПЕРИМЕНТАЛЬНО] Просматривает задачи dbt Wizard на платформе dbt и применяет изменения локально
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
exec-server
[ЭКСПЕРИМЕНТАЛЬНО] Запускает автономную службу exec-server
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--listen <URL> | — | string | URL транспортной конечной точки. Поддерживаемые значения: ws://IP:PORT (по умолчанию), stdio, stdio:// |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--remote <URL> | — | string | Регистрирует этот exec-server как удалённую среду, используя заданный базовый URL |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
--environment-id <ID> | — | string | Идентификатор среды, к которой нужно подключиться при удалённой регистрации |
--name <NAME> | — | string | Понятное человеку имя среды |
--use-agent-identity-auth | — | boolean | Использует аутентификацию Agent Identity из DBT_WIZARD_ACCESS_TOKEN для удалённой регистрации |
features
Просматривает флаги функций
| Флаг | Короткая форма | Тип | Описание |
|---|---|---|---|
-c, --config <key=value> | -c | string | Переопределяет значение конфигурации, которое в противном случае загружается из ~/.dbt/wizard/config.toml. Для переопределения вложенных значений используйте путь с точками (foo.bar.baz). Часть value разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. |
--enable <FEATURE> | — | string | Включает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=true |
--disable <FEATURE> | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно -c features.<name>=false |
Примеры
Ниже приведены примеры и команды, которые могут вам пригодиться. Замените примеры запросов своими:
-
Выполнение задачи без TUI
Используйте
wizard execдля разовых задач, скриптов и CI. Эта команда запускает агента, выводит результат и завершает работу.# 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 -
Проверка ваших изменений
wizard reviewвыполняет ревью кода без запуска интерактивного сеанса.# Review staged, unstaged, and untracked changes
wizard review --uncommitted
# Review your branch against main
wizard review --base main -
Возобновление сеанса
# Continue your most recent session
wizard resume --last
# Pick from a list of past sessions
wizard resume -
Переопределение значения конфигурации
Используйте
-c, чтобы переопределить любое значение из~/.dbt/wizard/config.tomlдля одного запуска, не редактируя файл.# Set the model for this run only
wizard exec -c model="dbt/gpt-5.5" "your prompt"
Связанная документация
- Справочник слеш-команд — слеш-команды для интерактивного TUI
- Режим без интерактивного интерфейса
- Справочник по конфигурации
- Справочник команд dbt —
dbt run,dbt buildи другие команды dbt