Failproof AI CLI

Cài đặt CLI cục bộ với npm install -g failproofai. Chạy mà không có tham số để mở bảng điều khiển chính sách cục bộ. Gói này yêu cầu Node.js 20.9 trở lên. Bun 1.3 trở lên được hỗ trợ cho phát triển và cài đặt từ nguồn. failproofai configure và failproofai setup là bí danh cho failproofai config; failproofai p là bí danh cho failproofai policies.

Thiết lập một máy

npm install -g failproofai
failproofai config \
  --connect https://app.befailproof.ai \
  --token <machine-key> \
  --machine-label checkout-prod-01
failproofai policies --install
failproofai config --status

Chạy failproofai mà không có tham số để mở bảng điều khiển chính sách cục bộ.

Lệnh	Kết quả
`failproofai config`	Chạy thiết lập máy tương tác
`failproofai config --connect <url> --token <key>`	Kết nối Cloud ingestion và phân phối chính sách
`failproofai config --status`	Hiển thị trạng thái kết nối, daemon, phân phối và tạm dừng
`failproofai policies`	Liệt kê chính sách tích hợp sẵn, tùy chỉnh, quy ước, gói và được quản lý bởi Cloud
`failproofai policies --install`	Cài đặt hooks và bật chính sách
`failproofai policy add <name>`	Bật một chính sách — một tích hợp sẵn, hoặc `<pack-id>:<name>` từ một gói đã cài đặt
`failproofai policy remove <name>`	Tắt một chính sách, cách đặt tên giống nhau
`failproofai policies --uninstall`	Tắt chính sách hoặc loại bỏ hooks harness
`failproofai pack list`	Liệt kê các gói chính sách đã cài đặt và mỗi chính sách mà chúng có
`failproofai pack add <source>`	Cài đặt một gói chính sách từ bản phát hành GitHub; không có thẻ sẽ lấy phiên bản mới nhất và ghim nó
`failproofai pack add --bundled`	Cài đặt chính sách tích hợp sẵn dưới dạng gói, từ gói này, không có mạng
`failproofai pack build <entry.mjs>`	Xây dựng ba tài sản phát hành cho gói của riêng bạn
`failproofai pack remove <publisher/name>`	Hủy kích hoạt một gói đã cài đặt
`failproofai audit`	Quét lịch sử agent cục bộ và mở chế độ xem audit cục bộ
`failproofai audit --schedule [days] --email <address>`	Lên lịch quét cục bộ định kỳ và gửi email các kết quả của chúng
`failproofai audit --status`	Hiển thị địa chỉ báo cáo, khoảng thời gian và quét được lên lịch tiếp theo
`failproofai audit --no-schedule`	Dừng quét định kỳ mà không xóa lịch sử audit
`failproofai harness list`	Liệt kê các đường dẫn chụp bổ sung
`failproofai flush --wait`	Phân phối spooler sự kiện hiện tại
`failproofai backfill --since 30d`	Đọc lại lịch sử đã vượt qua trước đó
`failproofai config --pause [duration]`	Tạm dừng một phiên cục bộ trong 30 phút theo mặc định, tối đa 8 giờ
`failproofai config --resume`	Tiếp tục một phiên cục bộ tạm dừng; thêm `--all` để xóa tất cả các tạm dừng
`failproofai update`	Hoàn thành di chuyển gói và cập nhật daemon
`failproofai migrate --dry-run`	Xem trước hoặc chạy các di chuyển bố cục nhà chờ xử lý
`failproofai uninstall`	Loại bỏ hooks và daemon trước khi loại bỏ gói
`failproofai --version`	In phiên bản gói được cài đặt
`failproofai --help`	Hiển thị lệnh và cách sử dụng chung

Cờ cấu hình

Cờ	Sử dụng
`--connect <url> --token <key>`	Kết nối không tương tác
`--machine-id <id>`	Đặt ID máy ổn định
`--machine-label <name>`	Đặt hoặc thay đổi nhãn bảng điều khiển
`--no-transcripts`	Gửi quyết định mà không có nội dung bản ghi
`--disconnect`	Dừng kéo chính sách Cloud và phân phối sự kiện
`--status`	Hiển thị trạng thái máy hiện tại
`--pause [duration]`	Tạm dừng phiên mới nhất trong thư mục hiện tại; chấp nhận giây, phút hoặc giờ và mặc định là 30 phút
`--resume`	Kết thúc một tạm dừng phù hợp sớm
`--session <id>`	Nhắm mục tiêu một phiên rõ ràng để tạm dừng hoặc tiếp tục
`--all`	Với `--resume`, kết thúc mọi tạm dừng hoạt động

Tạm dừng cục bộ tạm ngừng chính sách tích hợp sẵn, tùy chỉnh, quy ước và gói cho một phiên. Chúng luôn hết hạn và không vô hiệu hóa chính sách được quản lý bởi Cloud. block-failproofai-commands — luôn bật và không thể bị vô hiệu hóa hoặc tạm dừng chính nó — ngăn chặn một agent được cấy dòng sử dụng lối thoát này.

Cờ chính sách

Cờ	Sử dụng
`--install`, `-i`	Bật chính sách và cài đặt hooks harness
`--uninstall`, `-u`	Tắt chính sách hoặc loại bỏ hooks
`--cli <names...>`	Nhắm mục tiêu một hoặc nhiều harness được hỗ trợ
`--scope user\|project\|local\|all`	Chọn phạm vi cấu hình; `all` dành cho gỡ cài đặt
`--beta`	Bao gồm các chính sách beta
`--custom`, `-c <path>`	Xác thực và tải tệp chính sách tùy chỉnh; có thể lặp lại

