vibe держит собственные файлы в одной папке в вашей домашней директории и читает несколько переменных окружения. Эта страница перечисляет содержимое папки, каждую переменную и то, что побеждает, когда они расходятся.
| Путь | Что держит |
| `~/.vibe/cache/` | машинное хранилище скачанных пакетов, по идентичности |
| `~/.vibe/registries/` | git-клоны реестров, используемые для скачивания пакетов |
| `~/.vibe/opt/` | установленные версии vibe, их лаунчеры в `opt/bin/` и скачанная оболочка читалки |
| `~/.vibe/registry.toml` | машинные реестры, зеркала и переопределения, подмешиваемые после проектных |
| `~/.vibe/config.toml` | пользовательская конфигурация: `[env]`, `[install]`, `[net]` |
| `~/.vibe/settings.toml` | ваши предпочтения приложения, первый из трёх слоёв |
| `~/.vibe/<host>.publish.token`, `~/.vibe/git.publish.token` | токены публикации, доступные для чтения только вам; никогда не печатаются, никогда не копируются |
| `~/.vibe/search-cache/` | кэшированные результаты поиска со сроком жизни |
На Windows папка — `%USERPROFILE%\.vibe\`. Старое место под `~/.vibevm/` не читается никогда; перенесите всё, что там держали.
| Путь | Что держит |
| `.vibe/settings.toml` | общие предпочтения команды, закоммичены; второй слой |
| `.vibe/settings.local.toml` | ваша тонкая настройка для одного проекта, игнорируется git; третий слой |
| `.vibe/lifecycle.toml`, `.vibe/trace/`, `.vibe/agentic/` | отпечатки жизненного цикла, трассы компиляции и почтовый ящик эстафеты агента; машинное состояние, не коммитится |
Предпочтения сливаются слой за слоем: скаляр из более высокого слоя заменяет, таблицы сливаются глубоко, массивы заменяются целиком. `vibe prefs list` показывает каждое разрешённое значение с его происхождением, `vibe prefs show-origins` — [вклад](../glossary/index.xml#contribution) каждого слоя, а `vibe prefs set` пишет один ключ в один слой.
Три слоя: машина, `~/.vibe/settings.toml`, репозиторий, `.vibe/settings.toml`, и ваша собственная копия для одного проекта, `.vibe/settings.local.toml`, которую `vibe init` добавляет в `.gitignore`, чтобы она никогда не закоммитилась случайно. Старшинство между ними — один фиксированный закон, записанный в бинарнике. Отсутствующий или сломанный файл считается отсутствующим с предупреждением, никогда не ошибкой. Каждый ключ объявлен с типом и умолчанием, а неизвестный ключ — громкое предупреждение на старте и в `vibe prefs check`. Эти файлы держат то, как vibe выглядит и ведёт себя для вас; свойства проекта живут в манифесте, а закоммиченный файл настроек не может нести секретов. Команды: `vibe prefs get`, `set` с `--layer`, `list`, `check`, `migrate` и `show-origins`.
`vibe prefs` без аргументов открывает экран настроек в терминале: дерево страниц слева, отрисованное тем же виджетом, что и `vibe tree`, и форма справа. Правка поля пишет в слой, который вы выбираете: по умолчанию ваш собственный проектный слой внутри проекта и машинный слой вне его. Поле по запросу показывает происхождение, побеждающий слой и затенённые, а задать или очистить можно один слой, не трогая остальные. Поиск находит настройки по ключу, имени, описанию и синонимам.
| Переменная | Эффект |
| `VIBE_SETTINGS` | переносит всю папку `~/.vibe/` по заданному пути, используемому как есть |
| `VIBE_REGISTRY_CACHE` | переносит кэш клонов реестров |
| `VIBE_OFFLINE` | запрещает доступ к сети, как `--offline`; истинные значения `1`, `true`, `yes`, `on` |
| `VIBE_INVOKED_BY` | называет вызывающего агента, как `--invoked-by`; проставляется в каждый JSON-отчёт |
| `VIBE_UNATTENDED` | отвечает на все подтверждения и отказывает мастерам, как `--unattended` |
| `VIBE_NO_DEFAULT_REGISTRY` | игнорирует встроенный реестр vibe, собранного из исходников |
| `VIBEVM_INDEX_URL_<REGISTRY>` | расположение индекса одного реестра; `none` выключает его индекс |
| `VIBEVM_REGISTRY_TOKEN_<HOST>` | токен, который читает реестр с `auth = "token-env"` |
| `VIBEVM_PUBLISH_TOKEN` | токен публикации; побеждает файлы токенов |
| `VIBEVM_HOME`, `VIBEVM_INSTALL_ROOT` | справочно: где живут установленные версии; истина — собственное расположение работающего бинарника, а `vibe vars diff` показывает, где они расходятся |
| `VIBE_LOG` | фильтр журнала процесса |
Для одной и той же настройки флаг в командной строке побеждает переменную окружения, та побеждает конфигурацию проекта, та — пользовательскую, та — встроенное умолчание. Тот же порядок для [реестров](../glossary/index.xml#registry): список проекта побеждает список машины.
Файлы токенов — поверхностные секреты: ограничьте их своим пользователем, никогда не коммитьте, никогда никуда не вставляйте их содержимое. vibe затирает токен в каждом выводе и ошибке, и дисциплина с вашей стороны та же.
`vibe show config` — вид конфигурации проекта с происхождением каждого значения; `vibe prefs` — файл предпочтений приложения. Это разные файлы и разные команды.