Khởi động bảng điều khiển
http://localhost:8020.
Bảng điều khiển đọc dữ liệu dự án cục bộ, phiên làm việc và cấu hình failproofai trực tiếp từ hệ thống tệp. Các tính năng được xác thực tùy chọn, chẳng hạn như nhắc nhở kiểm toán và lời mời, gửi thông tin cần thiết cho các yêu cầu đó (bao gồm địa chỉ email) đến các API từ xa.
Các trang
Dự án
Liệt kê tất cả Claude Code, OpenAI Codex, GitHub Copilot CLI (beta), Cursor Agent (beta), OpenCode (beta), Pi (beta), Hermes, OpenClaw, Factory Droid, Devin, Antigravity và Goose đượ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 ngang hàng dưới ~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl và nhóm theo cwd được ghi 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ủa nó; các dự án Cursor Agent được khám phá bằng cách quét siêu dữ liệu trên mỗi phiên dưới ~/.cursor/agent-sessions/<sessionId>/ (có thể cấu hình qua CURSOR_HOME, với conversations/ và sessions/ được kiểm tra như là phương án dự phòng) để tìm một số 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 của nó tại ~/.local/share/opencode/opencode.db thông qua opencode db --format json (chúng tôi đọ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 ngang hàng JSONL trên mỗi phiên dưới ~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl (có thể cấu hình qua PI_SESSIONS_DIR) và lấy cwd từ bản ghi đầu tiên của mỗi phiên; các phiên cổng Hermes được đọc trực tiếp từ kho SQLite của nó tại ~/.hermes/state.db (có thể cấu hình qua HERMES_DB_PATH) và được nhóm vào các dự án hermes-<source> theo source (Slack/Telegram/cli/cron — các phiên cổng không có cwd); các phiên cổng OpenClaw được đọc từ ~/.openclaw/agents/<agentId>/sessions/*.jsonl và được nhóm vào các dự án openclaw-<agentId> (cũng không có cwd); các dự án Factory Droid được khám phá từ các bản ghi ngang hàng JSONL tại ~/.factory/sessions/<encoded-cwd>/*.jsonl và được nhóm theo cwd; các dự án Devin từ cơ sở dữ liệu SQLite của nó tại ~/.local/share/devin/cli/sessions.db (được nhóm theo working_directory của mỗi phiên); các dự án Antigravity từ các bản ghi ngang hàng JSONL tại ~/.gemini/antigravity-cli/brain/<conversationId>/…/transcript_full.jsonl và được nhóm theo cwd; và các dự án Goose từ cơ sở dữ liệu SQLite của nó tại ~/.local/share/goose/sessions/sessions.db (được nhóm theo working_dir của mỗi phiên). Một dự án đã được sử dụng bởi nhiều CLI 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 dropdown CLI ở trên bảng để lọc theo một CLI agent cụ thể; URL bảo toàn lựa chọn của bạn dưới dạng ?cli=claude|codex|copilot|cursor|opencode|pi|hermes|openclaw|factory|devin|antigravity|goose.
Mỗi dự án hiển thị:
- Tên dự án (bắt nguồn 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ặcHermes(chàm) - Ngày hoạt động phiên gần đây nhất
Phiên làm việc
Liệt kê tất cả các phiên làm việc 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ượng lệnh gọi công cụ
- Số lượng hoạt động hook (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ự trị: agent đã làm gì và nó có ở đúng đường hay không? Huy hiệu CLI cạnh tiêu đề cho biết phiên là bản ghi Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin, Antigravity hay Goose. 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 - 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 - Đối với 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 theo tính cách về cách agent của bạn thực sự hoạt động trên các phiên quá khứ. Chạy cùng một quét như CLIfailproofai audit nhưng hiển thị nó dưới dạng một áp phích chia sẻ trên một màn hình + bốn phần dưới lớp:
- Áp phích — lấp đầy viewport đầu tiên. Vùng chụp PNG tự chứa với nhãn failproof_ai + kiểm toán · chỉ số nguyên mẫu (
№ NN của 08) + ngày kiểm toán · điểm số (0–100) + xếp hạng phần trăm pill (top 15%) · tên nguyên mẫu (một trongthe optimist,the cowboy,the explorer,the goldfish,the paranoid architect,the precision builder,the hammer,the ghost) + dải 3 từ khóa ·// chỉ N% các agent là nguyên mẫu nàydòng hiếm · ô sigil 8×8 pixel ·audit yours → failproof.aichân trang. Ba nút chia sẻ nằm ngoài ô chụp:post your archetype(ý định X),share on linkedin,download poster. Chụp chạy quahtml-to-imagevì vậy PNG khớp với kết xuất trên màn hình từng pixel (đường viền nét đứt, mặt nạ logo SVG, gradient, số liệu phông chữ — tất cả được bảo tồn). - Điểm mạnh — danh sách hàng tĩnh lặng ✓ của các hành vi mà agent của bạn đã làm đúng, bắt nguồn từ dữ liệu kiểm toán trực tiếp (tỷ lệ lệnh gọi công cụ sạch, không có đẩy trực tiếp đến main, không rò rỉ thông tin xác thực, không có bão thử lại) — mỗi hành vi chỉ được hiển thị khi chính sách liên quan có bản ghi sạch trong cửa sổ kiểm toán.
- Những điều kỳ quặc — bảng những gì trượt qua, xếp hạng theo mức độ nghiêm trọng:
when · what slipped + the policy that would've caught it · severity pill · seen, trong đó sự lặp lại đọcnew(một lần),N× seen(2–9 lần), hoặcrecurring(10+). - Cách cải thiện — danh sách hàng tĩnh lặng, mỗi chính sách được quy định: tên chính sách màu trắng, mô tả một dòng, lệnh cài đặt + nút sao chép ở phía bên phải. Tiêu đề phần đọc
enable all N → projected <score> · <tier>(điểm số bạn sẽ đạt được với mọi sửa chữa được áp dụng), và nút[install all]của nó sao chép lệnhfailproofai policy add a b c …kết hợp cho mọi chính sách được quy định. - Quay lại tốt hơn — hai thẻ song song. Trái: đặt nhắc nhở (
3d/7d/14d/30dbộ chọn nhịp độ; vẫn được duy trì thông qua/api/auth/remindersau khi xác thực). Phải: mở khóa các quyền lợi failproof —invite a friendmở ra một cửa sổ mô-đun lấy danh sách email bạn bè được phân tách bằng dấu phẩy/khoảng trắng/dòng mới (tối đa 10 trên mỗi lần gửi), POSTs để/api/audit/invite, chuyển tiếp đếnPOST /v0/invitecủa máy chủ api. Máy chủ api gửi một email cho mỗi người nhận từinvite@failproof.aivới người gửi Cc vàReply-Tođược đặt, vì vậy người nhận thấy ai mời họ và người gửi nhận được bản sao trong hộp thư đến của họ. Người dùng ẩn danh được định tuyến quaAuthDialogtrước để email của người gửi được biết trước khi lời mời được gửi đi. Lợi ích / thực hiện quyền lợi là một bước tiếp theo.
failproofai audit — xem Audit CLI để biết công cụ quét cơ bản, các cờ được hỗ trợ và bất biến bộ nhớ cache trên mỗi bản ghi. Bảng điều khiển lưu kết quả mới nhất vào bộ nhớ cache tại ~/.failproofai/audit-dashboard.json (chế độ 0600, ô duy nhất, các lần chạy mới ghi đè) vì vậy các lần ghé thăm lại là tức thì; cả bộ nhớ cache trên mỗi bản ghi và toàn bộ kết quả đều bị từ chối khi đọc sau khi chúng lớn hơn 7 ngày vì vậy bảng điều khiển không bao giờ yên tĩnh phục vụ kết quả một tuần tuổi — vượt quá TTL /audit rơi vào trạng thái trống và nhắc chạy lại. Nhấp vào [ re-audit now ] gần cuối báo cáo POSTs /api/audit/run với noCache: true — kiểm toán lại bỏ qua bộ nhớ cache trên mỗi bản ghi và quét lại mọi bản ghi từ đầu chứ không yên tĩnh trả về kết quả được lưu trong bộ nhớ cache — 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 màu hồng dính chặt tại đầu viewport trong lần chạy với bộ đếm thời gian đã trôi qua, và kết quả mới được trao đổi tại chỗ khi thành công (không tải lại toàn trang; kiểm toán lại không thành công để lại 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 (không có bộ nhớ cache hoặc đã hết hạn) và trạng thái không có phiên (bộ nhớ cache tồn tại nhưng quét không tìm thấy bất kỳ bản ghi nào) đượ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 lựa chọn CLI agent nào mà failproofai bảo vệ từ một bảng duy nhất — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi và Hermes đề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 accent có thương hiệu. Chọn hoặc bỏ chọn các CLI bạn muốn và nhấp vàoApply changesđể cài đặt/gỡ cài đặt sự khác biệt trong một bước. Các CLI có tệp nhị phân được phát hiện trên PATH được chọn trước. - Bật hoặc tắt các chính sách cá nhân bằng một lần nhấp (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 để định 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 chính sách tùy chỉnh
Làm mới tự động
Bảng điều khiển có một công tắc làm mới tự động trong điều hướng trên cùng. Khi được bật, trang hiện tại sẽ 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. Thiết yếu cho việc giám sát các phiên agent tự trị 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 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 thiết lập 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ụ, một tên miền tùy chỉnh, một IP từ xa hoặc một URL được đường hầm — bạn có thể thấy một cảnh báo như:
--allowed-origins:
FAILPROOFAI_ALLOWED_DEV_ORIGINS:
Đ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 đa nguồn gốc.
