Установка CLI

Требуются Node.js 22.23.4 или новее в ветке 22 и Git. Для первого подключения попросите доступ на чтение к проектам ai/ai-kit и ai/ai-knowledge.

Какой токен создать в GitLab

1. Откройте Personal access tokens.
2. В меню Generate token выберите Legacy token (Generate legacy token, если меню показывает полное название).
3. Назовите токен aikit-mac, задайте срок действия и отметьте только api. Скопируйте токен и вставьте его в скрытый запрос Terminal в следующем блоке.

Эта инструкция использует Legacy PAT для двух операций: npm скачивает @ai/aikit, а Git читает ai/ai-knowledge по HTTPS с правами вашей учётной записи. Отдельный scope read_repository для этого PAT не требуется. Вариант Generate fine-grained token для этой инструкции не проверен. Авторизация npm Registry в GitLab

Для aikit sync админка выдаёт отдельный токен зарегистрированной установки.

Откройте Terminal в папке рабочего проекта. Выполните оба блока в одной вкладке.

1. Настройте доступ

Вставьте блок целиком, затем введите токен в приглашении Terminal. Ввод скрыт.

{
  read -rs 'AIKIT_NPM_TOKEN?Токен GitLab: ' </dev/tty &&
  printf '\n' &&
  test -n "$AIKIT_NPM_TOKEN" &&
  export AIKIT_NPM_TOKEN &&
  npm config set --location=user \
    '@ai:registry=https://gitlab.infra.comin.io/api/v4/projects/9/packages/npm/' \
    '//gitlab.infra.comin.io/api/v4/projects/9/packages/npm/:_authToken=${AIKIT_NPM_TOKEN}' &&
  npm install -g @ai/aikit@0.1.4
}

npm сохраняет адрес реестра и ссылку на переменную в ~/.npmrc. В этой вкладке aikit использует тот же токен для первого клонирования базы, если у Git ещё нет доступа.

2. Установите скилл и проверьте подключение

aikit install knowledge-access &&
aikit doctor

В результате doctor должны быть installed: true и knowledgeAvailable: true.

Сборка из исходников

Требуются Node.js 22.23.4+ в пределах 22.x, pnpm 10 и доступ к командному GitLab.

git clone https://gitlab.infra.comin.io/ai/ai-kit.git
cd ai-kit
pnpm install --frozen-lockfile
pnpm check
pnpm test
pnpm build
pnpm aikit --help

После сборки CLI можно запускать как node /path/to/ai-kit/packages/cli/bin/aikit.js. Команда install устанавливает включённый в выпуск пакет knowledge-access.