ai_stp

# Быстрый старт для человека Короткий путь, который реально готовит машину: поставить CLI, увидеть чего не хватает, создать локальные идентичности, затем прочитать публичный каталог. Выбор и применение сетапа — следующая глава, не эта. Если вы агент, который ведёт этот CLI, откройте [Быстрый старт для ИИ-агента](agent.md). Исполняемый файл — `ai-stp`. Дистрибутив на PyPI — `ai-stp-cli`. Команда `uv tool install ai-stp` ставит пакет, который этот проект не публикует. ## Установить CLI ```bash uv tool install ai-stp-cli ai-stp version --json ``` Если оболочка не находит `ai-stp`, каталог инструментов `uv` не в `PATH`. См. [Диагностику](../troubleshooting/index.md). ## Спросить установку, что она умеет ```bash ai-stp doctor --json ``` Expert-ориентация (каждый command path): ```text ai-stp capabilities --json ``` `doctor` — чтение. Он не создаёт устройство, паспорт и проект. Он сообщает о CLI, локальном реестре, устройстве, toolchain, Agent Skill и о тех harness, которые на машине уже есть. `capabilities` отвечает уже: с какими поверхностями этот билд умеет говорить прямо сейчас. Поддержку harness нельзя выводить из строки версии. ## Создать локальные идентичности Для локальной работы аккаунт не нужен. Нужны устройство и паспорт разработчика: ```bash 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](../cli/harness.md) и [Provider](../cli/provider.md). ## Посмотреть публичный каталог Анонимное чтение не требует входа. `--kind` обязателен: `component` или `setup`. Everyday-установка, когда кандидат уже есть: ```bash ai-stp task start --intent install --idempotency-key install-session-01 --json ``` Expert-просмотр каталога: ```text ai-stp registry search --kind component --json ai-stp registry show --kind component --id <stable_id> --json ``` Результат — кандидат, не разрешение ставить. Перед выбором проверьте harness, точную версию `X.Y`, линию доверия и две независимые оси verification. Как читать карточку: [Каталог](../catalog/index.md). Те же объекты на сайте: [Веб-каталог](../web/catalog.md). Если сети нет, CLI может ответить из кэша и скажет, когда платформа в последний раз подтвердила байты. ## Чего этот быстрый старт не делает Он не входит в аккаунт, не собирает сетап и не пишет target harness. Это отдельные пути с digest: | Следующая задача | Страница | | --- | --- | | Выбрать состав | [Выбор](../cli/select.md) | | Применить через provider | [Установка](../cli/install.md) | | Импортировать уже существующую нативную конфигурацию | [Команды сетапа](../cli/setup.md) | | Войти и синхронизироваться | [Вход](../cli/auth.md) | | Опубликовать компонент | [Публикация компонента](../cli/component-publish.md) | | Вести CLI как агент | [Быстрый старт для ИИ-агента](agent.md) | ## Типичные отказы | Что видно | Что это значит | Что делать | | --- | --- | --- | | `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 или читать [Харнессы](../harnesses.md) | ## Связанные страницы - [Быстрый старт](index.md) — выбрать путь человека или агента. - [Быстрый старт для ИИ-агента](agent.md) — ритуал сессии и machine help. - [CLI](../cli/index.md) — конверты, mutability, confirmation. - [Веб](../web/index.md) — карточки каталога и аккаунт. - [Понятия](../concepts/index.md) — одно слово, один объект. - [Доверие и безопасность](../trust-and-safety/index.md) — что «verified» не означает. !!! note "Команды здесь — карта, не парсер" Если `help --agent` расходится с флагом на этой странице, прав CLI.