Skip to main content
npm install -g failproofai로 로컬 CLI를 설치합니다. 인수 없이 실행하면 로컬 정책 대시보드가 열립니다. 이 패키지는 Node.js 20.9 이상이 필요합니다. 개발 및 소스 설치에는 Bun 1.3 이상이 지원됩니다. failproofai configure와 failproofai setup은 failproofai config의 별칭이며, failproofai p는 failproofai policies의 별칭입니다.

​
머신 설정

인수 없이 failproofai를 실행하면 로컬 정책 대시보드가 열립니다.

​
설정 플래그

로컬 일시 중지는 한 세션에 대해 내장, 사용자 정의, 컨벤션 정책을 중단합니다. 항상 만료되며 Cloud 관리 정책은 비활성화하지 않습니다. block-self-pause는 계측된 에이전트가 이 우회 수단을 스스로 사용하지 못하도록 방지합니다.

​
정책 플래그

​
전달 및 유지 관리 플래그

failproofai update는 npm install -g failproofai@latest 실행 후에 사용해야 합니다. 홈 레이아웃 마이그레이션을 수행하고, 대응하는 데몬 바이너리를 설치하며, 서비스를 재시작합니다. --no-daemon은 레이아웃 마이그레이션만 수행합니다.

​
하네스 경로

지원되는 하네스 이름은 claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity, goose입니다. 레이블은 두 루트에 동일한 프로젝트 복사본이 있을 때 파생된 에이전트 ID의 네임스페이스를 구분합니다. 중복 컬렉션이나 커서 손상을 방지하기 위해 겹치는 루트와 중복 레이블은 거부됩니다. 추가 경로 설정은 데몬 재시작 없이 다시 로드됩니다. 컨테이너 환경에서는 파일로 설정된 추가 경로를 FAILPROOFAI_<HARNESS>_EXTRA_PATHS라는 쉼표로 구분된 변수로 대체할 수 있습니다. 예시:

​
환경 변수

지속적인 머신 동작에는 설정 파일을 사용하세요. 환경 변수는 컨테이너, 테스트, 단일 프로세스에 가장 유용합니다. CLAUDE_PROJECTS_PATH, CURSOR_HOME, HERMES_HOME, OPENCLAW_HOME과 같은 에이전트별 홈 변수는 Failproof AI가 해당 하네스의 로컬 세션을 검색하는 위치를 재정의합니다.

​
머신을 안전하게 일시 중지하거나 제거하기

로컬 세션 일시 중지는 Cloud 관리 정책을 비활성화하지 않습니다. 롤아웃 자체에 문제가 있는 경우 Cloud 적용 워크플로를 통해 Cloud 배포를 복원하세요. npm 패키지를 제거하기 전에 설치된 훅과 데몬을 먼저 제거하세요:
버전별 세부 정보는 failproofai <command> --help를 실행하세요.
npm rm -g failproofai 전에 반드시 failproofai uninstall을 실행하세요. npm은 설치된 에이전트 훅이나 데몬 서비스를 제거하지 않습니다.