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

Требования

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

Установка

npm install -g failproofai

bun add -g failproofai

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

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

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

failproofai policies --install

Эта команда записывает записи хуков в установленные CLI агентов (Claude Code’s ~/.claude/settings.json, OpenAI Codex’s ~/.codex/hooks.json, GitHub Copilot CLI’s ~/.copilot/hooks/failproofai.json, Cursor Agent’s ~/.cursor/hooks.json, OpenCode’s generated plugin shim at ~/.config/opencode/plugins/failproofai.mjs plus a registration entry in ~/.config/opencode/opencode.json’s plugin array, Pi’s ~/.pi/agent/settings.json, или Hermes’s ~/.hermes/config.yaml). Если присутствует несколько, вам будет предложено выбрать; передайте --cli claude codex copilot cursor opencode pi hermes (любое подмножество), чтобы пропустить запрос.GitHub Copilot CLI, Cursor Agent, OpenCode и Pi поддерживаются в режиме бета — установите с помощью --cli copilot, --cli cursor, --cli opencode или --cli pi. Hermes (hermes-agent, шлюз Slack/Telegram) устанавливается в область пользователя с помощью --cli hermes и также является источником автономного аудита.

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 hermes --scope user
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`	Конфигурация для конкретного проекта (зафиксирована в git)
`.failproofai/policies-config.local.json`	Личные переопределения (в .gitignore)

Удаление

failproofai policies --uninstall

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

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

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

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

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

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

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

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

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

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

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

Основные концепции

CLI

Инструменты

Продвинутый

Примеры

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

Требования

Установка

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

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

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

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

Удаление

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

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

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

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

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

​Требования

​Установка

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

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

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

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

​Удаление

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

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

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

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

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

Требования

Установка

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

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

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

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

Удаление

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