Обзор
Официальный CLI для Pachca API: авторизация, сообщения, управление пространством — всё из терминала. Каждый метод API доступен как команда с типизированными флагами, валидацией и подсказками. Нужен Node.js 20.3.0 или новее.
Настрой Pachca CLI на этой машине. Скачай страницы документации и делай по ним: `curl -sL https://dev.pachca.com/guides/cli/overview.md https://dev.pachca.com/guides/cli/installation.md https://dev.pachca.com/guides/cli/authentication.md https://dev.pachca.com/guides/bots/tokens.md`. Инструмент для веба отдаёт пересказ, бери его, только если curl не сработал. Если страницы не открылись и так, остановись и скажи. Если у тебя есть скилл `pachca-api`, работай и по нему. 1. Спроси, ставить CLI глобально или запускать через `npx -y @pachca/cli`. Если вход в CLI уже есть, спроси, оставить его или добавить профиль по разделу «Профили». 2. Проверь версию Node.js по странице, поставь CLI выбранным способом и проверь его версию. 3. Команду из раздела «Вход через браузер» дай мне: в твоих командах диалога входа обычно нет. Я запущу её в своём терминале на этой машине и подтвержу вход кодом в браузере. Токен CLI сохранит сам. 4. Если CLI нужен под ботом, дай мне команду из раздела «Токен бота сразу в профиль»: она выпустит токен бота и сохранит его в профиль, не показывая значения. Если вход через браузер не подходит для персонального токена, войдём по разделу «Вход готовым токеном»: токен я создам и скопирую сам, а ты дай команду, которая передаст его CLI из буфера обмена. Токен в чате не проси и в файлы не пиши. 5. Проверь установку и вход командой `pachca doctor` из раздела «Диагностика». Скажи, под кем я вошёл и какие проверки не прошли. 6. Перечисли, что изменено на машине и в Пачке, и скажи, как всё убрать по разделу «Удаление». Если мешают права, роль или настройки пространства, не обходи: скажи, что мешает и кто это изменит. Чего не можешь сам, например поставить пакет через `sudo`, дай мне готовыми командами.
Быстрый старт
Установка
Подробнее — Установка.
Вход в аккаунт
Если вход выполняете вы сами, достаточно подтвердить его в браузере, получать токен заранее не нужно. Так могут войти администраторы, а остальные сотрудники — если настройка пространства разрешает им персональные токены. Подробнее — в разделе Кто может создавать токены.
Для CI и агентов, где подтверждать некому, создайте токен заранее: персональный на странице Интеграции > API или токен бота в его карточке. Передайте его переменной окружения PACHCA_TOKEN: CLI возьмёт токен из неё, отдельный вход не нужен.
Подробнее — Авторизация в CLI.
Первый запрос
Готово. Это типизированная команда. Тот же запрос можно сделать и напрямую через pachca api — оба способа описаны в разделе Способы работы.
Без установки — разовый запуск через npx, токен передаётся флагом:
Способы работы
С CLI можно работать двумя способами. Основной — типизированные команды: так написаны все примеры в документации и интеграции. В дополнение есть команда pachca api для прямых запросов и встроенного справочника по API.
Типизированные команды
Каждый метод API — отдельная команда pachca <секция> <действие> с флагами, валидацией и подсказками. Справка по любой команде — флаг --help:
Пропущенные обязательные флаги CLI запросит интерактивно. Флаг -o json переключает вывод в машиночитаемый JSON.
Все команды со всеми флагами — в разделе Справочник команд.
Кроме методов API, CLI принимает события бота без публичного адреса: команда pachca bots listen-events печатает их в stdout или пересылает локальному обработчику. Подробнее — в разделе Через CLI.
Прямые запросы
Команда pachca api отправляет прямой HTTP-запрос к любому методу — для нестандартных вызовов и отладки. Она же работает как встроенный справочник по API: список методов и справку по каждому (параметры, тело, пример) можно получить прямо в терминале, не открывая сайт документации. Справочник работает и до входа, поэтому особенно удобен агентам:
Подробнее — Прямые запросы.
AI-агент с CLI
Агент, который может запускать команды, вызывает через CLI те же методы, что через MCP-сервер, а контекста модели тратит меньше: команды он узнаёт из --help, а не из описаний инструментов. В --help описаны флаги, а правила метода, которые MCP-сервер отдаёт в описании инструмента, показывает pachca api <МЕТОД> <путь> --docs. Как собрать из команд задачу и как принято в Пачке, агент знает из скиллов: они работают и с CLI. Команде установки нужен Node.js 22.20 или новее, другие способы — в разделе Установка скиллов. Для другой программы замените claude-code на её имя:
Вход pachca auth login выполните в своём терминале: в командах, которые запускает агент, диалога входа обычно нет. Через CLI агент и следит за тредом. Как ещё подключить Пачку к агенту — на странице AI-агенты.