Cờ phân phối và bảo trì

Lệnh	Cờ
`backfill`	`--since <30d\|6m\|YYYY-MM-DD>`, `--dry-run`
`flush`	`--wait`, `--timeout <seconds>`
`update`	`--no-daemon`
`migrate`	`--dry-run`
`uninstall`	`--purge`, `--dry-run`, `--yes`

failproofai update nên được chạy sau npm install -g failproofai@latest; nó thực hiện di chuyển bố cục nhà, cài đặt nhị phân daemon phù hợp và khởi động lại dịch vụ. --no-daemon chỉ thực hiện di chuyển bố cục.

Đường dẫn harness

failproofai harness list [harness]
failproofai harness add-path <harness> [label=]<path>
failproofai harness remove-path <harness> <path-or-label>

Các tên harness được hỗ trợ là claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity và goose. Nhãn không gian ID agent dẫn xuất khi hai gốc chứa bản sao của cùng một dự án. Các gốc chồng chéo và nhãn trùng lặp bị từ chối để ngăn chặn thu thập trùng lặp hoặc hỏng con trỏ. Cấu hình đường dẫn bổ sung tải lại mà không cần khởi động lại daemon. Các môi trường vùng chứa có thể thay thế các đường dẫn bổ sung được cấu hình bằng tệp bằng một biến được phân tách bằng dấu phẩy được đặt tên FAILPROOFAI_<HARNESS>_EXTRA_PATHS, ví dụ:

export FAILPROOFAI_OPENCLAW_EXTRA_PATHS="user1=/srv/openclaw-a,user2=/srv/openclaw-b"

Biến môi trường

Sử dụng tệp cấu hình cho hành vi máy liên tục. Các biến môi trường rất hữu ích cho các vùng chứa, bài kiểm tra và một quy trình.

Biến	Sử dụng
`FAILPROOFAI_HOME`	Chuyển bố cục `~/.failproofai` hoàn chỉnh
`FAILPROOFAI_LOG_LEVEL`	Đặt mức chi tiết đăng nhập cục bộ
`FAILPROOFAI_HOOK_LOG_FILE`	Viết chẩn đoán hook vào một tệp được chọn
`FAILPROOFAI_TELEMETRY_DISABLED=1`	Tắt telemetry ẩn danh cho quy trình này
`FAILPROOFAI_NO_FIRST_RUN=1`	Bỏ qua thiết lập chạy lần đầu tương tác
`FAILPROOFAI_NO_AUTO_AUDIT=1`	Bỏ qua audit cục bộ sau thiết lập
`FAILPROOFAI_LLM_BASE_URL`	Ghi đè điểm cuối tương thích với OpenAI được sử dụng bởi chính sách LLM
`FAILPROOFAI_LLM_API_KEY`	Cung cấp khóa API được sử dụng bởi chính sách LLM
`FAILPROOFAI_LLM_MODEL`	Chọn mô hình được sử dụng bởi chính sách LLM
`FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS`	Ràng buộc tải mô-đun chính sách tùy chỉnh
`FAILPROOFAI_NO_DOWNLOAD=1`	Từ chối tìm nạp gói và nhị phân daemon; những gì được cài đặt tiếp tục thực thi
`FAILPROOFAI_PACK_BASE_URL`	Tìm nạp gói từ một bản sao thay vì `github.com`
`FAILPROOFAI_<HARNESS>_EXTRA_PATHS`	Thay thế các đường dẫn chụp bổ sung được cấu hình cho một harness
`NO_COLOR`	Tắt đầu ra thiết bị đầu cuối có màu

Các biến nhà dành riêng cho agent chẳng hạn như CLAUDE_PROJECTS_PATH, CURSOR_HOME, HERMES_HOME và OPENCLAW_HOME ghi đè nơi Failproof AI khám phá các phiên cục bộ cho harness đó.

Tạm dừng hoặc loại bỏ một máy một cách an toàn

failproofai config --pause
failproofai config --status
failproofai config --resume

Tạm dừng phiên cục bộ không vô hiệu hóa chính sách được quản lý bởi Cloud. Khôi phục các triển khai Cloud thông qua quy trình công việc thực thi Cloud khi chính triển khai đó là vấn đề. Trước khi loại bỏ gói npm, hãy loại bỏ các hooks đã cài đặt và daemon:

failproofai uninstall --dry-run
failproofai uninstall --yes
npm rm -g failproofai

Chạy failproofai <command> --help để biết chi tiết dành riêng cho phiên bản.

Chạy failproofai uninstall trước npm rm -g failproofai; npm không loại bỏ các hooks agent được cài đặt hoặc dịch vụ daemon.

Connect your agents

Reference

Thiết lập một máy

Cờ cấu hình

Cờ chính sách

Cờ phân phối và bảo trì

Đường dẫn harness

Biến môi trường

Tạm dừng hoặc loại bỏ một máy một cách an toàn

​Thiết lập một máy

​Cờ cấu hình

​Cờ chính sách

​Cờ phân phối và bảo trì

​Đường dẫn harness

​Biến môi trường

​Tạm dừng hoặc loại bỏ một máy một cách an toàn

Thiết lập một máy

Cờ cấu hình

Cờ chính sách

Cờ phân phối và bảo trì

Đường dẫn harness

Biến môi trường

Tạm dừng hoặc loại bỏ một máy một cách an toàn