Быстрый старт для человека

Установить ai_stp CLI, проверить окружение и дойти до первого чтения каталога.

Быстрый старт для человека

Короткий путь, который реально готовит машину: поставить CLI, увидеть чего не хватает, создать локальные идентичности, затем прочитать публичный каталог. Выбор и применение сетапа — следующая глава, не эта.

Если вы агент, который ведёт этот CLI, откройте Быстрый старт для ИИ-агента.

Исполняемый файл — ai-stp. Дистрибутив на PyPI — ai-stp-cli. Команда uv tool install ai-stp ставит пакет, который этот проект не публикует.

Установить CLI

uv tool install ai-stp-cli
ai-stp version --json

Если оболочка не находит ai-stp, каталог инструментов uv не в PATH. См. Диагностику.

Спросить установку, что она умеет

ai-stp doctor --json

Expert-ориентация (каждый command path):

ai-stp capabilities --json

doctor — чтение. Он не создаёт устройство, паспорт и проект. Он сообщает о CLI, локальном реестре, устройстве, toolchain, Agent Skill и о тех harness, которые на машине уже есть.

capabilities отвечает уже: с какими поверхностями этот билд умеет говорить прямо сейчас. Поддержку harness нельзя выводить из строки версии.

Создать локальные идентичности

Для локальной работы аккаунт не нужен. Нужны устройство и паспорт разработчика:

ai-stp device init --json
ai-stp device show --json
ai-stp passport developer init --json
ai-stp passport device refresh --json

device init идемпотентен: второй запуск возвращает идентичность, которую создал первый. Приватный ключ лежит в секретном хранилище ОС; если его нет, CLI прямо говорит, что ушёл в файловый ярус.

device reset — другая команда. Она разрушительная, требует --confirm и не является способом повторить doctor.

Следовать тому, что сказал doctor

Читайте отчёт doctor до того, как придумывать следующий шаг.

=== "Нет toolchain" Инструменты первого запуска — закреплённый профиль, не случайный pip install:

```bash
ai-stp toolchain profile --json
ai-stp toolchain install --tool <id> --json
```

`<id>` — инструмент, который пинит профиль. Точные имена — из
`ai-stp help --agent --json`. `toolchain install` пишет в управляемый
каталог и ничего не запускает из только что положенного инструмента.

Подробнее: [Toolchain](../cli/toolchain.md).

=== "Нет Agent Skill" Это Agent Skill самого CLI, не компонент kind skill в сетапе. Поставьте его, чтобы у агента была процедура:

```bash
ai-stp skill status --target <dir> --json
ai-stp skill install --target <dir> --json
```

`--target` — каталог, из которого harness читает свой native skill.

Когда файл на месте, агент всё равно начинает сессию с
`task intents --json`. См. [Agent Skill CLI](../cli/skill.md) и
[Быстрый старт для ИИ-агента](agent.md).

=== "Нет программы harness" Установить сетап — не то же самое, что установить программу harness. Сама программа — harness install. Provider, который потом пишет нативное состояние, — отдельный бинарник. См. Программу harness и Provider.

Посмотреть публичный каталог

Анонимное чтение не требует входа. --kind обязателен: component или setup.

Everyday-установка, когда кандидат уже есть:

ai-stp task start --intent install --idempotency-key install-session-01 --json

Expert-просмотр каталога:

ai-stp registry search --kind component --json
ai-stp registry show --kind component --id <stable_id> --json

Результат — кандидат, не разрешение ставить. Перед выбором проверьте harness, точную версию X.Y, линию доверия и две независимые оси verification. Как читать карточку: Каталог. Те же объекты на сайте: Веб-каталог.

Если сети нет, CLI может ответить из кэша и скажет, когда платформа в последний раз подтвердила байты.

Чего этот быстрый старт не делает

Он не входит в аккаунт, не собирает сетап и не пишет target harness. Это отдельные пути с digest:

Следующая задача	Страница
Выбрать состав	Выбор
Применить через provider	Установка
Импортировать уже существующую нативную конфигурацию	Команды сетапа
Войти и синхронизироваться	Вход
Опубликовать компонент	Публикация компонента
Вести CLI как агент	Быстрый старт для ИИ-агента

Типичные отказы

Что видно	Что это значит	Что делать
`ai-stp` не найден	инструмента нет или его нет в `PATH`	поставить заново `uv tool install ai-stp-cli`, затем `uv tool list`
doctor говорит, что нет device	идентичность ещё не создавали	`ai-stp device init --json`
search отвечает из cache	платформу не достали	смотреть `checked_at`; не выдавать это за живой каталог
capabilities не содержат harness	этот билд не ведёт такую цель	остаться на primary harness или читать Харнессы

Связанные страницы

Быстрый старт — выбрать путь человека или агента.
Быстрый старт для ИИ-агента — ритуал сессии и machine help.
CLI — конверты, mutability, confirmation.
Веб — карточки каталога и аккаунт.
Понятия — одно слово, один объект.
Доверие и безопасность — что «verified» не означает.

!!! note "Команды здесь — карта, не парсер" Если help --agent расходится с флагом на этой странице, прав CLI.