Для разработчиков

Обзор

Официальный CLI для Pachca API: авторизация, сообщения, управление пространством — всё из терминала. Каждый метод API доступен как команда с типизированными флагами, валидацией и подсказками. Нужен Node.js 20.3.0 или новее.

Сделать с агентом
Агент поставит Pachca CLI, даст вам команду входа и проверит установку и вход
Настрой 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`, дай мне готовыми командами.
Вставьте промпт в чат с ИИ-агентом, у которого есть терминал на вашей машине. Правила задачи знает скилл pachca-api.

Быстрый старт

Установка

npm install -g @pachca/cli

Подробнее — Установка.

Вход в аккаунт

Если вход выполняете вы сами, достаточно подтвердить его в браузере, получать токен заранее не нужно. Так могут войти администраторы, а остальные сотрудники — если настройка пространства разрешает им персональные токены. Подробнее — в разделе Кто может создавать токены.

Для CI и агентов, где подтверждать некому, создайте токен заранее: персональный на странице Интеграции > API или токен бота в его карточке. Передайте его переменной окружения PACHCA_TOKEN: CLI возьмёт токен из неё, отдельный вход не нужен.

# Подтверждение в браузереpachca auth login # CI и агенты: готовый токен в переменной окруженияexport PACHCA_TOKEN=YOUR_ACCESS_TOKEN

Подробнее — Авторизация в CLI.

Первый запрос

pachca users list #  ID     TITLE      FIRST_NAME   LAST_NAME   EMAIL#  1234   Менеджер   Иван         Иванов      ivan@example.com#  5678   Дизайнер   Мария        Петрова     maria@example.com

Готово. Это типизированная команда. Тот же запрос можно сделать и напрямую через pachca api — оба способа описаны в разделе Способы работы.

Без установки — разовый запуск через npx, токен передаётся флагом:

npx -y @pachca/cli users list --token YOUR_ACCESS_TOKEN

Способы работы

С CLI можно работать двумя способами. Основной — типизированные команды: так написаны все примеры в документации и интеграции. В дополнение есть команда pachca api для прямых запросов и встроенного справочника по API.

Типизированные команды

Каждый метод API — отдельная команда pachca <секция> <действие> с флагами, валидацией и подсказками. Справка по любой команде — флаг --help:

pachca messages create --entity-id 123 --content "Привет"  # отправить сообщениеpachca messages create --help  # справка по этой командеpachca commands  # список всех команд

Пропущенные обязательные флаги CLI запросит интерактивно. Флаг -o json переключает вывод в машиночитаемый JSON.

Все команды со всеми флагами — в разделе Справочник команд.

Кроме методов API, CLI принимает события бота без публичного адреса: команда pachca bots listen-events печатает их в stdout или пересылает локальному обработчику. Подробнее — в разделе Через CLI.

Прямые запросы

Команда pachca api отправляет прямой HTTP-запрос к любому методу — для нестандартных вызовов и отладки. Она же работает как встроенный справочник по API: список методов и справку по каждому (параметры, тело, пример) можно получить прямо в терминале, не открывая сайт документации. Справочник работает и до входа, поэтому особенно удобен агентам:

pachca api POST /messages -F 'message[entity_id]=123' -f 'message[content]=Привет'  # тот же запросpachca api POST /messages --describe  # справка по тому же методуpachca api ls  # список всех методов

Подробнее — Прямые запросы.

AI-агент с CLI

Агент, который может запускать команды, вызывает через CLI те же методы, что через MCP-сервер, а контекста модели тратит меньше: команды он узнаёт из --help, а не из описаний инструментов. В --help описаны флаги, а правила метода, которые MCP-сервер отдаёт в описании инструмента, показывает pachca api <МЕТОД> <путь> --docs. Как собрать из команд задачу и как принято в Пачке, агент знает из скиллов: они работают и с CLI. Команде установки нужен Node.js 22.20 или новее, другие способы — в разделе Установка скиллов. Для другой программы замените claude-code на её имя:

npx skills add https://dev.pachca.com -g -a claude-code -y

Вход pachca auth login выполните в своём терминале: в командах, которые запускает агент, диалога входа обычно нет. Через CLI агент и следит за тредом. Как ещё подключить Пачку к агенту — на странице AI-агенты.