CLI

Параметры и команда HanuBees CLI.

CLI HanuBees по умолчанию запускает TUI при запуске без каких-либо аргументов.

HanuBees

Но он также принимает команды, описанные на этой странице. Это позволяет вам программно взаимодействовать с HanuBees.

HanuBees run "Explain how closures work in JavaScript"

tui

Запустите TUI HanuBees.

HanuBees [project]

Флаги

Флаг	Короткий	Описание
`--continue`	`-c`	Продолжить последний сеанс
`--session`	`-s`	Идентификатор сеанса для продолжения
`--fork`		Разветвить сеанс при продолжении (используйте с `--continue` или `--session`)
`--prompt`		Промпт для использования
`--model`	`-m`	Модель для использования в виде поставщика/модели.
`--agent`		Агент для использования
`--port`		Порт для прослушивания
`--hostname`		Имя хоста для прослушивания

Команды

CLI HanuBees также имеет следующие команды.

agent

Управляйте агентами для HanuBees.

HanuBees agent [command]

attach

Подключите терминал к уже работающему внутреннему серверу HanuBees, запущенному с помощью команд serve или web.

HanuBees attach [url]

Это позволяет использовать TUI с удаленным сервером HanuBees. Например:

# Start the backend server for web/mobile access
HanuBees web --port 4096 --hostname 0.0.0.0

# In another terminal, attach the TUI to the running backend
HanuBees attach http://10.20.30.40:4096

Флаги

Флаг	Короткий	Описание
`--dir`		Рабочий каталог для запуска TUI
`--continue`	`-c`	Продолжить последний сеанс
`--session`	`-s`	Идентификатор сеанса для продолжения
`--fork`		Создать ответвление сеанса при продолжении (используйте с `--continue` или `--session`)
`--password`	`-p`	Пароль базовой аутентификации (по умолчанию `HanuBees_SERVER_PASSWORD`)
`--username`	`-u`	Имя пользователя базовой аутентификации (по умолчанию `HanuBees_SERVER_USERNAME` или `HanuBees`)

create

Создайте нового агента с пользовательской конфигурацией.

HanuBees agent create

Эта команда поможет вам создать новый агент с настраиваемой системной подсказкой и настройкой инструмента.

list

Перечислите всех доступных агентов.

HanuBees agent list

auth

Команда для управления учетными данными и входом в систему для провайдеров.

HanuBees auth [command]

HanuBees использует список провайдеров с Models.dev, поэтому вы можете использовать HanuBees auth login для настройки ключей API для любого поставщика, которого вы хотите использовать. Это хранится в ~/.local/share/HanuBees/auth.json.

HanuBees auth login

Когда HanuBees запускается, он загружает поставщиков из файла учетных данных. И если в ваших средах определены какие-либо ключи или файл .env в вашем проекте.

list

Перечисляет всех проверенных поставщиков, которые хранятся в файле учетных данных.

HanuBees auth list

Или короткая версия.

HanuBees auth ls

logout

Выключает вас из провайдера, удаляя его из файла учетных данных.

HanuBees auth logout

github

Управляйте агентом GitHub для автоматизации репозитория.

HanuBees github [command]

install

Установите агент GitHub в свой репозиторий.

HanuBees github install

Это настроит необходимый рабочий процесс GitHub Actions и проведет вас через процесс настройки. Подробнее.

run

Запустите агент GitHub. Обычно это используется в действиях GitHub.

HanuBees github run

Флаги

Флаг	Описание
`--event`	Имитирующее событие GitHub для запуска агента
`--token`	Токен личного доступа GitHub

mcp

Управляйте серверами протокола контекста модели.

HanuBees mcp [command]

add

Добавьте сервер MCP в свою конфигурацию.

HanuBees mcp add

Эта команда поможет вам добавить локальный или удаленный сервер MCP.

list

Перечислите все настроенные серверы MCP и состояние их подключения.

HanuBees mcp list

Или используйте короткую версию.

HanuBees mcp ls

auth

Аутентификация с помощью сервера MCP с поддержкой OAuth.

