Начало работы

Требования

Node.js >= 20.9.0
Bun >= 1.3.0 (опционально - требуется только для сборки из исходного кода)

Установка

npm install -g failproofai

bun add -g failproofai

Быстрый старт

Включите политики

Политики — это правила, которые выполняются до и после каждого вызова инструмента агента. Они перехватывают деструктивные команды, утечки секретов и другие сбои перед тем, как они причинят вред.

failproofai policies --install

Это добавляет записи крючков в установленные CLI агентов (Claude Code в ~/.claude/settings.json, OpenAI Codex в ~/.codex/hooks.json, GitHub Copilot CLI в ~/.copilot/hooks/failproofai.json, Cursor Agent в ~/.cursor/hooks.json, OpenCode с создаваемой заглушкой плагина в ~/.config/opencode/plugins/failproofai.mjs плюс запись регистрации в массиве plugin файла ~/.config/opencode/opencode.json, Pi в ~/.pi/agent/settings.json или Gemini CLI в ~/.gemini/settings.json). Если присутствует более одного варианта, вам будет предложено выбрать; передайте --cli claude codex copilot cursor opencode pi gemini (любое подмножество), чтобы пропустить запрос.Поддержка GitHub Copilot CLI, Cursor Agent, OpenCode, Pi и Gemini CLI находится в статусе beta — устанавливайте с --cli copilot, --cli cursor, --cli opencode, --cli pi или --cli gemini.

failproofai policies --install --scope project
failproofai policies --install --cli codex --scope project
failproofai policies --install --cli copilot --scope project
failproofai policies --install --cli cursor --scope project
failproofai policies --install --cli opencode --scope project
failproofai policies --install --cli pi --scope project
failproofai policies --install --cli gemini --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys

Проверьте

failproofai policies

Показывает все политики, включены ли они и любые настроенные параметры.

Запустите панель управления

failproofai

Открывает локальную панель управления на http://localhost:8020, где вы можете просматривать сессии, проверять вызовы инструментов и управлять политиками.

Запустите вашего агента

Запустите Claude Code обычным образом. Если агент попытается что-то рискованное, failproofai автоматически это перехватит. Оставьте его работать без присмотра и проверьте, что произошло, в панели управления.

Как работают политики

Каждый раз, когда агент запускает инструмент, Claude Code вызывает failproofai как подпроцесс:

Claude Code  →  failproofai --hook PreToolUse  →  читает JSON из stdin
                                                 оценивает политики
                                                 записывает решение в stdout

Каждая политика возвращает одно из трех решений:

allow — агент продолжает работу нормально
deny — действие заблокировано, агенту объясняется почему
instruct — дополнительный контекст добавляется в подсказку агента

Политики выполняются в вашем локальном процессе. Ничего не отправляется на удаленный сервис.

Установите командные политики с использованием политик на основе соглашений

Быстрейший способ установить стандарты качества во всей команде — это соглашение .failproofai/policies/. Поместите файлы политик в этот каталог, и они загружаются автоматически — без флагов, без изменения конфигурации, без команд установки.

Создайте каталог политик

mkdir -p .failproofai/policies

Добавьте файлы политик

Скопируйте примеры для начинающих или напишите свои собственные:

cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/

Или создайте новый:

// .failproofai/policies/team-policies.mjs
import { customPolicies, allow, deny, instruct } from "failproofai";

customPolicies.add({
  name: "test-before-commit",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolName !== "Bash") return allow();
    if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
      return instruct("Run tests before committing.");
    }
    return allow();
  },
});

Зафиксируйте в git

git add .failproofai/policies/
git commit -m "Add team quality policies"

Каждый член команды, у которого установлен failproofai, автоматически получает эти политики. Не требуется отдельная настройка для каждого разработчика.

Зафиксируйте .failproofai/policies/ в репозитории, чтобы вся команда придерживалась одних и тех же стандартов. По мере того, как ваша команда обнаруживает новые способы сбоев, добавляйте политики и отправляйте их — каждый получит обновление при следующем git pull. Со временем эти политики становятся живым стандартом качества, который постоянно улучшается.

Хранение данных

Все конфигурации и журналы остаются на вашей машине:

Путь	Что хранится
`~/.failproofai/policies-config.json`	Глобальная конфигурация политик
`~/.failproofai/hook-activity.jsonl`	История выполнения крючков
`~/.failproofai/hook.log`	Журнал отладки для ошибок пользовательских крючков
`.failproofai/policies-config.json`	Конфигурация для проекта (зафиксирована)
`.failproofai/policies-config.local.json`	Личные переопределения (в .gitignore)

Удаление

failproofai policies --uninstall

Удаляет записи крючков из ~/.claude/settings.json. Файлы конфигурации в ~/.failproofai/ сохраняются.

Следующие шаги

Конфигурация

Области и формат файла конфигурации

Встроенные политики

Все 26 политик с параметрами

Пользовательские политики

Напишите свои собственные политики на JavaScript

Монитор агента

Мониторьте сессии и проверьте активность политик