⚠️ This is an auto-generated translation. For the latest version, see the English README. Community corrections welcome!
🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇪🇸 Español | 🇧🇷 Português | 🇩🇪 Deutsch | 🇫🇷 Français | 🇷🇺 Русский | 🇮🇳 हिन्दी | 🇹🇷 Türkçe | 🇻🇳 Tiếng Việt | 🇮🇹 Italiano | 🇸🇦 العربية | 🇮🇱 עברית
번역: 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית
코딩 에이전트를 위한 런타임 오류 해결 도구. Claude Code 및 Codex에 연동됩니다. 루프, 위험한 동작, 시크릿 유출을 인시던트가 되기 전에 포착합니다. 지연 없음. 로컬에서 실행됩니다.
하나 또는 여러 CLI에 훅을 설치하려면:
failproofai policies --install --cli opencode pi gemini(또는--cli claude codex copilot cursor opencode pi gemini).--cli를 생략하면 설치된 CLI를 자동으로 감지하고 프롬프트가 표시됩니다.
npm install -g failproofai
failproofai policies --install # 또는 `failproofai`를 실행하고 최초 실행 프롬프트에서 수락
failproofai30개의 기본 제공 정책이 즉시 활성화됩니다. 대시보드는 localhost:8020에서 확인할 수 있습니다. FAILPROOFAI_NO_FIRST_RUN=1로 최초 실행 프롬프트를 비활성화할 수 있습니다.
| 정책 | 차단 내용 |
|---|---|
block-push-master |
main / master로의 직접 푸시 |
block-force-push |
git push --force |
block-work-on-main |
main / master에서의 커밋, 머지, 리베이스 |
block-rm-rf |
재귀적 파일 삭제 |
sanitize-api-keys |
에이전트 컨텍스트로 유출되는 API 키 |
.failproofai/policies/ 디렉터리에 파일을 넣기만 하면 자동으로 로드됩니다. 별도의 플래그가 필요 없습니다.
커밋해두면 팀 전체가 다음 풀 시 적용됩니다.
import { customPolicies, deny, allow } from "failproofai";
customPolicies.add({
name: "no-production-writes",
match: { events: ["PreToolUse"] },
fn: async (ctx) => {
if (ctx.toolInput?.file_path?.includes("production"))
return deny("Writes to production paths are blocked.");
return allow();
},
});모든 정책에서 사용할 수 있는 세 가지 결정:
| 결정 | 효과 |
|---|---|
allow() |
작업 허용 |
deny(message) |
차단 — 메시지가 에이전트에게 반환됨 |
instruct(message) |
통과시키되, 에이전트의 다음 프롬프트에 컨텍스트 추가 |
에이전트가 수행하는 모든 도구 호출은 로컬에 기록됩니다. 대시보드에서 실행된 항목, 차단된 항목, 정책이 에이전트에게 전달한 내용을 확인할 수 있어 — 문제가 발생했을 때 추측하지 않아도 됩니다. → 대시보드 가이드
| 시작하기 | 설치 및 첫 번째 단계 |
| 기본 제공 정책 | 파라미터가 포함된 30개 정책 전체 |
| 사용자 정의 정책 | 직접 작성하기 |
| 설정 | 설정 범위 및 병합 규칙 |
| 대시보드 | 세션 모니터 및 정책 활동 |
| 아키텍처 | 훅 시스템 동작 방식 |
MIT에 Commons Clause 적용 — 내부 및 개인 사용은 무료이며, failproofai 자체의 상업적 재판매는 별도 계약이 필요합니다. 전문은 LICENSE를 참고하세요.
CONTRIBUTING.md를 참고하세요. 새로운 정책, 엣지 케이스, 번역 모두 환영합니다.
시작 전에 빌드하세요. 먼저
bun install && bun run build를 실행하세요. 이 저장소는 failproofai의 자체 훅을 자신에게 적용하며,failproofai임포트를 컴파일된dist/번들에서 해석합니다 — 빌드 없이 시작하면Cannot find package 'failproofai'훅 오류가 발생합니다.src/변경 후에는 다시 빌드하세요. 자세한 내용은 빌드 전에 인-레포 개발 훅이 작동하지 않습니다를 참고하세요.
Nivedit Jain과 Nikita Agarwal이 만들었습니다. befailproof.ai