HanuBees mcp auth [name]

Если вы не укажете имя сервера, вам будет предложено выбрать один из доступных серверов с поддержкой OAuth.

Вы также можете перечислить серверы с поддержкой OAuth и их статус аутентификации.

HanuBees mcp auth list

Или используйте короткую версию.

HanuBees mcp auth ls

logout

Удалите учетные данные OAuth для сервера MCP.

HanuBees mcp logout [name]

debug

Отладка проблем с подключением OAuth для сервера MCP.

HanuBees mcp debug <name>

models

Перечислите все доступные модели от настроенных поставщиков.

HanuBees models [provider]

Эта команда отображает все модели, доступные у настроенных вами поставщиков, в формате provider/model.

Это полезно для определения точного названия модели, которое будет использоваться в вашем config.

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

HanuBees models anthropic

Флаги

Флаг	Описание
`--refresh`	Обновите кеш моделей на сайте models.dev.
`--verbose`	Используйте более подробный вывод модели (включая метаданные, такие как затраты).

Используйте флаг --refresh для обновления списка кэшированных моделей. Это полезно, когда к поставщику добавлены новые модели и вы хотите увидеть их в HanuBees.

HanuBees models --refresh

run

Запустите HanuBees в неинтерактивном режиме, передав приглашение напрямую.

HanuBees run [message..]

Это полезно для создания сценариев, автоматизации или когда вам нужен быстрый ответ без запуска полного TUI. Например.

HanuBees run Explain the use of context in Go

Вы также можете подключиться к работающему экземпляру HanuBees serve, чтобы избежать холодной загрузки сервера MCP при каждом запуске:

# Start a headless server in one terminal
HanuBees serve

# In another terminal, run commands that attach to it
HanuBees run --attach http://localhost:4096 "Explain async/await in JavaScript"

Флаги

