Перейти к основному содержанию

​
Требования

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

​
Установка

npm install -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

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

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