⚠️ 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 にフックし、ループ・危険な操作・シークレットの漏洩を インシデントになる前に検出・阻止します。レイテンシーゼロ。ローカル動作。
{/* 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). */}
|
|
|
|
|
|
|
|
|
|
|
|
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();
},
});各ポリシーで使用できる 3 つの判定:
| 判定 | 動作 |
|---|---|
allow() |
操作を許可する |
deny(message) |
ブロックする — メッセージがエージェントに返される |
instruct(message) |
通過させつつ、エージェントの次のプロンプトにコンテキストを追加する |
エージェントが行ったすべてのツール呼び出しはローカルに記録されます。ダッシュボードでは、実行された内容・ブロックされた内容・ポリシーがエージェントに伝えた内容を確認できるため、問題が発生した際に推測する必要がありません。→ ダッシュボードガイド
| Getting Started | インストールと最初のステップ |
| Built-in Policies | パラメーター付き全 30 ポリシー |
| Custom Policies | 独自ポリシーの作成方法 |
| Configuration | 設定スコープとマージルール |
| Dashboard | セッションモニターとポリシーアクティビティ |
| Architecture | フックシステムの仕組み |
MIT に Commons Clause を追加 — 社内利用および個人利用は無償。failproofai 自体の商業的な再販には別途契約が必要です。全文は LICENSE を参照してください。
CONTRIBUTING.md を参照してください。新しいポリシー、エッジケース、翻訳はいずれも歓迎します。
開始前にビルドしてください。 まず
bun install && bun run buildを実行してください。このリポジトリは failproofai 自身のフックを自分自身に適用しており、failproofaiのインポートはコンパイル済みのdist/バンドルに対して解決されます。ビルドなしで実行するとCannot find package 'failproofai'というフックエラーが発生します。src/を変更した後は必ず再ビルドしてください。詳細は リポジトリ内の開発用フックを動作させるためのビルド を参照してください。