Khởi động bảng điều khiển
http://localhost:8020.
Bảng điều khiển đọc trực tiếp từ hệ thống tập tin - các thư mục dự án Claude Code của bạn và các tập tin cấu hình failproofai. Không có gì được ghi vào dịch vụ từ xa.
Các trang
Dự án
Liệt kê tất cả các dự án Claude Code, OpenAI Codex, GitHub Copilot CLI (beta), Cursor Agent (beta), OpenCode (beta), Pi (beta), và Gemini CLI (beta) được tìm thấy trên máy của bạn. Các dự án Claude được khám phá từ~/.claude/projects/ (hoặc đường dẫn được đặt bởi CLAUDE_PROJECTS_PATH); các dự án Codex được khám phá bằng cách quét mọi bản ghi dưới ~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl và nhóm theo cwd được ghi lại trong bản ghi đầu tiên của mỗi phiên; các dự án Copilot CLI được khám phá bằng cách quét mỗi ~/.copilot/session-state/<sessionId>/workspace.yaml (có thể cấu hình qua COPILOT_HOME) và nhóm theo trường cwd; các dự án Cursor Agent được khám phá bằng cách quét siêu dữ liệu theo phiên dưới ~/.cursor/agent-sessions/<sessionId>/ (có thể cấu hình qua CURSOR_HOME, với conversations/ và sessions/ được thử như phương án dự phòng) để tìm một vô hướng cwd trong meta.json / session.json / workspace.yaml; các dự án OpenCode được khám phá bằng cách truy vấn cơ sở dữ liệu SQLite tại ~/.local/share/opencode/opencode.db thông qua opencode db --format json (chúng tôi đọc các bảng session và project và nhóm theo project_id); các dự án Pi được khám phá bằng cách quét bản ghi JSONL theo phiên dưới ~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl (có thể cấu hình qua PI_SESSIONS_DIR) và rút cwd từ bản ghi đầu tiên của mỗi phiên; các dự án Gemini CLI được khám phá bằng cách quét ~/.gemini/tmp/<basename>/chats/session-<timestamp>-<uuid-prefix>.jsonl (có thể cấu hình qua GEMINI_SESSIONS_DIR) và khôi phục cwd chính tắc từ dấu .project_root liền kề. Một dự án đã được sử dụng bởi nhiều CLI sẽ hiển thị dưới dạng một hàng duy nhất với tất cả các huy hiệu phù hợp. Sử dụng trình đơn thả xuống CLI phía trên bảng để lọc theo một agent CLI cụ thể; URL sẽ lưu lựa chọn của bạn là ?cli=claude|codex|copilot|cursor|opencode|pi|gemini.
Mỗi dự án hiển thị:
- Tên dự án (được lấy từ đường dẫn thư mục)
- Huy hiệu CLI —
Claude Code(cam),OpenAI Codex(tím),GitHub Copilot(xanh),Cursor Agent(ngọc lục bảo),OpenCode(hổ phách),Pi(hồng), và/hoặcGemini CLI(xanh nhạt) - Ngày hoạt động phiên gần đây nhất
Phiên
Liệt kê tất cả các phiên trong một dự án. Mỗi phiên hiển thị:- ID phiên
- Dấu thời gian bắt đầu và kết thúc
- Số lần gọi công cụ
- Số lượng hoạt động hook (các chính sách đã kích hoạt)
Trình xem phiên
Trình xem phiên trả lời câu hỏi chính cho các agent tự động: agent đã làm gì và liệu nó có giữ đúng hướng? Huy hiệu CLI bên cạnh tiêu đề cho biết phiên đó là bản ghi Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi hay Gemini CLI. Nó hiển thị một dòng thời gian của mọi thứ đã xảy ra trong một phiên:- Tin nhắn - Các phản hồi văn bản của Claude và lời nhắc của người dùng
- Lệnh gọi công cụ - Mỗi công cụ mà Claude đã gọi, với đầu vào và đầu ra của nó
- Hoạt động chính sách - Cho mỗi lệnh gọi công cụ, những chính sách nào đã kích hoạt và quyết định nào mà chúng trả về
session / messages / parts cơ bản.
Kiểm toán
Một báo cáo được điều hành bởi tính cách về cách agent của bạn thực sự hoạt động trên các phiên trước đây. Chạy lần quét tương tự như CLIfailproofai audit nhưng hiển thị nó dưới dạng bảng điều khiển sáu phần:
- Nhân dạng — phân loại agent của bạn thành một trong 8 nguyên mẫu (
the optimist,the cowboy,the explorer,the goldfish,the paranoid architect,the precision builder,the hammer,the ghost) dựa trên những bộ phát hiện nào + chính sách đã kích hoạt và mức độ nặng. Hiển thị một sigil 8×8 pixel, dòng thẻ nguyên mẫu, khungcommon in/primary risk, và dòng kết thúc duy nhất. - Khoe tỏ agent của bạn — chụp thẻ nhân dạng dưới dạng PNG 1200×630 phù hợp để đăng trên X / LinkedIn (nhấp
make poster). - Điểm mạnh — các hành vi được xác nhận màu xanh lá cây mà agent của bạn đã làm đúng, được lấy từ dữ liệu kiểm toán trực tiếp (tỷ lệ lệnh gọi công cụ sạch, độ dài phiên trung bình, không rò rỉ thông tin đăng nhập, không có bão thử lại, v.v.).
- Điểm + bảng xếp hạng — điểm 0–100 với xếp hạng chữ (S/A/B/C/D/F), biểu đồ phân phối hiển thị vị trí của bạn trong nhóm, văn bản mô tả (
a B starts at 71. you're 13 points away.), và bảng bảng xếp hạng với hàng của bạn được làm nổi bật. - Kết quả — các thẻ mỗi kết quả được xếp hạng theo tác động. Mỗi thẻ bề mặt những gì đã xảy ra, chi phí là bao nhiêu, một mẫu bằng chứng với các lệnh được chụp thực tế, và chính sách failproofai sẽ bắt lại cùng một mẫu (
$ failproofai policy add <slug>, click-to-copy). - Chính sách được quy định + vòng lặp trả về — một lưới của mỗi chính sách builtin chưa bật sẽ đóng một khoảng cách, với một callout điểm dự báo, cộng với một CTA
re-audit in 7 days.
failproofai audit — xem Audit CLI cho công cụ quét cơ bản, các cờ được hỗ trợ và các bất biến bộ đệm mỗi bản ghi. Bảng điều khiển lưu đệm kết quả mới nhất tại ~/.failproofai/audit-dashboard.json (chế độ 0600, khe duy nhất, các lần chạy mới ghi đè) để các lần truy cập lại diễn ra ngay lập tức; cả bộ đệm mỗi bản ghi và toàn bộ kết quả đều bị từ chối khi đọc khi chúng cũ hơn 7 ngày do đó bảng điều khiển không bao giờ im lặng cung cấp kết quả tuần lễ cũ — vượt quá TTL /audit rơi xuống trạng thái trống rỗng của nó và nhắc một lần chạy mới. Nhấp [ re-audit now ] gần dưới cùng của báo cáo POST /api/audit/run với noCache: true — tái kiểm toán bỏ qua bộ đệm mỗi bản ghi và quét lại mỗi bản ghi từ đầu chứ không phải im lặng trả về kết quả được lưu đệm — và bảng điều khiển thăm dò /api/audit/status ở 1Hz cho đến khi lần chạy kết thúc; một dải tiến trình hồng dính chắc chắn ở phía trên cùng của khung nhìn trong quá trình chạy với bộ đếm thời gian đã trôi qua, và kết quả tươi mới hoán đổi tại chỗ khi thành công (không có làm mới toàn trang; một tái kiểm toán không thành công để báo cáo trước đó nguyên vẹn). Khi thất bại, dải chuyển thành màu đỏ với bản sao được khóa từ RerunError.kind (timeout / network / post_failed). Trạng thái trống rỗng (không có bộ đệm hoặc hết hạn) và trạng thái không có phiên (bộ đệm tồn tại nhưng lần quét không tìm thấy bản ghi) được hiển thị riêng.
Chính sách
Một trang hai tab để quản lý chính sách và xem lại hoạt động.- Tab chính sách
- Tab hoạt động
- Chọn nhiều agent CLI nào mà failproofai bảo vệ từ một bảng điều khiển duy nhất — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi, và Gemini CLI đều có một hàng với trạng thái cài đặt (
Active/Detected/Inactive), đường dẫn cài đặt phạm vi người dùng và một cách nhấn mạnh màu thương hiệu. Kiểm tra hoặc bỏ kiểm tra các CLI bạn muốn và nhấpApply changesđể cài đặt/gỡ cài đặt sự khác biệt trong một bước. Các CLI có nhị phân được phát hiện trên PATH được kiểm tra trước. - Bật hoặc tắt các chính sách riêng lẻ bằng một cú nhấp chuột (ghi vào
~/.failproofai/policies-config.json— được chia sẻ trên mỗi CLI được cài đặt) - Mở rộng một chính sách để cấu hình các tham số của nó (đối với các chính sách hỗ trợ
policyParams) - Đặt đường dẫn tập tin chính sách tùy chỉnh
Tự động làm mới
Bảng điều khiển có công tắc tự động làm mới trong điều hướng hàng đầu. Khi bật, trang hiện tại được làm mới định kỳ để hiển thị các phiên mới và hoạt động chính sách khi chúng xuất hiện. Cần thiết để giám sát các phiên agent tự động chạy dài.Vô hiệu hóa các trang
Nếu bạn chỉ cần một số phần của bảng điều khiển, hãy đặtFAILPROOFAI_DISABLE_PAGES thành danh sách các tên trang được phân tách bằng dấu phẩy:
policies, projects, audit.
Cấu hình đường dẫn dự án
Theo mặc định, bảng điều khiển đọc từ thư mục dự án Claude Code tiêu chuẩn. Ghi đè nó cho các cài đặt tùy chỉnh:Truy cập từ máy chủ không phải localhost
Khi chạy bảng điều khiển ở chế độ phát triển (npm run dev) và truy cập nó từ tên máy chủ khác với localhost - ví dụ, tên miền tùy chỉnh, IP từ xa hoặc URL được chuyển hướng - bạn có thể thấy cảnh báo như:
--allowed-origins:
FAILPROOFAI_ALLOWED_DEV_ORIGINS thay thế:
Điều này chỉ áp dụng cho chế độ phát triển. Khi chạy
failproofai (chế độ sản xuất), không có websocket HMR và không có vấn đề tài nguyên phát triển nguồn chéo.