> ## Documentation Index > Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt > Use this file to discover all available pages before exploring further. # Failproof AI CLI > Устанавливайте хуки, управляйте локальными политиками, подключайте облако и управляйте локальным демоном. Установите локальный CLI с помощью `npm install -g failproofai`. Запустите его без аргументов, чтобы открыть панель управления локальными политиками. Пакет требует Node.js версии 20.9 или новее. Bun версии 1.3 или новее поддерживается для разработки и установки из исходного кода. `failproofai configure` и `failproofai setup` — это псевдонимы для `failproofai config`; `failproofai p` — это псевдоним для `failproofai policies`. ## Настройка машины ```bash theme={null} npm install -g failproofai failproofai config \ --connect https://app.befailproof.ai \ --token \ --machine-label checkout-prod-01 failproofai policies --install failproofai config --status ``` Запустите `failproofai` без аргументов, чтобы открыть панель управления локальными политиками. | Команда | Результат | | ------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | | `failproofai config` | Запустить интерактивную настройку машины | | `failproofai config --connect --token ` | Подключить облачную доставку событий и доставку политик | | `failproofai config --status` | Показать состояние подключения, демона, доставки и паузы | | `failproofai policies` | Список встроенных и пользовательских политик | | `failproofai policies --install` | Установить хуки и включить политики | | `failproofai policy add ` | Включить одну встроенную политику | | `failproofai policy remove ` | Отключить одну встроенную политику | | `failproofai policies --uninstall` | Отключить политики или удалить хуки интеграции | | `failproofai audit` | Просканировать локальную историю агента и открыть локальное представление аудита | | `failproofai audit --schedule [days] --email
` | Запланировать периодические локальные сканирования и отправить результаты по электронной почте | | `failproofai audit --status` | Показать адрес отчета, интервал и время следующего запланированного сканирования | | `failproofai audit --no-schedule` | Остановить периодические сканирования без удаления истории аудита | | `failproofai harness list` | Список дополнительных путей захвата | | `failproofai flush --wait` | Доставить текущий буфер событий | | `failproofai backfill --since 30d` | Переквитировать ранее пройденную историю | | `failproofai config --pause [duration]` | Приостановить одну локальную сессию на 30 минут по умолчанию, максимум 8 часов | | `failproofai config --resume` | Возобновить одну приостановленную локальную сессию; добавьте `--all`, чтобы очистить все паузы | | `failproofai update` | Завершить миграции пакета и обновить демон | | `failproofai migrate --dry-run` | Просмотреть или запустить предполагаемые миграции структуры главной директории | | `failproofai uninstall` | Удалить хуки и демон перед удалением пакета | | `failproofai --version` | Печать установленной версии пакета | | `failproofai --help` | Показать команды и глобальное использование | ## Флаги конфигурации | Флаг | Использование | | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | | `--connect --token ` | Подключиться неинтерактивно | | `--machine-id ` | Установить стабильный ID машины | | `--machine-label ` | Установить или изменить метку на панели управления | | `--no-transcripts` | Отправлять решения без содержания протокола | | `--disconnect` | Остановить облачные запросы политик и доставку событий | | `--status` | Показать текущее состояние машины | | `--pause [duration]` | Приостановить новейшую сессию в текущей директории; принимает секунды, минуты или часы и по умолчанию составляет 30 минут | | `--resume` | Завершить соответствующую паузу раньше времени | | `--session ` | Выбрать явную сессию для паузы или возобновления | | `--all` | С `--resume` завершить каждую активную паузу | Локальные паузы приостанавливают встроенные, пользовательские и конвенционные политики для одной сессии. Они всегда истекают и не отключают облачные управляемые политики. `block-self-pause` предотвращает использование инструментированным агентом этого способа избежать ограничений. ## Флаги политик | Флаг | Использование | | ----------------------------------- | ---------------------------------------------------------------- | | `--install`, `-i` | Включить политики и установить хуки интеграции | | `--uninstall`, `-u` | Отключить политики или удалить хуки | | `--cli ` | Выбрать одну или несколько поддерживаемых интеграций | | `--scope user\|project\|local\|all` | Выбрать область конфигурации; `all` для удаления | | `--beta` | Включить бета-политики | | `--custom`, `-c ` | Проверить и загрузить файл пользовательской политики; повторяемо | ## Флаги доставки и обслуживания | Команда | Флаги | | ----------- | -------------------------------------------- | | `backfill` | `--since <30d\|6m\|YYYY-MM-DD>`, `--dry-run` | | `flush` | `--wait`, `--timeout ` | | `update` | `--no-daemon` | | `migrate` | `--dry-run` | | `uninstall` | `--purge`, `--dry-run`, `--yes` | `failproofai update` следует запустить после `npm install -g failproofai@latest`; он выполняет миграции структуры главной директории, устанавливает соответствующий бинарный файл демона и перезапускает сервис. `--no-daemon` выполняет только миграцию структуры. ## Пути интеграции ```text theme={null} failproofai harness list [harness] failproofai harness add-path [label=] failproofai harness remove-path ``` Поддерживаемые имена интеграций: `claude`, `codex`, `copilot`, `cursor`, `opencode`, `pi`, `hermes`, `openclaw`, `factory`, `devin`, `antigravity` и `goose`. Метки определяют пространство имен для ID производных агентов, когда два корня содержат копии одного проекта. Перекрывающиеся корни и дублирующиеся метки отклоняются, чтобы предотвратить дублирование сборки или повреждение курсора. Конфигурация дополнительных путей перезагружается без перезагрузки демона. В контейнерных средах можно заменить пути дополнительных возможностей, сконфигурированные в файле, переменной, разделенной запятыми, с именем `FAILPROOFAI__EXTRA_PATHS`, например: ```bash theme={null} export FAILPROOFAI_OPENCLAW_EXTRA_PATHS="user1=/srv/openclaw-a,user2=/srv/openclaw-b" ``` ## Переменные окружения Используйте файлы конфигурации для постоянного поведения машины. Переменные окружения наиболее полезны для контейнеров, тестов и одного процесса. | Переменная | Использование | | ------------------------------------ | -------------------------------------------------------------------------------- | | `FAILPROOFAI_HOME` | Переместить полный макет `~/.failproofai` | | `FAILPROOFAI_LOG_LEVEL` | Установить уровень многословности локального логирования | | `FAILPROOFAI_HOOK_LOG_FILE` | Записать диагностику хуков в выбранный файл | | `FAILPROOFAI_TELEMETRY_DISABLED=1` | Отключить анонимную телеметрию для этого процесса | | `FAILPROOFAI_NO_FIRST_RUN=1` | Пропустить интерактивную настройку при первом запуске | | `FAILPROOFAI_NO_AUTO_AUDIT=1` | Пропустить локальный аудит после настройки | | `FAILPROOFAI_LLM_BASE_URL` | Переопределить используемую конечную точку, совместимую с OpenAI для политик LLM | | `FAILPROOFAI_LLM_API_KEY` | Предоставить ключ API, используемый политиками LLM | | `FAILPROOFAI_LLM_MODEL` | Выбрать модель, используемую политиками LLM | | `FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS` | Ограничить загрузку модуля пользовательской политики | | `FAILPROOFAI__EXTRA_PATHS` | Заменить сконфигурированные пути дополнительного захвата для одной интеграции | | `NO_COLOR` | Отключить цветной вывод терминала | Переменные главной директории для конкретного агента, такие как `CLAUDE_PROJECTS_PATH`, `CURSOR_HOME`, `HERMES_HOME` и `OPENCLAW_HOME`, переопределяют, где Failproof AI обнаруживает локальные сессии для этой интеграции. ## Безопасная пауза или удаление машины ```bash theme={null} failproofai config --pause failproofai config --status failproofai config --resume ``` Пауза локальной сессии не отключает облачные управляемые политики. Восстановите облачные развертывания через рабочий процесс облачного обеспечения, когда само развертывание является проблемой. Перед удалением пакета npm удалите установленные хуки и демон: ```bash theme={null} failproofai uninstall --dry-run failproofai uninstall --yes npm rm -g failproofai ``` Запустите `failproofai --help` для специфичных для версии деталей. Запустите `failproofai uninstall` перед `npm rm -g failproofai`; npm не удаляет установленные хуки агента или сервис демона.