Başlangıç

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

bun add -g failproofai

Hızlı başlangıç

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

Doğrulayın

failproofai policies

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

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.

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.

Politikalar dizinini oluşturun

mkdir -p .failproofai/policies

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();
  },
});

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:

Yol	Depoladığı şey
`~/.failproofai/policies-config.json`	Genel politika yapılandırması
`~/.failproofai/hook-activity.jsonl`	Kanca yürütme geçmişi
`~/.failproofai/hook.log`	Özel kanca hatalarına ilişkin hata ayıklama günlüğü
`.failproofai/policies-config.json`	Proje başına yapılandırma (işlenmiş)
`.failproofai/policies-config.local.json`	Kiş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

Temel Kavramlar

CLI

Araçlar

Gelişmiş

Başlangıç

Gereksinimler

Kurulum

Hızlı başlangıç

Politikalar nasıl çalışır?

Kural tabanlı politikalarla takım politikaları kurun

Veri depolama

Kaldırma

Sonraki adımlar

Yapılandırma

Yerleşik politikalar

Özel politikalar

Ajan monitörü

​Gereksinimler

​Kurulum

​Hızlı başlangıç

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

​Kural tabanlı politikalarla takım politikaları kurun

​Veri depolama

​Kaldırma

​Sonraki adımlar

Yapılandırma

Yerleşik politikalar

Özel politikalar

Ajan monitörü

Gereksinimler

Kurulum

Hızlı başlangıç

Politikalar nasıl çalışır?

Kural tabanlı politikalarla takım politikaları kurun

Veri depolama

Kaldırma

Sonraki adımlar