Skip to content

Latest commit

 

History

History
180 lines (136 loc) · 8.82 KB

File metadata and controls

180 lines (136 loc) · 8.82 KB

⚠️ 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 Slack Docs License

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

Kodlama ajanları için çalışma zamanı hatası çözümü. Claude Code ve Codex'e bağlanır. Döngüleri, tehlikeli işlemleri ve gizli sızıntılarını olay haline gelmeden önce yakalar. Sıfır gecikme. Yerel olarak çalışır.

Failproof AI in action


Desteklenen ajan CLI'ları

Claude Code        OpenAI Codex        GitHub Copilot        Cursor Agent

OpenCode        Pi        Gemini CLI

Bir veya birden fazla kombinasyon için kancaları yükleyin: failproofai policies --install --cli opencode pi gemini (ya da --cli claude codex copilot cursor opencode pi gemini). Yüklü CLI'ları otomatik olarak algılamak ve seçim yapmak için --cli seçeneğini atlayın.


Kurulum

npm install -g failproofai
failproofai policies --install   # veya sadece `failproofai` komutunu çalıştırıp ilk çalıştırma komutunu kabul edin
failproofai

30 yerleşik politika hemen etkinleştirilir. Kontrol paneli localhost:8020 adresindedir. İlk çalıştırma komutunu FAILPROOFAI_NO_FIRST_RUN=1 ile devre dışı bırakın.


Neyi engeller

Politika Engellediği şey
block-push-master main / master dalına doğrudan gönderimler
block-force-push git push --force
block-work-on-main main / master dalında işlemler, birleştirmeler, yeniden tabanlama
block-rm-rf Özyinelemeli dosya silme
sanitize-api-keys API anahtarlarının ajan bağlamına sızması

Tüm 30 yerleşik politika


Kendi politikalarınız

.failproofai/policies/ klasörüne bir dosya bırakın — bayrak gerekmeksizin otomatik olarak yüklenecektir. Bunu işleyin ve bütün takım bir sonraki çekme operasyonunda bunu alacaktır.

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("Üretim yollarına yazma işlemleri engellenir.");
    return allow();
  },
});

Her politika için üç karar mevcuttur:

Karar Etki
allow() İşleme izin ver
deny(message) Engelle — ileti ajana geri gönderilir
instruct(message) Geçit ver, ancak ajanın sonraki isteminine bağlam ekle

Özel politikalar rehberi


Oturum görünürlüğü

Ajanınızın yaptığı her araç çağrısı yerel olarak kaydedilir. Kontrol paneli, ne çalıştığını, ne engellendi ve politikanın ajana ne söylediğini gösterir — böylece bir şey yanlış gittiğinde tahmin etmek zorunda kalmazsınız. → Kontrol paneli rehberi


Belgeler

Başlarken Kurulum ve ilk adımlar
Yerleşik Politikalar Tüm 30 politika ve parametreleri
Özel Politikalar Kendi politikalarınızı yazın
Yapılandırma Yapılandırma kapsamları ve birleştirme kuralları
Kontrol Paneli Oturum monitörü ve politika etkinliği
Mimari Kanca sisteminin nasıl çalıştığı

Lisans

Commons Clause ile MIT — dahili ve kişisel kullanım için ücretsiz; failproofai'nin kendisinin ticari olarak yeniden satışı ayrı bir anlaşma gerektirir. Tam metin için LICENSE dosyasına bakın.


Katkıda bulunma

CONTRIBUTING.md dosyasına bakın. Yeni politikalar, kenar durumları ve çeviriler hoş karşılanır.

Başlamadan önce derleyin. Önce bun install && bun run build komutunu çalıştırın. Bu depo failproofai'nin kendi kancalarını kendisine uyguluyor ve failproofai içe aktarımını derlenmiş dist/ paketi ile çözüyor — derleme olmaksızın Cannot find package 'failproofai' kanca hataları alacaksınız. src/ değişikliklerinden sonra yeniden derleyin. Bkz. In-repo dev hooks'larının çalışması için önce derleyin.


Nivedit Jain ve Nikita Agarwal tarafından yapılmıştır. befailproof.ai