Başlarken

Gereksinimler

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

Kurulum

npm install -g failproofai

bun add -g failproofai

Hızlı başlangıç

Politikaları etkinleştirin

Politikalar, ajanın her araç çağrısından önce ve sonra çalışan kurallardır. Yıkıcı komutları, gizli bilgi sızıntılarını ve hasara neden olmadan diğer başarısızlık modlarını yakalar.

failproofai policies --install

Bu, yüklü ajan CLI’lerinize hook girişleri 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şturulmuş plugin shim’i ve ~/.config/opencode/opencode.json dosyasındaki plugin dizisinde bir kayıt girişi, Pi’nin ~/.pi/agent/settings.json veya Hermes’in ~/.hermes/config.yaml dosyası). Birden fazla varsa size sorulacak; --cli claude codex copilot cursor opencode pi hermes (herhangi bir alt küme) geçerek sorguyu atlayabilirsiniz.GitHub Copilot CLI, Cursor Agent, OpenCode ve Pi desteği beta aşamasındadır — --cli copilot, --cli cursor, --cli opencode veya --cli pi ile kurun. Hermes (hermes-agent, bir Slack/Telegram ağ geçidi) --cli hermes ile kullanıcı kapsamında yüklenir ve ayrıca çevrimdışı bir denetim kaynağıdır.

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 hermes --scope user
failproofai policies --install block-sudo block-rm-rf sanitize-api-keys

Doğrulayın

failproofai policies

Her politikayı, etkinleştirilip etkinleştirilmediğini ve yapılandırılmış parametreleri gösterir.

Panoyu başlatın

failproofai

Oturumları göz atabilir, araç çağrılarını inceleyebilir ve politikaları yönetebileceğiniz http://localhost:8020 konumundaki 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 bunu otomatik olarak durdurur. Bunu çalıştırılır durumda bırakın ve panoda ne olduğunu gözden geçirin.

Politikalar nasıl çalışır

Ajan bir araç her çalıştırdığında, Claude Code failproofai’ı bir alt işlem olarak çağırır:

Claude Code  →  failproofai --hook PreToolUse  →  stdin JSON'ı okur
                                                 politikaları değerlendirir
                                                 kararı stdout'a yazar

Her politika üç karardan birini döndürür:

allow - ajan normal şekilde devam eder
deny - eylem engellenir, ajanına neden engelleneceği söylenir
instruct - ajanın isteminine ek bağlam eklenir

Politikalar yerel işleminizde çalışır. Hiçbir şey uzak bir hizmete gönderilmez.

Kural tabanlı politikalarla ekip politikaları ayarlayın

Ekibiniz 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 — bayrak yok, yapılandırma değişikliği yok, kurulum komutu yok.

Politikalar dizinini oluşturun

mkdir -p .failproofai/policies

Politika dosyaları ekleyin

Başlangıç örneklerini kopyalayın veya kendi dosyalarınızı 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("Run tests before committing.");
    }
    return allow();
  },
});

Git'e işleyin

git add .failproofai/policies/
git commit -m "Add team quality policies"

failproofai yüklü olan her ekip üyesi bu politikaları otomatik olarak alır. Geliştirici başına kurulum gerekmez.

Tüm ekibin aynı standartları paylaşması için .failproofai/policies/ dizinini deponuza işleyin. Ekibiniz yeni başarısızlık modları keşfettikçe politika ekleyin ve gönderin — herkes bir sonraki git pull işleminde güncellemeyi alır. Zamanla bu politikalar, sürekli iyileşen ve ekibi güvende tutan canlı bir kalite standardı haline gelir.

Veri depolama

Tüm yapılandırma ve günlükler makinenizde kalır:

Yol	Ne depolar
`~/.failproofai/policies-config.json`	Genel politika yapılandırması
`~/.failproofai/hook-activity.jsonl`	Hook yürütme geçmişi
`~/.failproofai/hook.log`	Özel hook hataları için 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 (gitignore)

Kaldırma

failproofai policies --uninstall

~/.claude/settings.json dosyasından hook girişlerini kaldırır. ~/.failproofai/ içindeki yapılandırma dosyaları korunur.

Sonraki adımlar

Yapılandırma

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

Yerleşik politikalar

Parameterlerle 26 politikanın tümü

Özel politikalar

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

Ajan izleyici

Oturumları izleyin ve politika etkinliğini gözden geçirin

Başlangıç

Temel Kavramlar

CLI

Araçlar

Gelişmiş

Örnekler

Gereksinimler

Kurulum

Hızlı başlangıç

Politikalar nasıl çalışır

Kural tabanlı politikalarla ekip politikaları ayarlayın

Veri depolama

Kaldırma

Sonraki adımlar

Yapılandırma

Yerleşik politikalar

Özel politikalar

Ajan izleyici

​Gereksinimler

​Kurulum

​Hızlı başlangıç

​Politikalar nasıl çalışır

​Kural tabanlı politikalarla ekip politikaları ayarlayın

​Veri depolama

​Kaldırma

​Sonraki adımlar

Yapılandırma

Yerleşik politikalar

Özel politikalar

Ajan izleyici

Gereksinimler

Kurulum

Hızlı başlangıç

Politikalar nasıl çalışır

Kural tabanlı politikalarla ekip politikaları ayarlayın

Veri depolama

Kaldırma

Sonraki adımlar