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

Установите failproofai, включите политики и позвольте вашим агентам работать надежно

​

Требования

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

---

​

Установка

npm

npm install -g failproofai

bun add -g failproofai

---

​

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

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

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

   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
   
2. Проверьте

   failproofai policies
   

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

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

   failproofai
   

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

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

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

---

​

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

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

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

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

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

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

---

​

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

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

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

   mkdir -p .failproofai/policies
   
2. Добавьте файлы политик

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

   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();
     },
   });
   
3. Зафиксируйте в 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

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

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