Skip to content

README.ko.md

Latest commit

 

History

History
225 lines (183 loc) · 10.3 KB

README.ko.md

File metadata and controls

225 lines (183 loc) · 10.3 KB
Raw

⚠️ 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 | 🇸🇦 العربية | 🇮🇱 עברית

failproof ai

npm CI Supply Chain Discord Docs License

번역: 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית

코딩 에이전트를 위한 런타임 장애 해결 도구. Claude Code 및 Codex에 연결됩니다. 루프, 위험한 동작, 시크릿 유출을 인시던트가 되기 전에 차단합니다. 지연 없음. 로컬에서 실행.

Failproof AI in action

지원되는 에이전트 CLI

{/* A 6-column table instead of inline runs: table columns never re-wrap, so the grid stays 2×6 at any window width (scrolling on very narrow screens instead of collapsing into ragged orphan rows). */}

Claude Code OpenAI Codex GitHub Copilot Cursor Agent OpenCode Pi
Hermes OpenClaw Factory Droid Devin CLI Antigravity CLI Goose

설치

npm install -g failproofai
failproofai policies --install   # 또는 `failproofai`를 실행하고 최초 실행 프롬프트에서 수락
failproofai

30개의 내장 정책이 즉시 활성화됩니다. 대시보드는 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 키

→ 내장 정책 30개 전체 보기

사용자 정의 정책

.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개 정책 전체
사용자 정의 정책 직접 작성하기
설정 설정 범위 및 병합 규칙
대시보드 세션 모니터 및 정책 활동
아키텍처 훅 시스템 작동 방식

라이선스

Commons Clause가 포함된 MIT 라이선스 — 내부 및 개인 사용은 무료이며, failproofai 자체의 상업적 재판매는 별도 계약이 필요합니다. 전체 내용은 LICENSE를 참조하세요.

기여

CONTRIBUTING.md를 참조하세요. 새로운 정책, 엣지 케이스, 번역 모두 환영합니다.

시작하기 전에 빌드하세요. 먼저 bun install && bun run build를 실행하세요. 이 저장소는 failproofai 자체 훅을 자신에게 적용하며, failproofai 임포트를 컴파일된 dist/ 번들에서 해석합니다 — 빌드 없이는 Cannot find package 'failproofai' 훅 오류가 발생합니다. src/를 변경한 후에는 다시 빌드하세요. 자세한 내용은 Build before the in-repo dev hooks will work를 참조하세요.

Nivedit Jain과 Nikita Agarwal이 만들었습니다. befailproof.ai