CLI

Параметры и команда aicippy-code CLI.

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

aicippy-code

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

aicippy-code run "Explain how closures work in JavaScript"

tui

Запустите TUI aicippy-code.

aicippy-code [project]

Флаги

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

Команды

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

agent

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

aicippy-code agent [command]

attach

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

aicippy-code attach [url]

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

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

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

Флаги

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

create

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

aicippy-code agent create

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

list

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

aicippy-code agent list

auth

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

aicippy-code auth [command]

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

aicippy-code auth login

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

list

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

aicippy-code auth list

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

aicippy-code auth ls

logout

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

aicippy-code auth logout

github

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

aicippy-code github [command]

install

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

aicippy-code github install

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

run

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

aicippy-code github run

Флаги

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

mcp

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

aicippy-code mcp [command]

add

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

aicippy-code mcp add

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

list

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

aicippy-code mcp list

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

aicippy-code mcp ls

auth

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

aicippy-code mcp auth [name]

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

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

aicippy-code mcp auth list

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

aicippy-code mcp auth ls

logout

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

aicippy-code mcp logout [name]

debug

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

aicippy-code mcp debug <name>

models

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

aicippy-code models [provider]

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

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

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

aicippy-code models anthropic

Флаги

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

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

aicippy-code models --refresh

run

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

aicippy-code run [message..]

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

aicippy-code run Explain the use of context in Go

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

# Start a headless server in one terminal
aicippy-code serve

