# Справочник команд dbt Wizard [Бета-версия](https://docs.getdbt.tech/docs/dbt-versions/product-lifecycles "Подробнее о статусе или тарифе") Локальная разработка Полный справочник всех подкоманд `wizard` и глобальных флагов. Не путайте с командами dbt Эта страница создаётся автоматически и описывает команды и флаги `wizard`. Сведения о стандартных командах для проектов dbt (`dbt run`, `dbt build`, `dbt test` и т. д.) см. в [справочнике команд dbt](https://docs.getdbt.tech/reference/dbt-commands.md). Если вы обнаружите какие-либо проблемы, [сообщите о них](https://github.com/dbt-labs/docs.getdbt.com/issues), и мы с радостью поможем их решить. ## Основные команды Большинству пользователей для начала работы достаточно нескольких команд. Ознакомьтесь с таблицей ниже, а затем обратитесь к остальной части страницы или разделу [примеров](#examples) за дополнительными сведениями. | Я хочу... | Команда | Что она делает | | ------------------------------------------------------ | ---------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | | Начать интерактивный сеанс | `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 в действии? Посмотрите [демонстрационное видео](https://www.youtube.com/watch?v=-lIzh1xQWMA). Нам было бы интересно узнать о вашем опыте работы с dbt Wizard. Поделитесь отзывом, выполнив слеш-команду `/feedback` в интерактивном сеансе терминала или перейдя в канал [#dbt-wizard](https://getdbt.slack.com/archives/C0B6KLW6T26) в [Slack-сообществе dbt](https://docs.getdbt.com/community/join?version=2.0). Большое спасибо за помощь в улучшении dbt Wizard и процесса разработки данных с помощью dbt! ## Глобальные флаги Эти флаги работают с базовой интерактивной командой `wizard`. | Флаг | Короткая форма | Тип | Описание | | -------------------------------------------- | -------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `-c, --config ` | `-c` | string | Переопределяет значение конфигурации, которое в противном случае загружается из `~/.dbt/wizard/config.toml`. Для переопределения вложенных значений используйте путь с точками (`foo.bar.baz`). Часть `value` разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. | | `--enable ` | — | string | Включает функцию (можно указать несколько раз). Эквивалентно `-c features.<name>=true` | | `--disable ` | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно `-c features.<name>=false` | | `--remote ` | — | string | Подключает TUI к конечной точке удалённого сервера приложений. | | `--remote-auth-token-env ` | — | string | Имя переменной окружения, содержащей bearer-токен для отправки по WebSocket удалённому серверу приложений | | `--strict-config` | — | boolean | Завершает работу с ошибкой, если config.toml содержит поля, не распознаваемые этой версией wizard | | `-i, --image ...` | `-i` | path | Необязательные изображения для прикрепления к начальному запросу | | `-m, --model ` | `-m` | enum | Модель, которую должен использовать агент | | `--oss` | — | boolean | Использует провайдера с открытым исходным кодом | | `--local-provider ` | — | enum | Указывает, какого локального провайдера использовать (lmstudio или ollama). Если при использовании --oss провайдер не указан, используется значение по умолчанию из конфигурации или предлагается выбор | | `-p, --profile ` | `-p` | path | Профиль конфигурации из config.toml, задающий параметры по умолчанию | | `--profile-v2 ` | — | path | Применяет $DBT\_WIZARD\_HOME/\.config.toml поверх базовой пользовательской конфигурации | | `-s, --sandbox ` | `-s` | enum | Выбирает политику песочницы для выполнения команд оболочки, сгенерированных моделью | | `--dangerously-bypass-approvals-and-sandbox` | — | boolean | Пропускает все запросы подтверждения и выполняет команды без песочницы. КРАЙНЕ ОПАСНО. Предназначено исключительно для запуска в средах с внешней изоляцией | | `--dangerously-bypass-hook-trust` | — | boolean | Запускает включённые хуки, не требуя сохранённого подтверждения доверия к ним для этого вызова. ОПАСНО. Предназначено только для автоматизации, в которой источники хуков уже проверяются | | `-C, --cd ` | `-C` | path | Указывает агенту использовать заданный каталог в качестве корневого рабочего каталога | | `--add-dir ` | — | path | Дополнительные каталоги, доступные для записи наряду с основным рабочим пространством | | `-a, --ask-for-approval ` | `-a` | enum | Настраивает, когда модели требуется одобрение человека перед выполнением команды | | `--search` | — | boolean | Включает веб-поиск в реальном времени. При включении модели доступен встроенный инструмент Responses `web_search` (без одобрения каждого вызова) | | `--no-alt-screen` | — | boolean | Отключает режим альтернативного экрана | ## Команды | Команда | Псевдонимы | Описание | | ----------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------- | | [`exec`](#exec) | `e` | Запускает wizard в неинтерактивном режиме | | [`review`](#review) | — | Выполняет проверку кода в неинтерактивном режиме | | [`login`](#login) | — | Управляет входом в систему | | [`logout`](#logout) | — | Удаляет сохранённые учётные данные аутентификации | | [`mcp`](#mcp) | — | Управляет внешними MCP-серверами для wizard | | [`plugin`](#plugin) | — | Управляет плагинами wizard | | [`providers`](#providers) | — | Управляет провайдерами моделей | | [`mcp-server`](#mcp-server) | — | Запускает wizard как MCP-сервер (stdio) | | [`app-server`](#app-server) | — | \[экспериментально] Запускает сервер приложений или связанные инструменты | | [`remote-control`](#remote-control) | — | \[экспериментально] Управляет демоном app-server с включённым удалённым управлением | | [`completion`](#completion) | — | Генерирует скрипты автодополнения для оболочки | | [`update`](#update) | — | Обновляет wizard до последней версии | | [`doctor`](#doctor) | — | Диагностирует локальную установку wizard, конфигурацию, аутентификацию и состояние среды выполнения | | [`sandbox`](#sandbox) | — | Выполняет команды в песочнице, предоставляемой wizard | | [`debug`](#debug) | — | Инструменты отладки | | [`apply`](#apply) | `a` | Применяет последний diff, созданный агентом wizard, к локальному рабочему дереву с помощью `git apply` | | [`resume`](#resume) | — | Возобновляет предыдущий интерактивный сеанс (по умолчанию предлагается выбор; для продолжения последнего сеанса используйте --last) | | [`fork`](#fork) | — | Создаёт ответвление предыдущего интерактивного сеанса (по умолчанию предлагается выбор; для ответвления последнего сеанса используйте --last) | | [`cloud`](#cloud) | — | \[ЭКСПЕРИМЕНТАЛЬНО] Просматривает задачи wizard на платформе dbt и применяет изменения локально | | [`exec-server`](#exec-server) | — | \[ЭКСПЕРИМЕНТАЛЬНО] Запускает автономную службу exec-server | | [`features`](#features) | — | Просматривает флаги функций | ## exec Запускает wizard в неинтерактивном режиме ```bash wizard exec [OPTIONS] [ARGS] ``` **Аргументы:** | Аргумент | Описание | | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `[PROMPT]` | Начальные инструкции для агента. Если аргумент не указан (или используется `-`), инструкции считываются из stdin. Если stdin передаётся через конвейер и при этом указан запрос, содержимое stdin добавляется в виде блока `<stdin>` | | Флаг | Короткая форма | Тип | Описание | | -------------------------------------------- | -------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `-c, --config ` | `-c` | string | Переопределяет значение конфигурации, которое в противном случае загружается из `~/.dbt/wizard/config.toml`. Для переопределения вложенных значений используйте путь с точками (`foo.bar.baz`). Часть `value` разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. | | `--enable ` | — | string | Включает функцию (можно указать несколько раз). Эквивалентно `-c features.<name>=true` | | `--disable ` | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно `-c features.<name>=false` | | `--strict-config` | — | boolean | Завершает работу с ошибкой, если config.toml содержит поля, не распознаваемые этой версией wizard | | `-i, --image ...` | `-i` | path | Необязательные изображения для прикрепления к начальному запросу | | `-m, --model ` | `-m` | enum | Модель, которую должен использовать агент | | `--oss` | — | boolean | Использует провайдера с открытым исходным кодом | | `--local-provider ` | — | enum | Указывает, какого локального провайдера использовать (lmstudio или ollama). Если при использовании --oss провайдер не указан, используется значение по умолчанию из конфигурации или предлагается выбор | | `-p, --profile ` | `-p` | path | Профиль конфигурации из config.toml, задающий параметры по умолчанию | | `--profile-v2 ` | — | path | Применяет $DBT\_WIZARD\_HOME/\.config.toml поверх базовой пользовательской конфигурации | | `-s, --sandbox ` | `-s` | enum | Выбирает политику песочницы для выполнения команд оболочки, сгенерированных моделью | | `--dangerously-bypass-approvals-and-sandbox` | — | boolean | Пропускает все запросы подтверждения и выполняет команды без песочницы. КРАЙНЕ ОПАСНО. Предназначено исключительно для запуска в средах с внешней изоляцией | | `--dangerously-bypass-hook-trust` | — | boolean | Запускает включённые хуки, не требуя сохранённого подтверждения доверия к ним для этого вызова. ОПАСНО. Предназначено только для автоматизации, в которой источники хуков уже проверяются | | `-C, --cd ` | `-C` | path | Указывает агенту использовать заданный каталог в качестве корневого рабочего каталога | | `--add-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 ` | — | path | Путь к файлу JSON Schema, описывающему структуру итогового ответа модели | | `--color ` | — | enum | Задаёт настройки цвета для вывода | | `--json` | — | boolean | Выводит события в stdout в формате JSONL | | `--include-subagent-events` | — | boolean | Если задан `--json`, собирает и выводит события субагентов с идентификаторами их потоков. Для каждого события субагента в строку JSONL добавляется поле `sub_agent_thread_id`, чтобы потребители могли отличать его от событий основного агента | | `--no-validation` | — | boolean | Если задан, механизм допуска к проверке всегда отвечает "declined", поэтому субагент проверки никогда не запускается. Полезно для тестирования производительности, когда накладные расходы субагента нежелательны | | `-o, --output-last-message ` | `-o` | path | Задаёт файл, в который следует записать последнее сообщение агента | ## review Выполняет проверку кода в неинтерактивном режиме **Аргументы:** | Аргумент | Описание | | ---------- | ----------------------------------------------------------------------------------- | | `[PROMPT]` | Пользовательские инструкции для проверки. Если используется `-`, считывает из stdin | | Флаг | Короткая форма | Тип | Описание | | -------------------------- | -------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `-c, --config ` | `-c` | string | Переопределяет значение конфигурации, которое в противном случае загружается из `~/.dbt/wizard/config.toml`. Для переопределения вложенных значений используйте путь с точками (`foo.bar.baz`). Часть `value` разбирается как TOML. Если разобрать её как TOML не удаётся, исходная строка используется как литерал. | | `--strict-config` | — | boolean | Завершает работу с ошибкой, если config.toml содержит поля, не распознаваемые этой версией wizard | | `--enable ` | — | string | Включает функцию (можно указать несколько раз). Эквивалентно `-c features.<name>=true` | | `--uncommitted` | — | boolean | Проверяет изменения, добавленные и не добавленные в индекс, а также неотслеживаемые изменения | | `--base ` | — | string | Проверяет изменения относительно заданной базовой ветки | | `--disable ` | — | string | Отключает функцию (можно указать несколько раз). Эквивалентно `-c features.<name>=false` | | `--commit ` | — | string | Проверяет изменения, внесённые коммитом | | `--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. Эта команда запускает агента, выводит результат и завершает работу. ```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 ``` * **Проверка ваших изменений** `wizard review` выполняет ревью кода без запуска интерактивного сеанса. ```shell # Review staged, unstaged, and untracked changes wizard review --uncommitted # Review your branch against main wizard review --base main ``` * **Возобновление сеанса** ```shell # Continue your most recent session wizard resume --last # Pick from a list of past sessions wizard resume ``` * **Переопределение значения конфигурации** Используйте `-c`, чтобы переопределить любое значение из `~/.dbt/wizard/config.toml` для одного запуска, не редактируя файл. ```shell # Set the model for this run only wizard exec -c model="dbt/gpt-5.5" "your prompt" ``` ## Связанная документация * [Справочник слеш-команд](https://docs.getdbt.tech/docs/dbt-ai/wizard-slash-commands.md) — слеш-команды для интерактивного TUI * [Режим без интерактивного интерфейса](https://docs.getdbt.tech/docs/dbt-ai/wizard-headless.md) * [Справочник по конфигурации](https://docs.getdbt.tech/docs/dbt-ai/wizard-config.md) * [Справочник команд dbt](https://docs.getdbt.tech/reference/dbt-commands.md) — `dbt run`, `dbt build` и другие команды dbt