Флаг	Короткий	Описание
`--command`		Команда для запуска, используйте сообщение для аргументов
`--continue`	`-c`	Продолжить последний сеанс
`--session`	`-s`	Идентификатор сеанса для продолжения
`--fork`		Разветвить сеанс при продолжении (используйте с `--continue` или `--session`)
`--share`		Поделиться сеансом
`--model`	`-m`	Модель для использования в виде поставщика/модели.
`--agent`		Агент для использования
`--file`	`-f`	Файл(ы) для прикрепления к сообщению
`--format`		Формат: по умолчанию (отформатированный) или json (необработанные события JSON).
`--title`		Название сеанса (использует усеченное приглашение, если значение не указано)
`--attach`		Подключитесь к работающему серверу HanuBees (например, http://localhost:4096)
`--password`	`-p`	Пароль базовой аутентификации (по умолчанию `HanuBees_SERVER_PASSWORD`)
`--username`	`-u`	Имя пользователя базовой аутентификации (по умолчанию `HanuBees_SERVER_USERNAME` или `HanuBees`)
`--dir`		Каталог для выполнения или путь на удалённом сервере при подключении
`--variant`		Вариант модели (уровень рассуждений для провайдера)
`--thinking`		Показать блоки размышлений
`--port`		Порт локального сервера (по умолчанию случайный порт)

serve

Запустите автономный сервер HanuBees для доступа к API. Полный HTTP-интерфейс можно найти в server docs.

HanuBees serve

При этом запускается HTTP-сервер, который обеспечивает доступ API к функциям HanuBees без интерфейса TUI. Установите HanuBees_SERVER_PASSWORD, чтобы включить базовую аутентификацию HTTP (имя пользователя по умолчанию — HanuBees).

Флаги

Флаг	Описание
`--port`	Порт для прослушивания
`--hostname`	Имя хоста для прослушивания
`--mdns`	Включить обнаружение mDNS
`--cors`	Дополнительные источники браузера, позволяющие разрешить CORS

session

Управляйте сессиями HanuBees.

HanuBees session [command]

list

Перечислите все сеансы HanuBees.

HanuBees session list

Флаги

Флаг	Короткий	Описание
`--max-count`	`-n`	Ограничить N последних сеансов.
`--format`		Формат вывода: таблица или json (таблица)

stats

Покажите статистику использования токенов и затрат для ваших сеансов HanuBees.

HanuBees stats

Флаги

Флаг	Описание
`--days`	Показать статистику за последние N дней (все время)
`--tools`	Количество инструментов для отображения (все)
`--models`	Показать разбивку по использованию модели (по умолчанию скрыто). Передайте номер, чтобы показать верхнюю N
`--project`	Фильтровать по проекту (все проекты, пустая строка: текущий проект)

export

Экспортируйте данные сеанса в формате JSON.

HanuBees export [sessionID]

Если вы не укажете идентификатор сеанса, вам будет предложено выбрать один из доступных сеансов.

import

Импортируйте данные сеанса из файла JSON или URL-адреса общего ресурса HanuBees.

HanuBees import <file>

Вы можете импортировать из локального файла или URL-адреса общего ресурса HanuBees.

HanuBees import session.json
HanuBees import https://opncd.ai/s/abc123

web

Запустите автономный сервер HanuBees с веб-интерфейсом.

HanuBees web

При этом запускается HTTP-сервер и открывается веб-браузер для доступа к HanuBees через веб-интерфейс. Установите HanuBees_SERVER_PASSWORD, чтобы включить базовую аутентификацию HTTP (имя пользователя по умолчанию — HanuBees).

Флаги

Флаг	Описание
`--port`	Порт для прослушивания
`--hostname`	Имя хоста для прослушивания
`--mdns`	Включить обнаружение mDNS
`--cors`	Дополнительные источники браузера, позволяющие разрешить CORS

acp

Запустите сервер ACP (агент-клиентский протокол).

HanuBees acp

Эта команда запускает сервер ACP, который обменивается данными через stdin/stdout с использованием nd-JSON.

Флаги

Флаг	Описание
`--cwd`	Рабочий каталог
`--port`	Порт для прослушивания
`--hostname`	Имя хоста для прослушивания

uninstall

Удалите HanuBees и удалите все связанные файлы.

HanuBees uninstall

Флаги

Флаг	Короткий	Описание
`--keep-config`	`-c`	Сохраняйте файлы конфигурации
`--keep-data`	`-d`	Храните данные сеанса и снимки
`--dry-run`		Покажите, что было бы удалено без удаления
`--force`	`-f`	Пропустить запросы подтверждения

upgrade

Обновляет HanuBees до последней версии или определенной версии.

HanuBees upgrade [target]

Чтобы обновиться до последней версии.

HanuBees upgrade

Для обновления до определенной версии.

HanuBees upgrade v0.1.48

Флаги

Флаг	Короткий	Описание
`--method`	`-m`	Используемый метод установки: local, npm, pnpm, bun, brew

Глобальные флаги

CLI HanuBees принимает следующие глобальные флаги.

Флаг	Короткий	Описание
`--help`	`-h`	Отобразить справку
`--version`	`-v`	Распечатать номер версии
`--print-logs`		Печать журналов в stderr
`--log-level`		Уровень журнала (DEBUG, INFO, WARN, ERROR)

Переменные среды

HanuBees можно настроить с помощью переменных среды.

Переменная	Тип	Описание
`HanuBees_AUTO_SHARE`	логическое значение	Автоматически делиться сеансами
`HanuBees_GIT_BASH_PATH`	строка	Путь к исполняемому файлу Git Bash в Windows
`HanuBees_CONFIG`	строка	Путь к файлу конфигурации
`HanuBees_TUI_CONFIG`	строка	Путь к файлу конфигурации TUI
`HanuBees_CONFIG_DIR`	строка	Путь к каталогу конфигурации
`HanuBees_CONFIG_CONTENT`	строка	Встроенное содержимое конфигурации json
`HanuBees_DISABLE_AUTOUPDATE`	логическое значение	Отключить автоматическую проверку обновлений
`HanuBees_DISABLE_PRUNE`	логическое значение	Отключить удаление старых данных
`HanuBees_DISABLE_TERMINAL_TITLE`	логическое значение	Отключить автоматическое обновление заголовка терминала
`HanuBees_PERMISSION`	строка	Встроенная конфигурация разрешений json
`HanuBees_DISABLE_DEFAULT_PLUGINS`	логическое значение	Отключить плагины по умолчанию
`HanuBees_DISABLE_LSP_DOWNLOAD`	логическое значение	Отключить автоматическую загрузку LSP-сервера
`HanuBees_ENABLE_EXPERIMENTAL_MODELS`	логическое значение	Включить экспериментальные модели
`HanuBees_DISABLE_AUTOCOMPACT`	логическое значение	Отключить автоматическое сжатие контекста
`HanuBees_DISABLE_CLAUDE_CODE`	логическое значение	Отключить чтение из `.claude` (подсказка + навыки)
`HanuBees_DISABLE_CLAUDE_CODE_PROMPT`	логическое значение	Отключить чтение `~/.claude/CLAUDE.md`
`HanuBees_DISABLE_CLAUDE_CODE_SKILLS`	логическое значение	Отключить загрузку `.claude/skills`
`HanuBees_DISABLE_MODELS_FETCH`	логическое значение	Отключить получение моделей из удаленных источников
`HanuBees_FAKE_VCS`	строка	Поддельный поставщик VCS для целей тестирования
`HanuBees_CLIENT`	строка	Идентификатор клиента (по умолчанию `cli`)
`HanuBees_ENABLE_EXA`	логическое значение	Включить инструменты веб-поиска Exa
`HanuBees_SERVER_PASSWORD`	строка	Включить базовую аутентификацию для `serve`/`web`
`HanuBees_SERVER_USERNAME`	строка	Переопределить имя пользователя базовой аутентификации (по умолчанию `HanuBees`)
`HanuBees_MODELS_URL`	строка	Пользовательский URL-адрес для получения конфигурации модели

Экспериментальные функции

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

Переменная	Тип	Описание
`HanuBees_EXPERIMENTAL`	логическое значение	Включить экспериментальные функции под общим флагом
`HanuBees_EXPERIMENTAL_ICON_DISCOVERY`	логическое значение	Включить обнаружение значков
`HanuBees_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	логическое значение	Отключить копирование при выборе в TUI
`HanuBees_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	число	Таймаут по умолчанию для команд bash в мс
`HanuBees_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	число	Максимальное количество токенов вывода для ответов LLM
`HanuBees_EXPERIMENTAL_FILEWATCHER`	логическое значение	Включить просмотр файлов для всего каталога
`HanuBees_EXPERIMENTAL_OXFMT`	логическое значение	Включить форматтер oxfmt
`HanuBees_EXPERIMENTAL_LSP_TOOL`	логическое значение	Включить экспериментальный инструмент LSP
`HanuBees_EXPERIMENTAL_DISABLE_FILEWATCHER`	логическое значение	Отключить просмотрщик файлов
`HanuBees_EXPERIMENTAL_EXA`	логическое значение	Включить экспериментальные функции Exa
`HanuBees_EXPERIMENTAL_LSP_TY`	логическое значение	Включить TY LSP для файлов python
`HanuBees_EXPERIMENTAL_PLAN_MODE`	логическое значение	Включить режим плана
`HanuBees_EXPERIMENTAL_BACKGROUND_SUBAGENTS`	логическое значение	Включить фоновые задачи субагентов
`HanuBees_EXPERIMENTAL_EVENT_SYSTEM`	логическое значение	Включить экспериментальную систему событий
`HanuBees_EXPERIMENTAL_NATIVE_LLM`	логическое значение	Включить нативный путь запросов LLM
`HanuBees_EXPERIMENTAL_PARALLEL`	логическое значение	Включить параллельное выполнение веб-поиска
`HanuBees_EXPERIMENTAL_SCOUT`	логическое значение	Включить субагент Scout
`HanuBees_EXPERIMENTAL_WORKSPACES`	логическое значение	Включить поддержку рабочих областей