Конфигурация и файлы

Waibee Code читает конфигурацию из двух каталогов: собственного **`.waibee/`** и совместимого с Claude Code **`.claude/`**. Оба ищутся в двух местах: в проекте и глобально в домашнем каталоге (`~`). При совпадении приоритет такой: проект важнее глобального, `.waibee/` важнее `.claude/`. ## Файлы-инструкции Инструкции это Markdown, который агент подмешивает в системный промпт. Собственный аналог `CLAUDE.md` у Waibee Code называется **`WAIBEE.md`**. Файлы Claude Code при этом читаются без изменений. Файлы загружаются от корня репозитория к вложенным каталогам, затем глобальные. Порядок имён: | Файл | Расположение | Назначение | |---|---|---| | `WAIBEE.md` | корень проекта | Основные инструкции проекта, нативный формат | | `WAIBEE.local.md` | корень проекта | Личные инструкции, обычно в `.gitignore` | | `CLAUDE.md`, `CLAUDE.local.md` | корень проекта | Инструкции в формате Claude Code | | `AGENTS.md` | корень проекта | Кросс-агентный формат инструкций | | `.waibee/WAIBEE.md`, `.waibee/CLAUDE.md` | каталог проекта | Инструкции внутри каталога конфигурации | | `.claude/CLAUDE.md` | каталог проекта | Совместимость с Claude Code | | `~/.waibee/WAIBEE.md`, `~/.waibee/CLAUDE.md`, `~/.claude/CLAUDE.md` | глобально (`~`) | Инструкции для всех проектов | Директива `@<путь>` внутри файла подключает содержимое другого файла (до 5 уровней вложенности). ## Настройки (settings.json) Настройки собираются из пяти слоёв, каждый следующий переопределяет предыдущий: 1. **Глобальный**: `~/.waibee/settings.json` (запасной вариант `~/.claude/settings.json`) 2. **Общий для проекта**: `.mcp.json` в корне, коммитится в репозиторий 3. **Проектный**: `<проект>/.waibee/settings.json` (запасной `.claude/settings.json`) 4. **Локальный**: `<проект>/.waibee/settings.local.json`, личный, в `.gitignore` 5. **Управляемый**: файл организации, только для чтения (`/Library/Application Support/waibee/managed.json` на macOS, `/etc/waibee/managed.json` на Linux, `C:\ProgramData\waibee\managed.json` на Windows) В `settings.json` хранятся [MCP-серверы](/code/mcp/), [права доступа](/code/permissions/), [хуки](/code/hooks/), сжатие контекста (`compaction`), ключ веб-поиска и прочие параметры. ## Память Агент ведёт собственную память отдельно от твоих инструкций, тоже в Markdown: | Файл | Что хранит | |---|---| | `~/.waibee/memory/USER.md` | Факты о тебе: предпочтения, роль, стиль | | `<проект>/.waibee/memory/MEMORY.md` | Факты об этом проекте | Память правится командой `/memory` в TUI и пополняется агентом по ходу работы автоматически (по умолчанию включено, отключается параметром `memory.auto`). Никаких embeddings и внешних баз: только файлы на диске. ## Исключение путей Файл **`.waibeeignore`** в корне проекта исключает пути из чтения и поиска. Формат как у `.gitignore`. Часть правил действует и без этого файла: `.git`, `.env*` (кроме `.env.example` и `.env.sample`), `*.pem`, `id_rsa*`, `id_ed25519*`, `.ssh/`, `.netrc`, `.aws/credentials`. Секреты закрыты по умолчанию, чтобы инструкция из внешнего источника не смогла вытащить их через чтение файла. Твои правила идут после стандартных, поэтому строка вида `!.env.local` при необходимости открывает путь обратно. Правила действуют на файловые инструменты агента, но не на команды в шелле: `cat .env`, запущенный агентом, прочитает файл. Остановить это может только запрет команды в [правах доступа](/code/permissions/). ## Каталоги расширений | Каталог | Что содержит | |---|---| | `.waibee/skills/` | Навыки (`SKILL.md`) | | `.waibee/commands/` | Свои slash-команды | | `.waibee/agents/` | Описания субагентов | | `.waibee-plugin/`, `.claude-plugin/` | Плагины (`plugin.json`) | Каждый из них также ищется в `.claude/` и глобально в `~`. Подробнее в разделах [Навыки и команды](/code/skills/) и [Плагины](/code/plugins/).

