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`	Установить хуки и включить политики
`failproofai policy add <name>`	Включить одну встроенную политику
`failproofai policy remove <name>`	Отключить одну встроенную политику
`failproofai policies --uninstall`	Отключить политики или удалить хуки интеграции
`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`	Удалить хуки и демон перед удалением пакета
`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-self-pause предотвращает использование инструментированным агентом этого способа избежать ограничений.

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

Флаг	Использование
`--install`, `-i`	Включить политики и установить хуки интеграции
`--uninstall`, `-u`	Отключить политики или удалить хуки
`--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`	Записать диагностику хуков в выбранный файл
`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_<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 удалите установленные хуки и демон:

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

Запустите failproofai <command> --help для специфичных для версии деталей.

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

Connect your agents

Reference

HTTP API

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

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

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

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

Пути интеграции

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

Безопасная пауза или удаление машины

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

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

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

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

​Пути интеграции

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

​Безопасная пауза или удаление машины

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

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

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

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

Пути интеграции

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

Безопасная пауза или удаление машины