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.

Настройка машины

npm install -g failproofai
failproofai config \
  --connect https://app.befailproof.ai \
  --token <machine-key> \
  --machine-label checkout-prod-01
failproofai policies --install
failproofai config --status

Запустите failproofai без аргументов, чтобы открыть локальную панель управления политиками.

Команда	Результат
`failproofai config`	Запустить интерактивную настройку машины
`failproofai config --connect <url> --token <key>`	Подключить доставку облачной политики и ввод данных
`failproofai config --status`	Показать состояние подключения, демона, доставки и паузы
`failproofai policies`	Список встроенных, пользовательских, условных политик, пакетов и облачно-управляемых политик
`failproofai policies --install`	Установить hooks и включить политики
`failproofai policy add <name>`	Включить одну политику — встроенную или `<pack-id>:<name>` из установленного пакета
`failproofai policy remove <name>`	Отключить одну политику, с тем же именованием
`failproofai policies --uninstall`	Отключить политики или удалить hooks привязки
`failproofai pack list`	Список установленных пакетов политик и всех политик, которые они содержат
`failproofai pack add <source>`	Установить пакет политик из выпуска GitHub; без тега берется самый новый и закрепляется
`failproofai pack add --bundled`	Установить встроенные политики как пакет из этого пакета без сетевого доступа
`failproofai pack build <entry.mjs>`	Собрать три ресурса выпуска для вашего собственного пакета
`failproofai pack remove <publisher/name>`	Деактивировать установленный пакет
`failproofai audit`	Сканировать локальную историю агента и открыть локальное представление аудита
`failproofai audit --schedule [days] --email <address>`	Запланировать повторяющиеся локальные сканирования и отправить их результаты по электронной почте
`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`	Удалить hooks и демона перед удалением пакета
`failproofai --version`	Вывести установленную версию пакета
`failproofai --help`	Показать команды и глобальное использование

Флаги конфигурации

Флаг	Использование
`--connect <url> --token <key>`	Подключиться неинтерактивно
`--machine-id <id>`	Установить стабильный ID машины
`--machine-label <name>`	Установить или изменить метку панели управления
`--no-transcripts`	Отправить решения без содержимого транскрипта
`--disconnect`	Остановить извлечение облачной политики и доставку событий
`--status`	Показать текущее состояние машины
`--pause [duration]`	Приостановить новейшую сессию в текущей директории; принимает секунды, минуты или часы и по умолчанию составляет 30 минут
`--resume`	Завершить совпадающую паузу раньше
`--session <id>`	Нацелиться на явную сессию для паузы или возобновления
`--all`	С `--resume` завершить все активные паузы

Локальные паузы приостанавливают встроенные, пользовательские, условные политики и политики пакетов для одной сессии. Они всегда истекают и не отключают облачно-управляемые политики. block-failproofai-commands — который всегда включен и не может быть отключен или приостановлен сам по себе — предотвращает использование этого механизма обхода инструментированным агентом.

Флаги политики

Флаг	Использование
`--install`, `-i`	Включить политики и установить hooks привязки
`--uninstall`, `-u`	Отключить политики или удалить hooks
`--cli <names...>`	Нацелиться на один или несколько поддерживаемых привязок
`--scope user\|project\|local\|all`	Выбрать область конфигурации; `all` для удаления
`--beta`	Включить бета-политики
`--custom`, `-c <path>`	Валидировать и загрузить пользовательский файл политики; повторяемо

Флаги доставки и обслуживания

Команда	Флаги
`backfill`	`--since <30d\|6m\|YYYY-MM-DD>`, `--dry-run`
`flush`	`--wait`, `--timeout <seconds>`
`update`	`--no-daemon`
`migrate`	`--dry-run`
`uninstall`	`--purge`, `--dry-run`, `--yes`

failproofai update следует запустить после npm install -g failproofai@latest; он выполняет миграции макета домашней папки, устанавливает соответствующий бинарный файл демона и перезапускает сервис. --no-daemon выполняет только миграцию макета.

Пути привязки

failproofai harness list [harness]
failproofai harness add-path <harness> [label=]<path>
failproofai harness remove-path <harness> <path-or-label>

Поддерживаемые имена привязок: claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity и goose. Метки помещают полученные ID агентов в пространство имен, когда два корня содержат копии одного и того же проекта. Перекрывающиеся корни и дублирующиеся метки отклоняются для предотвращения дублирования сбора или повреждения курсора. Конфигурация дополнительного пути перезагружается без перезагрузки демона. Контейнерные среды могут заменить сконфигурированные файлом дополнительные пути переменной с разделением запятыми с именем FAILPROOFAI_<HARNESS>_EXTRA_PATHS, например:

export FAILPROOFAI_OPENCLAW_EXTRA_PATHS="user1=/srv/openclaw-a,user2=/srv/openclaw-b"

Переменные окружения

Используйте файлы конфигурации для постоянного поведения машины. Переменные окружения наиболее полезны для контейнеров, тестов и одного процесса.

Переменная	Использование
`FAILPROOFAI_HOME`	Переместить полный макет `~/.failproofai`
`FAILPROOFAI_LOG_LEVEL`	Установить подробность локального логирования
`FAILPROOFAI_HOOK_LOG_FILE`	Писать диагностику hooks в выбранный файл
`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_NO_DOWNLOAD=1`	Отказаться получать пакеты и бинарные файлы демона; что установлено, продолжает работать
`FAILPROOFAI_PACK_BASE_URL`	Получать пакеты из зеркала вместо `github.com`
`FAILPROOFAI_<HARNESS>_EXTRA_PATHS`	Заменить сконфигурированные дополнительные пути захвата для одной привязки
`NO_COLOR`	Отключить цветной вывод терминала

Переменные домашней папки, специфичные для агента, такие как CLAUDE_PROJECTS_PATH, CURSOR_HOME, HERMES_HOME и OPENCLAW_HOME переопределяют, где Failproof AI обнаруживает локальные сессии для этой привязки.

Безопасно приостановить или удалить машину

failproofai config --pause
failproofai config --status
failproofai config --resume

Локальная пауза сессии не отключает облачно-управляемые политики. Восстановите облачные развертывания через рабочий процесс облачного принудительного применения, когда сам развертывание является проблемой. Перед удалением npm пакета удалите установленные hooks и демона:

failproofai uninstall --dry-run
failproofai uninstall --yes
npm rm -g failproofai

Запустите failproofai <command> --help для деталей, зависящих от версии.

Запустите failproofai uninstall перед npm rm -g failproofai; npm не удаляет установленные hooks агента или сервис демона.

Connect your agents

Reference

Настройка машины

Флаги конфигурации

Флаги политики

Флаги доставки и обслуживания

Пути привязки

Переменные окружения

Безопасно приостановить или удалить машину

​Настройка машины

​Флаги конфигурации

​Флаги политики

​Флаги доставки и обслуживания

​Пути привязки

​Переменные окружения

​Безопасно приостановить или удалить машину

Настройка машины

Флаги конфигурации

Флаги политики

Флаги доставки и обслуживания

Пути привязки

Переменные окружения

Безопасно приостановить или удалить машину