Waibee Code читает конфигурацию из двух каталогов: собственного .waibee/ и совместимого с Claude Code .claude/. Оба ищутся в двух местах: в проекте и глобально в домашнем каталоге (~). При совпадении приоритет такой: проект важнее глобального, .waibee/ важнее .claude/.

Файлы-инструкции

Инструкции это Markdown, который агент подмешивает в системный промпт. Собственный аналог CLAUDE.md у Waibee Code называется WAIBEE.md. Файлы Claude Code при этом читаются без изменений.

Файлы загружаются от корня репозитория к вложенным каталогам, затем глобальные. Порядок имён:

Файл	Расположение	Назначение
`WAIBEE.md`	корень проекта	Основные инструкции проекта, нативный формат
`WAIBEE.local.md`	корень проекта	Личные инструкции, обычно в `.gitignore`
`CLAUDE.md`, `CLAUDE.local.md`	корень проекта	Инструкции в формате Claude Code
`AGENTS.md`	корень проекта	Кросс-агентный формат инструкций
`.waibee/WAIBEE.md`, `.waibee/CLAUDE.md`	каталог проекта	Инструкции внутри каталога конфигурации
`.claude/CLAUDE.md`	каталог проекта	Совместимость с Claude Code
`~/.waibee/WAIBEE.md`, `~/.waibee/CLAUDE.md`, `~/.claude/CLAUDE.md`	глобально (`~`)	Инструкции для всех проектов

Директива @<путь> внутри файла подключает содержимое другого файла (до 5 уровней вложенности).

Настройки (settings.json)

Настройки собираются из пяти слоёв, каждый следующий переопределяет предыдущий:

Глобальный: ~/.waibee/settings.json (запасной вариант ~/.claude/settings.json)
Общий для проекта: .mcp.json в корне, коммитится в репозиторий
Проектный: <проект>/.waibee/settings.json (запасной .claude/settings.json)
Локальный: <проект>/.waibee/settings.local.json, личный, в .gitignore
Управляемый: файл организации, только для чтения (/Library/Application Support/waibee/managed.json на macOS, /etc/waibee/managed.json на Linux, C:\ProgramData\waibee\managed.json на Windows)

В settings.json хранятся MCP-серверы, права доступа, хуки, сжатие контекста (compaction), ключ веб-поиска и прочие параметры.

Память

Агент ведёт собственную память отдельно от твоих инструкций, тоже в Markdown:

Файл	Что хранит
`~/.waibee/memory/USER.md`	Факты о тебе: предпочтения, роль, стиль
`<проект>/.waibee/memory/MEMORY.md`	Факты об этом проекте

Память правится командой /memory в TUI и пополняется агентом по ходу работы автоматически (по умолчанию включено, отключается параметром memory.auto). Никаких embeddings и внешних баз: только файлы на диске.

Исключение путей

Файл .waibeeignore в корне проекта исключает пути из чтения и поиска. Формат как у .gitignore.

Часть правил действует и без этого файла: .git, .env* (кроме .env.example и .env.sample), *.pem, id_rsa*, id_ed25519*, .ssh/, .netrc, .aws/credentials. Секреты закрыты по умолчанию, чтобы инструкция из внешнего источника не смогла вытащить их через чтение файла. Твои правила идут после стандартных, поэтому строка вида !.env.local при необходимости открывает путь обратно.

Правила действуют на файловые инструменты агента, но не на команды в шелле: cat .env, запущенный агентом, прочитает файл. Остановить это может только запрет команды в правах доступа.

Каталоги расширений

Каталог	Что содержит
`.waibee/skills/`	Навыки (`SKILL.md`)
`.waibee/commands/`	Свои slash-команды
`.waibee/agents/`	Описания субагентов
`.waibee-plugin/`, `.claude-plugin/`	Плагины (`plugin.json`)

Каждый из них также ищется в .claude/ и глобально в ~. Подробнее в разделах Навыки и команды и Плагины.