Ana içeriğe atla

​
Gereksinimler

  • Node.js >= 20.9.0
  • Bun >= 1.3.0 (isteğe bağlı - yalnızca kaynaktan derleme için gerekli)

​
Kurulum

npm install -g failproofai

​
Hızlı başlangıç

1

Politikaları etkinleştirin

Politikalar, her ajan araç çağrısından önce ve sonra çalışan kurallardır. Yıkıcı komutları, gizli bilgi sızıntılarını ve hasar vermeden önce diğer hata modlarını yakalarlar.
failproofai policies --install
Bu, yüklü ajan CLI’lerinize kanca girdileri yazar (Claude Code’un ~/.claude/settings.json, OpenAI Codex’in ~/.codex/hooks.json, GitHub Copilot CLI’nin ~/.copilot/hooks/failproofai.json, Cursor Agent’ın ~/.cursor/hooks.json, OpenCode’un ~/.config/opencode/plugins/failproofai.mjs konumundaki oluşturulan eklenti shim’i ve ~/.config/opencode/opencode.json dosyasının plugin dizisinde bir kayıt girdisi, Pi’nin ~/.pi/agent/settings.json veya Gemini CLI’nin ~/.gemini/settings.json). Birden fazlası mevcut olduğunda size sorulacaktır; istem atlamak için --cli claude codex copilot cursor opencode pi gemini (herhangi bir alt küme) parametresini geçin.GitHub Copilot CLI, Cursor Agent, OpenCode, Pi ve Gemini CLI desteği beta aşamasındadır — --cli copilot, --cli cursor, --cli opencode, --cli pi veya --cli gemini ile yükleyin.
failproofai policies --install --scope project
failproofai policies --install --cli codex --scope project
failproofai policies --install --cli copilot --scope project
failproofai policies --install --cli cursor --scope project
failproofai policies --install --cli opencode --scope project
failproofai policies --install --cli pi --scope project
failproofai policies --install --cli gemini --scope project
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
2

Doğrulayın

failproofai policies
Her politikayı, etkin olup olmadığını ve yapılandırılmış parametreleri gösterir.
3

Panoyu başlatın

failproofai
http://localhost:8020 konumunda oturumları tarayabileceğiniz, araç çağrılarını inceleyebileceğiniz ve politikaları yönetebileceğiniz yerel bir panoyu açar.
4

Ajanınızı çalıştırın

Claude Code’u her zamanki gibi başlatın. Ajan riskli bir şey denerse, failproofai otomatik olarak bunu engeller. Bunu arka planda çalışır bırakın ve panoda ne olduğunu gözden geçirin.

​
Politikalar nasıl çalışır?

Bir ajan bir araç çalıştırdığında, Claude Code failproofai’yi bir alt işlem olarak çağırır: 
Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON'u okur
                                                 politikaları değerlendirir
                                                 kararı stdout'a yazar
Her politika üç karardan birini döndürür:
  • allow - ajan normal şekilde ilerlenir
  • deny - işlem engellenir, ajana neden olduğu söylenir
  • instruct - ajanın istemesine ekstra bağlam eklenir
Politikalar yerel işleminizde çalışır. Uzak bir hizmete hiçbir şey gönderilmez.

​
Kural tabanlı politikalarla takım politikaları kurun

Takım genelinde kalite standartları oluşturmanın en hızlı yolu .failproofai/policies/ kuralıdır. Bu dizine politika dosyalarını bırakın ve otomatik olarak yüklenir — hiçbir bayrak, yapılandırma değişikliği veya kurulum komutu gerekmez.
1

Politikalar dizinini oluşturun

mkdir -p .failproofai/policies
2

Politika dosyaları ekleyin

Başlangıç örneklerini kopyalayın veya kendi örneklerinizi yazın:
cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
Veya yeni bir tane oluşturun:
// .failproofai/policies/team-policies.mjs
import { customPolicies, allow, deny, instruct } from "failproofai";

customPolicies.add({
  name: "test-before-commit",
  match: { events: ["PreToolUse"] },
  fn: async (ctx) => {
    if (ctx.toolName !== "Bash") return allow();
    if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
      return instruct("Commit yapmadan önce testleri çalıştırın.");
    }
    return allow();
  },
});
3

Git'e işleyin

git add .failproofai/policies/
git commit -m "Takım kalite politikaları ekle"
failproofai yüklü olan her takım üyesi bu politikaları otomatik olarak alır. Geliştirici başına kurulum gerekmez.
.failproofai/policies/ dosyasını deponuza işleyin, böylece tüm takım aynı standartları paylaşır. Takımınız yeni hata modları keşfettikçe, politikalar ekleyin ve gönderin — herkes bir sonraki git pull konusunda güncelleme alır. Zaman içinde bu politikalar, gelişmeye devam eden yaşayan bir kalite standardı haline gelir.

​
Veri depolama

Tüm yapılandırma ve günlükler makinenizde kalır:
YolDepoladığı şey
~/.failproofai/policies-config.jsonGenel politika yapılandırması
~/.failproofai/hook-activity.jsonlKanca yürütme geçmişi
~/.failproofai/hook.logÖzel kanca hatalarına ilişkin hata ayıklama günlüğü
.failproofai/policies-config.jsonProje başına yapılandırma (işlenmiş)
.failproofai/policies-config.local.jsonKişisel geçersiz kılmalar (gitignored)

​
Kaldırma

failproofai policies --uninstall
~/.claude/settings.json dosyasından kanca girdilerini kaldırır. ~/.failproofai/ konumundaki yapılandırma dosyaları tutulur.

​
Sonraki adımlar

Yapılandırma

Kapsamlar ve yapılandırma dosyası biçimi

Yerleşik politikalar

Parametreleri olan 26 politikanın tümü

Özel politikalar

JavaScript’te kendi politikalarınızı yazın

Ajan monitörü

Oturumları izleyin ve politika faaliyetini gözden geçirin