Установка и обновление Veai CLI

Поддерживаемые платформы

Платформа	Обозначение
Windows x64 (Windows 10 версии 1803 или новее)	`win32-x64`
Linux x64 (glibc)	`linux-x64`
macOS на Intel	`darwin-x64`
macOS на Apple Silicon	`darwin-arm64`

Linux на ARM и дистрибутивы на musl, например Alpine, не поддерживаются.

Установка

Установщику не нужны Node.js, npm и права администратора. Он скачивает нужную версию Node.js, проверяет её контрольную сумму и устанавливает агента в домашний каталог пользователя.

Windows (PowerShell):

irm https://veai.ru/cli/install.ps1 | iex

Linux и macOS:

curl --proto '=https' --tlsv1.2 -fsSL https://veai.ru/cli/install.sh | sh

На Linux и macOS установщику нужны curl или wget, tar и sha256sum или shasum.

Установщик создаёт команду veai в ~/.local/bin (на Windows — veai.cmd в %USERPROFILE%\.local\bin) и добавляет этот каталог в PATH. На Windows каталог добавляется в переменную PATH пользователя. На Linux и macOS установщик предлагает дописать в профиль оболочки строку:

export PATH="$HOME/.local/bin:$PATH"

Если терминал не интерактивный, установщик только выведет эту строку, и её нужно добавить в профиль вручную.

Повторный запуск установщика или команда veai install обновляют существующую установку.

Установка через npm

Пакет опубликован в npm как @veai-ru/ai-agent и требует Node.js 22 или новее. Чтобы один раз запустить конкретную версию без установки, используйте npx:

npx -y @veai-ru/ai-agent@<версия>          # запустить агента
npx -y @veai-ru/ai-agent@<версия> login    # сохранить учётные данные

Для постоянной работы используйте установщик. Глобальная установка npm i -g @veai-ru/ai-agent не обновляется автоматически. Если такая копия стоит в PATH раньше команды из установщика, установщик сообщит о конфликте и предложит её удалить.

Вход и выход

Войти можно прямо в сессии командой /login (см. быстрый старт) или из командной строки:

veai login     # сохранить учётные данные провайдера
veai logout    # удалить сохранённые учётные данные

Учётные данные и сессии Veai CLI хранятся отдельно от других агентов, поэтому войти нужно один раз именно в Veai CLI.

Обновления

Обновления устанавливаются автоматически:

при каждом запуске агент проверяет, вышла ли новая версия в его канале, а во время работы повторяет проверку каждые 4 часа;
новая версия скачивается и устанавливается в фоне, а текущая сессия продолжает работать на прежней версии;
новая версия используется со следующего запуска. Чтобы продолжить текущую сессию уже на ней, выйдите и запустите veai --continue.

Пока идёт установка, агент показывает это жёлтым сообщением. Сессию можно закрыть: установка продолжится. Если обновление не удалось, агент назовёт файл журнала install/last-update.log в каталоге установки.

Чтобы обновиться сразу, выполните:

veai update

Узнать установленную версию можно командой veai --version.

Каналы и автообновление

Настройки обновления меняются командой veai config:

Параметр	Значения	По умолчанию	Назначение
`updateChannel`	`stable`, `dogfood`	`stable`	`stable` — стабильные релизы, `dogfood` — предварительные версии
`autoUpdate`	`true`, `false`	`true`	`false` отключает фоновую проверку обновлений. `veai update` продолжает работать

veai config set autoUpdate false
veai config get updateChannel

Канал dogfood предназначен для тестирования предварительных версий. Они входят в отдельный тестовый личный кабинет, поэтому после переключения на dogfood нужно ещё раз выполнить veai login. Если вернуться на stable, CLI останется на текущей, более новой версии, пока стабильный канал её не догонит. Чтобы сразу установить стабильную версию, выполните:

veai update --channel stable --allow-downgrade

Работа без фоновых сетевых запросов

Переменная окружения VEAI_OFFLINE=1 (подходят также true и yes) отключает запросы, которые агент делает сам:

проверку и фоновую установку обновлений;
обновление каталога моделей. После входа в аккаунт список моделей остаётся таким, каким был сохранён в последний раз.

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

Где хранятся файлы

Настройки, которые вы меняете сами, хранятся в папке .veai/:

~/.veai/                     настройки, правила, скиллы, MCP-серверы для всех проектов
<проект>/.veai/              то же для одного проекта

Подробнее — в разделе «Настройка Veai CLI».

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

<root> = $XDG_DATA_HOME/veai-ai-agent
         по умолчанию ~/.local/share/veai-ai-agent,
         на Windows %USERPROFILE%\.local\share\veai-ai-agent

<root>/agent/             учётные данные, сессии, настройки движка
<root>/node/<версия>/     Node.js, на котором работает агент
<root>/install/           установленные версии и журнал обновлений
~/.local/bin/veai         команда для терминала (на Windows veai.cmd)

Не меняйте файлы в <root>/install/ и <root>/node/ вручную: ими управляет установщик.

Эта установка общая для терминала и плагина Veai для IDE.

Удаление

Отдельной команды удаления нет. Установка общая с плагином Veai для IDE, поэтому, если вы пользуетесь плагином, удаляйте только команду veai (шаг 2).

Чтобы полностью удалить Veai CLI вручную:

Закройте все сессии veai.
Удалите команду ~/.local/bin/veai (на Windows — %USERPROFILE%\.local\bin\veai.cmd).
Удалите каталог <root> — ~/.local/share/veai-ai-agent (на Windows — %USERPROFILE%\.local\share\veai-ai-agent). Вместе с ним удалятся сохранённые учётные данные и история сессий.
При желании удалите строку export PATH="$HOME/.local/bin:$PATH" из профиля оболочки. Не удаляйте её, если в ~/.local/bin есть другие программы.
Если настройки больше не нужны, удалите папку ~/.veai.

Поддерживаемые платформы​

Установка​

Установка через npm​

Вход и выход​

Обновления​

Каналы и автообновление​

Работа без фоновых сетевых запросов​

Где хранятся файлы​

Удаление​