Настройка Veai CLI

Veai CLI настраивается обычными файлами: JSON для настроек и MCP-серверов, Markdown для правил, скиллов и вспомогательных агентов. Все пользовательские файлы лежат в каталоге .veai/.

Агент настроит себя сам

Читать эту документацию перед настройкой не обязательно. Опишите в чате, что нужно, и агент сам создаст или изменит нужный файл:

• «Подключи MCP сервер context7»
• «Создай правило: в этом проекте отвечай на английском»
• «Отключи правило из AGENTS.md в этом проекте»
• «Включи уведомления на рабочем столе»

Агент знает, где лежат файлы и какой у них формат. Эти страницы нужны, чтобы понимать, что именно он поменял, и править файлы вручную.

Глобальная и проектная настройка

У каждого вида настройки два уровня:

• Глобальный — каталог ~/.veai/ в домашней папке. Действует во всех проектах.
• Проектный — каталог .veai/ в корне проекта. Действует только в этом проекте. Проектные файлы можно закоммитить и поделиться ими с командой.

Корень проекта — рабочий каталог, из которого запущен veai. Родительские каталоги не просматриваются: .veai/ уровнем выше проекта не прочитается.

Ни один файл не обязан существовать. Если файла или каталога нет, его можно просто создать — регистрировать его нигде не нужно.

Какие файлы где лежат

~/.veai/settings.json              настройки для всех проектов
~/.veai/rules/**/*.md              правила для всех проектов
~/.veai/skills/<name>/SKILL.md     скиллы для всех проектов
~/.veai/mcp.json                   MCP-серверы для всех проектов
~/.veai/agents/*.md                вспомогательные агенты для всех проектов
~/.veai/models/*.md                профили моделей для всех проектов

<проект>/.veai/settings.json       настройки этого проекта
<проект>/.veai/rules/**/*.md       правила этого проекта
<проект>/.veai/skills/<name>/SKILL.md
<проект>/.veai/mcp.json            MCP-серверы этого проекта
<проект>/.veai/agents/*.md         вспомогательные агенты этого проекта
<проект>/.veai/models/*.md         профили моделей этого проекта

Что настраивается	Файлы	Страница
Язык ответов, режим разрешений, уведомления, внешний вид терминала, отключённые правила и скиллы	settings.json	Настройки
Постоянные инструкции для агента	.veai/rules/**/*.md, а также AGENTS.md и CLAUDE.md	Правила
Повторно используемые инструкции, которые применяются по запросу	.veai/skills/<name>/SKILL.md	Скиллы
Дополнительные инструменты от MCP-серверов	mcp.json	MCP-серверы
Веб-поиск и загрузка страниц	web-search.json в каталоге агента	Веб-поиск

В каталогах agents/ и models/ описываются вспомогательные агенты (роль, инструкции, доступные инструменты) и профили моделей для них. Встроенные агенты — workhorse (вносит изменения), hawkeye (проверяет изменения) и retriever (ищет нужные места в коде).

Файлы вне .veai/

Два вида настроек хранятся не в .veai/:

• Веб-поиск — в файле web-search.json в каталоге агента. Подробнее — на странице «Веб-поиск».
• Настройки самого агента — канал и автоматическое обновление, прогрев кэша, режим терминала. Они лежат в собственном settings.json агента и меняются командой veai config или через /settings в терминале. Подробнее — в разделе «Настройки агента: veai config».

Файлы других инструментов

Veai CLI читает часть файлов других агентов, чтобы существующие инструкции продолжали работать: AGENTS.md, CLAUDE.md и каталоги скиллов .claude/skills, .agents/skills, .cursor/skills и другие. Новые файлы создавайте в .veai/. Настройки и правила в .pi/ относятся к другому продукту: Veai CLI их не применяет.