Перейти к основному содержанию
Панель управления failproofai — это локальное веб-приложение для мониторинга сеансов вашего AI-агента и управления политиками. Посмотрите, что делали ваши агенты, пока вас не было рядом.

​
Запуск панели управления

failproofai
Открывается по адресу http://localhost:8020. Панель управления читает данные непосредственно из файловой системы — из папок проектов Claude Code и файлов конфигурации failproofai. Ничего не отправляется на удаленный сервис.

​
Страницы

​
Проекты

Показывает все проекты Claude Code, найденные на вашем компьютере. Проекты обнаруживаются в ~/.claude/projects/ (или в пути, установленном переменной CLAUDE_PROJECTS_PATH). Для каждого проекта отображается:
  • Имя проекта (полученное из пути папки)
  • Количество сеансов
  • Дата последней активности в сеансе
Нажмите на проект, чтобы увидеть его сеансы.

​
Сеансы

Показывает все сеансы в проекте. Для каждого сеанса отображается:
  • ID сеанса
  • Временные метки начала и завершения
  • Количество вызовов инструментов
  • Количество срабатываний хуков (политик, которые были применены)
Используйте фильтр диапазона дат и поиск по ID сеанса, чтобы сузить список. Сеансы разбиты на страницы. Нажмите на сеанс, чтобы открыть просмотр сеанса.

​
Просмотр сеанса

Просмотр сеанса отвечает на ключевой вопрос для автономных агентов: что делал агент и оставался ли он на правильном пути? Он показывает временную шкалу всего, что произошло в сеансе:
  • Сообщения — текстовые ответы Claude и подсказки пользователя
  • Вызовы инструментов — каждый инструмент, который вызвал Claude, с его входными и выходными данными
  • Активность политик — для каждого вызова инструмента показывает, какие политики сработали и какое решение они вернули
Панель статистики в верхней части показывает длительность сеанса, общее количество вызовов инструментов и сводку решений хуков (количество разрешений / отказов / инструкций). Вы можете экспортировать сеанс в файл ZIP или JSONL с помощью кнопки загрузки.

​
Политики

Страница с двумя вкладками для управления политиками и проверки активности.
  • Включайте или отключайте отдельные политики одним нажатием (записывает в ~/.failproofai/policies-config.json)
  • Разверните политику, чтобы настроить её параметры (для политик, поддерживающих policyParams)
  • Устанавливайте или удаляйте хуки для определенной области
  • Установите пользовательский путь файла политик

​
Автоматическое обновление

Панель управления имеет переключатель автоматического обновления в верхней навигации. При включении текущая страница периодически обновляется, отображая новые сеансы и активность политик по мере их появления. Это важно при мониторинге долгих сеансов автономных агентов.

​
Отключение страниц

Если вам нужны только определенные части панели управления, установите FAILPROOFAI_DISABLE_PAGES в список имен страниц, разделенный запятыми: 
FAILPROOFAI_DISABLE_PAGES=policies failproofai
Допустимые значения: policies, projects.

​
Тема оформления

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

​
Настройка пути к проектам

По умолчанию панель управления читает из стандартного каталога проектов Claude Code. Переопределите его для пользовательских настроек: 
CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai

​
Доступ с хоста, отличного от localhost

При запуске панели управления в режиме разработки (npm run dev) и доступе к ней с хоста, отличного от localhost — например, с пользовательского домена, удаленного IP или туннелированного URL-адреса — вы можете увидеть предупреждение: 
⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
Next.js блокирует кроссисточниковый доступ к своему WebSocket HMR (горячей перезагрузки модулей), которая является функцией только для разработки. Чтобы разрешить ваш хост, используйте флаг --allowed-origins: 
npm run dev -- --allowed-origins dashboard.example.com
Для нескольких хостов или IP-адресов передайте список, разделенный запятыми: 
npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
Вы также можете установить переменную окружения FAILPROOFAI_ALLOWED_DEV_ORIGINS: 
FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
Это относится только к режиму разработки. При запуске failproofai (производственный режим) нет WebSocket HMR и нет проблем с кроссисточниковыми ресурсами разработки.