Установка

# Глобальная установкаnpm install -g @pachca/cli # Проверкаpachca --version # Или без установкиnpx -y @pachca/cli users list --token YOUR_ACCESS_TOKEN

Если вы в терминале — ставьте глобально (npm i -g): короткая команда pachca, автодополнение, авто-проверка обновлений.

Если подключаете агента — используйте npx -y @pachca/cli: без установки и без шага «настрой окружение». Агент запускает команду сразу, всегда последняя версия, ничего не нужно поддерживать на машине.

Флаг -y обязателен для агентов и CI. При первом запуске (и после каждого нового релиза, так как берётся последняя версия) npx скачивает пакет и в современных версиях npm запрашивает подтверждение установки. В неинтерактивной среде без -y команда остановится на этом вопросе и не выполнится.

Автодополнение

CLI поддерживает автодополнение для bash, zsh и PowerShell:

pachca autocomplete zshpachca autocomplete bashpachca autocomplete powershell

Команда выводит инструкцию по установке для выбранного шелла.

Настройки

Установите постоянные значения по умолчанию:

# Всегда выводить JSONpachca config set defaults.output json # Увеличить таймаутpachca config set defaults.timeout 60 # Показать все настройкиpachca config list

Настройки хранятся в ~/.config/pachca/config.toml. Флаги команды всегда имеют приоритет над настройками.

Диагностика

Команда pachca doctor проверяет окружение — Node.js, сеть, конфиг, токен и версию CLI:

pachca doctor # ✔ Node.js        v20.11.0 (требуется >=20)# ✔ Сеть           api.pachca.com доступен (142ms)# ✔ Конфиг         ~/.config/pachca/config.toml (права: 600)# ✔ Профиль        personal (user: Иван Иванов)# ✔ Токен          действителен (11 скоупов)# ✔ CLI            v2026.5.2 (актуальная версия)

Обновление

CLI автоматически проверяет наличие новой версии раз в сутки и показывает уведомление в терминале. Для обновления:

# Обновить до последней версииpachca upgrade # Или вручную через npmnpm install -g @pachca/cli # Посмотреть, что новогоpachca changelog

Отключить автоматическую проверку можно переменной PACHCA_SKIP_NEW_VERSION_CHECK.