Skip to main content
Терминальный интерфейс Yahont CLI Yahont CLI — это терминальный интерфейс для общения с вашими агентами Yahont и запросов к базе знаний. Он написан на Go с использованием Bubble Tea и предлагает как интерактивный TUI, так и неинтерактивные команды для скриптов и автоматизации.

Установка

Или через pip:

Пакет PyPI

uv tool install onyx-cli

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

Требуется Go 1.26+.

Настройка

Запустите интерактивный чат TUI — при первом запуске он проведёт вас через настройку:
Он запросит URL вашего сервера Yahont и персональный токен доступа (PAT), проверит подключение и сохранит конфигурацию в ~/.config/onyx-cli/config.json (или в $XDG_CONFIG_HOME/onyx-cli/config.json, если эта переменная задана). Чтобы позже перенастроить, используйте слэш-команду /configure внутри TUI.

Создание токена доступа

Откройте Настройки > Аккаунты и доступ > Новый токен доступа (/app/settings/accounts-access), чтобы создать токен доступа для CLI. Страница «Аккаунты и доступ» с разделом токенов доступа Окно создания токена доступа с названием токена и параметрами срока действия

Переменные окружения

Переменные окружения переопределяют значения из файла конфигурации. Это удобно для CI/CD и скриптов.

Проверка конфигурации

Проверьте, что конфигурация верна и сервер доступен:

Команды

Интерактивный чат

Открывает полноэкранный терминальный интерфейс для диалога с вашими агентами Yahont.

Разовые вопросы

Задайте вопрос и получите ответ, не заходя в TUI:
Параметр --agent-id позволяет выбрать конкретного агента:
Параметр --json включает структурированный вывод NDJSON (удобно для скриптов):

Список агентов

Выводит таблицу с ID, названиями и описаниями доступных агентов.

Самостоятельное развёртывание

Группа команд deploy устанавливает и обслуживает самостоятельно размещаемое развёртывание Yahont на Docker Compose — это установщик с подсказками, а также команды upgrade, status, logs, stop и uninstall:

Развёртывание с помощью Yahont CLI

Полная документация по onyx-cli deploy и командам жизненного цикла.

Слэш-команды (интерактивный TUI)

В интерактивном чате доступны следующие слэш-команды:

Использование в качестве навыка ИИ-помощника для программирования

Yahont CLI можно использовать как инструмент в ИИ-помощниках для программирования (например, Claude Code и Cursor), чтобы обращаться к вашей базе знаний прямо из среды разработки. Готовое описание навыка есть в репозитории onyx-dot-app/onyx: .cursor/skills/onyx-cli/SKILL.md. После настройки ИИ-помощник может вызывать onyx-cli ask, чтобы получать сведения о вашей компании — политики, внутренние документы, подключённые источники данных — не выходя из редактора.

Когда вызывается навык

Навык срабатывает, когда вы спрашиваете ИИ-помощника о:
  • Сведениях о компании (политики, процессы, документация)
  • Внутренних базах знаний или подключённых источниках данных
  • Чём угодно, что упоминает Yahont, «поиск в Yahont» или запросы к документам компании
Он не используется для общих вопросов по программированию и вопросов о коде в текущем репозитории.

Настройка для агентов

Проще всего один раз вручную запустить onyx-cli chat и пройти первоначальную настройку — после этого ИИ-помощники смогут вызывать onyx-cli ask напрямую без дополнительных действий.
Либо можно настроить через переменные окружения, которые переопределяют файл конфигурации и удобны для CI/CD и изолированных сред:

Вывод JSON для структурного разбора

Используйте --json, чтобы получать события в формате NDJSON — агентам их проще разбирать программно:

Сочетания клавиш