# cli
[Home](/ru/ai)
[Catalog](/ru/ai/catalog)
Компоненты cli: отдельный исполняемый процесс.
## Pages
[Главная](/ru/ai/docs)
### Быстрый старт
[Быстрый старт](/ru/ai/docs/quickstart)
[Для человека](/ru/ai/docs/quickstart/human)
[Для ИИ-агента](/ru/ai/docs/quickstart/agent)
[Харнессы](/ru/ai/docs/harnesses)
[Понятия](/ru/ai/docs/concepts)
[Каталог](/ru/ai/docs/catalog)
### CLI
[CLI](/ru/ai/docs/cli)
[Карта команд](/ru/ai/docs/cli/commands)
[Наблюдение](/ru/ai/docs/cli/observe)
[Конфигурация](/ru/ai/docs/cli/config)
[Телеметрия](/ru/ai/docs/cli/telemetry)
[Устройство](/ru/ai/docs/cli/device)
[Паспорта](/ru/ai/docs/cli/passport)
[Вход](/ru/ai/docs/cli/auth)
[Согласие](/ru/ai/docs/cli/consent)
[Проект](/ru/ai/docs/cli/project)
[Toolchain](/ru/ai/docs/cli/toolchain)
[Harness](/ru/ai/docs/cli/harness)
[Agent Skill CLI](/ru/ai/docs/cli/skill)
[Реестр](/ru/ai/docs/cli/registry)
#### Компонент
[Обзор](/ru/ai/docs/cli/component)
[Обнаружение](/ru/ai/docs/cli/component-discover)
[Паспорт](/ru/ai/docs/cli/component-passport)
[Источник](/ru/ai/docs/cli/component-source)
[Публикация](/ru/ai/docs/cli/component-publish)
[Выбор](/ru/ai/docs/cli/select)
[Установка](/ru/ai/docs/cli/install)
[Target](/ru/ai/docs/cli/target)
[Setup](/ru/ai/docs/cli/setup)
[Provider](/ru/ai/docs/cli/provider)
[Синхронизация](/ru/ai/docs/cli/sync)
[Доступ](/ru/ai/docs/cli/grant)
[Жалобы](/ru/ai/docs/cli/report)
[Owner](/ru/ai/docs/cli/owner)
[Publication](/ru/ai/docs/cli/publication)
[Eval](/ru/ai/docs/cli/eval)
### Веб
[Веб](/ru/ai/docs/web)
[Главная](/ru/ai/docs/web/home)
[Каталог](/ru/ai/docs/web/catalog)
[Карточка компонента](/ru/ai/docs/web/catalog-component)
[Карточка сетапа](/ru/ai/docs/web/catalog-setup)
[Региональные сервисы](/ru/ai/docs/web/services)
[Издатели](/ru/ai/docs/web/publishers)
[Content](/ru/ai/docs/web/content)
[Эта документация](/ru/ai/docs/web/docs)
[Контакт](/ru/ai/docs/web/contact)
[Правовые документы](/ru/ai/docs/web/legal)
[Вход](/ru/ai/docs/web/login)
[Аккаунт](/ru/ai/docs/web/account)
[Профиль](/ru/ai/docs/web/profile)
[Устройства](/ru/ai/docs/web/devices)
[Объекты](/ru/ai/docs/web/objects)
[Доступ](/ru/ai/docs/web/access)
[Жалобы](/ru/ai/docs/web/reports)
[Лайки](/ru/ai/docs/web/likes)
[Онбординг](/ru/ai/docs/web/onboarding)
[Публикация](/ru/ai/docs/web/publications)
### Компоненты
[Компоненты](/ru/ai/docs/components)
[instruction](/ru/ai/docs/components/instruction)
[skill](/ru/ai/docs/components/skill)
[mcp](/ru/ai/docs/components/mcp)
[hook](/ru/ai/docs/components/hook)
[command](/ru/ai/docs/components/command)
[agent](/ru/ai/docs/components/agent)
[plugin](/ru/ai/docs/components/plugin)
[setting](/ru/ai/docs/components/setting)
[Сетапы](/ru/ai/docs/setups)
### Публикация
[Публикация](/ru/ai/docs/publishing)
[Авторство](/ru/ai/docs/publishing/authoring)
### Доверие и безопасность
[Обзор](/ru/ai/docs/trust-and-safety)
[Проверки безопасности](/ru/ai/docs/security-checks)
[Диагностика](/ru/ai/docs/troubleshooting)
[cli](/ru/ai/docs/components/cli)
## Content
# `cli`
`cli` — отдельная программа с process entry point. Агент обнаруживает,
регистрирует, публикует, устанавливает и вызывает её как процесс.
`cli` отвечает на вопрос: **какой общий исполняемый файл можно запустить?**
Это не «какую проверяемую операцию можно вызвать по имени?»
([`command`](command.md)). Slash-команда — именованный вызов внутри харнесса.
`cli` — процесс. Это также не сам исполняемый файл `ai-stp` — он живёт в
[CLI](../cli/index.md).
Повседневное авторство — intent `author`. Не набирайте `component scaffold plan`.
```bash
ai-stp task start --intent author --idempotency-key author-session-01 --json
```
!!! warning "Вид `cli` — не slash-команда"
| Объект | Где живёт | В сетапе? |
| --- | --- | --- |
| Вид `cli` (эта страница) | один общий исполняемый артефакт | да |
| Вид `command` | slash/prompt поверхность харнесса | да |
| Группы CLI `ai-stp …` | [карта CLI](../cli/commands.md) | нет |
Не копируйте один бинарник в семь layout харнессов. Scaffold — portable.
Интеграция — запуск процесса, не семь нативных копий.
## Соседи
| Вид | Главное отличие |
| --- | --- |
| `command` | команда вызывается по имени внутри харнесса; `cli` — процесс |
| `hook` | hook стартует на событии жизненного цикла; `cli` — когда его исполняют |
| `mcp` | MCP говорит протоколом; `cli` — обычная программа |
| `skill` | skill — процедура, которую харнесс подключает; `cli` — исполняемый файл |
| `plugin` | plugin расширяет сам харнесс; `cli` — общий инструмент |
| `setting` | setting держит параметры; `cli` держит программу |
Выбирайте `cli`, когда объект — отдельный исполняемый файл. Выбирайте
`command`, когда работу запускают slash-именем.
## Рекомендуемая структура пакета
`cli` исполняемый. `--language` — одно из `python`, `typescript`,
`javascript`, `rust`, `go` или `dart-flutter`. `--harness` — `portable`.
```text
review-kit/ # component-scaffold/6
├── .ai-stp-template.json
├── .gitignore
├── README.md
├── component-passport.json
├── eval-profile.json
└── source/
└── src/main.py
```
## Красные флаги
- Scaffold `--type command` для процесса, который не является slash-командой.
- Конкретный harness variant, из-за которого один бинарник копируется семь раз.
- Считать сам `ai-stp` каталожным компонентом `cli`.