# In another terminal, run commands that attach to it
aicippy-code 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`		Подключитесь к работающему серверу aicippy-code (например, http://localhost:4096)
`--password`	`-p`	Пароль базовой аутентификации (по умолчанию `AICIPPY_CODE_SERVER_PASSWORD`)
`--username`	`-u`	Имя пользователя базовой аутентификации (по умолчанию `AICIPPY_CODE_SERVER_USERNAME` или `aicippy-code`)
`--dir`		Каталог для выполнения или путь на удалённом сервере при подключении
`--variant`		Вариант модели (уровень рассуждений для провайдера)
`--thinking`		Показать блоки размышлений
`--port`		Порт локального сервера (по умолчанию случайный порт)

serve

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

aicippy-code serve

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

Флаги

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

session

Управляйте сессиями aicippy-code.

aicippy-code session [command]

list

Перечислите все сеансы aicippy-code.

aicippy-code session list

Флаги

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

stats

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

aicippy-code stats

Флаги

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

export

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

aicippy-code export [sessionID]

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

import

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

aicippy-code import <file>

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

aicippy-code import session.json
aicippy-code import https://opncd.ai/s/abc123

web

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

aicippy-code web

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

Флаги

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

acp

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

aicippy-code acp

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

Флаги

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

uninstall

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

aicippy-code uninstall

Флаги

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

upgrade

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

aicippy-code upgrade [target]

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

aicippy-code upgrade

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

aicippy-code upgrade v0.1.48

Флаги

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

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

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

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

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

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

Переменная	Тип	Описание
`AICIPPY_CODE_AUTO_SHARE`	логическое значение	Автоматически делиться сеансами
`AICIPPY_CODE_GIT_BASH_PATH`	строка	Путь к исполняемому файлу Git Bash в Windows
`AICIPPY_CODE_CONFIG`	строка	Путь к файлу конфигурации
`AICIPPY_CODE_TUI_CONFIG`	строка	Путь к файлу конфигурации TUI
`AICIPPY_CODE_CONFIG_DIR`	строка	Путь к каталогу конфигурации
`AICIPPY_CODE_CONFIG_CONTENT`	строка	Встроенное содержимое конфигурации json
`AICIPPY_CODE_DISABLE_AUTOUPDATE`	логическое значение	Отключить автоматическую проверку обновлений
`AICIPPY_CODE_DISABLE_PRUNE`	логическое значение	Отключить удаление старых данных
`AICIPPY_CODE_DISABLE_TERMINAL_TITLE`	логическое значение	Отключить автоматическое обновление заголовка терминала
`AICIPPY_CODE_PERMISSION`	строка	Встроенная конфигурация разрешений json
`AICIPPY_CODE_DISABLE_DEFAULT_PLUGINS`	логическое значение	Отключить плагины по умолчанию
`AICIPPY_CODE_DISABLE_LSP_DOWNLOAD`	логическое значение	Отключить автоматическую загрузку LSP-сервера
`AICIPPY_CODE_ENABLE_EXPERIMENTAL_MODELS`	логическое значение	Включить экспериментальные модели
`AICIPPY_CODE_DISABLE_AUTOCOMPACT`	логическое значение	Отключить автоматическое сжатие контекста
`AICIPPY_CODE_DISABLE_CLAUDE_CODE`	логическое значение	Отключить чтение из `.claude` (подсказка + навыки)
`AICIPPY_CODE_DISABLE_CLAUDE_CODE_PROMPT`	логическое значение	Отключить чтение `~/.claude/CLAUDE.md`
`AICIPPY_CODE_DISABLE_CLAUDE_CODE_SKILLS`	логическое значение	Отключить загрузку `.claude/skills`
`AICIPPY_CODE_DISABLE_MODELS_FETCH`	логическое значение	Отключить получение моделей из удаленных источников
`AICIPPY_CODE_FAKE_VCS`	строка	Поддельный поставщик VCS для целей тестирования
`AICIPPY_CODE_CLIENT`	строка	Идентификатор клиента (по умолчанию `cli`)
`AICIPPY_CODE_ENABLE_EXA`	логическое значение	Включить инструменты веб-поиска Exa
`AICIPPY_CODE_SERVER_PASSWORD`	строка	Включить базовую аутентификацию для `serve`/`web`
`AICIPPY_CODE_SERVER_USERNAME`	строка	Переопределить имя пользователя базовой аутентификации (по умолчанию `aicippy-code`)
`AICIPPY_CODE_MODELS_URL`	строка	Пользовательский URL-адрес для получения конфигурации модели

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

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

Переменная	Тип	Описание
`AICIPPY_CODE_EXPERIMENTAL`	логическое значение	Включить экспериментальные функции под общим флагом
`AICIPPY_CODE_EXPERIMENTAL_ICON_DISCOVERY`	логическое значение	Включить обнаружение значков
`AICIPPY_CODE_EXPERIMENTAL_DISABLE_COPY_ON_SELECT`	логическое значение	Отключить копирование при выборе в TUI
`AICIPPY_CODE_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS`	число	Таймаут по умолчанию для команд bash в мс
`AICIPPY_CODE_EXPERIMENTAL_OUTPUT_TOKEN_MAX`	число	Максимальное количество токенов вывода для ответов LLM
`AICIPPY_CODE_EXPERIMENTAL_FILEWATCHER`	логическое значение	Включить просмотр файлов для всего каталога
`AICIPPY_CODE_EXPERIMENTAL_OXFMT`	логическое значение	Включить форматтер oxfmt
`AICIPPY_CODE_EXPERIMENTAL_LSP_TOOL`	логическое значение	Включить экспериментальный инструмент LSP
`AICIPPY_CODE_EXPERIMENTAL_DISABLE_FILEWATCHER`	логическое значение	Отключить просмотрщик файлов
`AICIPPY_CODE_EXPERIMENTAL_EXA`	логическое значение	Включить экспериментальные функции Exa
`AICIPPY_CODE_EXPERIMENTAL_LSP_TY`	логическое значение	Включить TY LSP для файлов python
`AICIPPY_CODE_EXPERIMENTAL_PLAN_MODE`	логическое значение	Включить режим плана
`AICIPPY_CODE_EXPERIMENTAL_BACKGROUND_SUBAGENTS`	логическое значение	Включить фоновые задачи субагентов
`AICIPPY_CODE_EXPERIMENTAL_EVENT_SYSTEM`	логическое значение	Включить экспериментальную систему событий
`AICIPPY_CODE_EXPERIMENTAL_NATIVE_LLM`	логическое значение	Включить нативный путь запросов LLM
`AICIPPY_CODE_EXPERIMENTAL_PARALLEL`	логическое значение	Включить параллельное выполнение веб-поиска
`AICIPPY_CODE_EXPERIMENTAL_SCOUT`	логическое значение	Включить субагент Scout
`AICIPPY_CODE_EXPERIMENTAL_WORKSPACES`	логическое значение	Включить поддержку рабочих областей