Установка
Требуется Node.js 20.3.0 или новее.
Если вы в терминале — ставьте глобально (npm i -g): короткая команда pachca, автодополнение, авто-проверка обновлений.
Если подключаете агента — используйте npx -y @pachca/cli: без установки и без шага «настрой окружение». Агент запускает команду сразу, всегда последняя версия, ничего не нужно поддерживать на машине.
-y обязателен для агентов и CI. При первом запуске (и после каждого нового релиза, так как берётся последняя версия) npx скачивает пакет и в современных версиях npm запрашивает подтверждение установки. В неинтерактивной среде без -y команда остановится на этом вопросе и не выполнится.Автодополнение
CLI поддерживает автодополнение для bash, zsh и PowerShell:
Команда выводит инструкцию по установке для выбранного шелла.
Настройки
Установите постоянные значения по умолчанию:
Ключей два: defaults.output и defaults.timeout. Значение одного ключа показывает pachca config get <ключ>. Флаги команды всегда имеют приоритет над настройками, а defaults.timeout важнее переменной PACHCA_TIMEOUT.
Настройки и профили хранятся в файле config.toml. Каталог для него CLI выбирает по первому подходящему правилу:
$PACHCA_HOME/pachca, если задана переменнаяPACHCA_HOME$XDG_CONFIG_HOME/pachca, если задана переменнаяXDG_CONFIG_HOME%LOCALAPPDATA%\pachcaна Windows~/.config/pachcaво всех остальных случаях
Полный путь к файлу показывает pachca doctor.
Диагностика
Команда pachca doctor проверяет окружение: Node.js, сеть, конфиг, токен и версию CLI.
doctor проверяет тот же токен, с которым работают остальные команды, и находит его в том же порядке. Если токен пришёл из --token или PACHCA_TOKEN, профиль ему не нужен: проверка профиля пропускается (skipped), как и проверка конфига, когда файла нет. Поэтому в CI с одной переменной PACHCA_TOKEN команда проходит.
При ошибке хотя бы одной проверки команда завершается с кодом 1 в любом формате вывода. В пайпе и с -o json она выводит объект с массивом checks, где у каждой проверки есть поле status (ok, warning, error или skipped): по нему видно, какая проверка не прошла.
Обновление
В интерактивном терминале CLI проверяет новую версию в фоне, не чаще раза в час, и после команды показывает плашку «Доступна новая версия». В скриптах, CI и с переменной PACHCA_PROMPT_DISABLED проверки нет. Для обновления:
Отключить автоматическую проверку можно переменной PACHCA_SKIP_NEW_VERSION_CHECK.
Удаление
Сначала выйдите из всех профилей, потом удалите пакет: auth logout работает, пока CLI установлен.
pachca auth logout удаляет один профиль за вызов, поэтому повторите его для каждого профиля из списка. Выход закрывает вход через браузер на сервере и стирает секрет профиля из хранилища ключей ОС: npm uninstall хранилище не трогает. Подробнее — в разделе Выход.
Если CLI уже удалили, вход через браузер действует, пока его не отзовут: закройте его действием Отозвать в списке Токены CLI. Готовые токены продолжают работать и после выхода, удалите их в интерфейсе Пачки.
Файл конфигурации остаётся на диске и после удаления пакета. Удалите его каталог вручную, обычно это ~/.config/pachca, а другие варианты перечислены в разделе Настройки. При заданной PACHCA_HOME удаляйте только вложенный каталог $PACHCA_HOME/pachca.