Failproof AI CLI

Yerel CLI’yi npm install -g failproofai ile yükle. Bağımsız değişken olmadan çalıştırarak yerel politika panosunu aç. Paket Node.js 20.9 veya daha yeni bir sürümünü gerektirir. Bun 1.3 veya daha yeni sürümü geliştirme ve kaynak yüklemeleri için desteklenir. failproofai configure ve failproofai setup, failproofai config için takma adlardır; failproofai p, failproofai policies için bir takma addır.

Makine Kurulumu

npm install -g failproofai
failproofai config \
  --connect https://app.befailproof.ai \
  --token <machine-key> \
  --machine-label checkout-prod-01
failproofai policies --install
failproofai config --status

Yerel politika panosunu açmak için failproofai komutunu bağımsız değişken olmadan çalıştır.

Komut	Sonuç
`failproofai config`	Etkileşimli makine kurulumunu çalıştır
`failproofai config --connect <url> --token <key>`	Cloud alımı ve politika sunumunu bağla
`failproofai config --status`	Bağlantı, daemon, sunum ve duraklatma durumunu göster
`failproofai policies`	Yerleşik, özel, kural, paket ve Cloud tarafından yönetilen politikaları listele
`failproofai policies --install`	Hook yükle ve politikaları etkinleştir
`failproofai policy add <name>`	Bir politikayı etkinleştir — yerleşik veya yüklenmiş paketten `<pack-id>:<name>`
`failproofai policy remove <name>`	Bir politikayı devre dışı bırak, aynı adlandırma
`failproofai policies --uninstall`	Politikaları devre dışı bırak veya harness hook’larını kaldır
`failproofai pack list`	Yüklenmiş politika paketlerini ve her birinin taşıdığı her politikayı listele
`failproofai pack add <source>`	Bir politika paketini GitHub sürümünden yükle; etiket olmayan en yeni sürümü alır ve sabitleri
`failproofai pack add --bundled`	Yerleşik politikaları bir paket olarak yükle, bu paketten, ağ olmadan
`failproofai pack build <entry.mjs>`	Kendi paketiniz için üç sürüm varlığını oluştur
`failproofai pack remove <publisher/name>`	Yüklenmiş bir paketi deaktive et
`failproofai audit`	Yerel agent geçmişini tara ve yerel denetim görünümünü aç
`failproofai audit --schedule [days] --email <address>`	Yinelenen yerel taramaları zamanla ve bulgularını e-postayla gönder
`failproofai audit --status`	Rapor adresini, aralığını ve sonraki planlanan taramayı göster
`failproofai audit --no-schedule`	Denetim geçmişini silmeden yinelenen taramaları durdur
`failproofai harness list`	Ekstra yakalama yollarını listele
`failproofai flush --wait`	Geçerli olay spool’unu teslim et
`failproofai backfill --since 30d`	Daha önce geçiş yapılan geçmişi yeniden oku
`failproofai config --pause [duration]`	Bir yerel oturumu varsayılan olarak 30 dakika, en fazla 8 saat duraklatabilir
`failproofai config --resume`	Duraklatılan bir yerel oturumuna devam et; tüm duraklatmaları temizlemek için `--all` ekle
`failproofai update`	Paket geçişlerini tamamla ve daemon’ı güncelle
`failproofai migrate --dry-run`	Bekleyen home-layout geçişlerinin önizlemesini görün veya çalıştırın
`failproofai uninstall`	Paketi kaldırmadan önce hook’ları ve daemon’ı kaldır
`failproofai --version`	Yüklenmiş paket sürümünü yazdır
`failproofai --help`	Komutları ve genel kullanımı göster

Yapılandırma bayrakları

Bayrak	Kullanım
`--connect <url> --token <key>`	Etkileşimsiz olarak bağla
`--machine-id <id>`	Kararlı makine kimliğini ayarla
`--machine-label <name>`	Pano etiketini ayarla veya değiştir
`--no-transcripts`	Kararları transkript içeriği olmadan gönder
`--disconnect`	Cloud politika çekişlerini ve olay sunumunu durdur
`--status`	Geçerli makine durumunu göster
`--pause [duration]`	Geçerli dizinde en yeni oturumu duraklatabilir; saniye, dakika veya saat kabul eder ve varsayılan 30 dakikadır
`--resume`	Eşleşen bir duraklatmayı erken sonlandır
`--session <id>`	Duraklatma veya devam etme için açık bir oturum hedefle
`--all`	`--resume` ile, her etkin duraklatmayı sonlandır

Yerel duraklatmalar, bir oturum için yerleşik, özel, kural ve paket politikalarını askıya alır. Bunlar her zaman sona erer ve Cloud tarafından yönetilen politikaları devre dışı bırakmaz. Her zaman açık olan ve devre dışı bırakılamayan veya duraklatılamayan block-failproofai-commands, enstrümantal agent’ın bu kaçış kapısını kendisi kullanmasını engeller.

Politika bayrakları

Bayrak	Kullanım
`--install`, `-i`	Politikaları etkinleştir ve harness hook’larını yükle
`--uninstall`, `-u`	Politikaları devre dışı bırak veya hook’ları kaldır
`--cli <names...>`	Desteklenen bir veya daha fazla harness’i hedefle
`--scope user\|project\|local\|all`	Yapılandırma kapsamını seç; `all` kaldırma için
`--beta`	Beta politikalarını dahil et
`--custom`, `-c <path>`	Özel bir politika dosyasını doğrula ve yükle; tekrarlanabilir

Sunum ve bakım bayrakları

Komut	Bayraklar
`backfill`	`--since <30d\|6m\|YYYY-MM-DD>`, `--dry-run`
`flush`	`--wait`, `--timeout <seconds>`
`update`	`--no-daemon`
`migrate`	`--dry-run`
`uninstall`	`--purge`, `--dry-run`, `--yes`

failproofai update, npm install -g failproofai@latest sonrasında çalıştırılmalıdır; home-layout geçişlerini gerçekleştirir, eşleşen daemon ikilisini yükler ve hizmeti yeniden başlatır. --no-daemon yalnızca layout geçişini gerçekleştirir.

Harness yolları

failproofai harness list [harness]
failproofai harness add-path <harness> [label=]<path>
failproofai harness remove-path <harness> <path-or-label>

Desteklenen harness adları claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity ve goose adlarıdır. Etiketler, iki kök aynı projenin kopyalarını içerdiğinde türetilen agent kimliklerini ad alanı oluşturur. Çakışan kökler ve yinelenen etiketler, yinelenen koleksiyon veya imleç bozulmasını önlemek için reddedilir. Ekstra yol yapılandırması, daemon yeniden başlatması olmadan yeniden yüklenir. Kapsayıcı ortamları, dosya yapılandırılmış ekstra yolları FAILPROOFAI_<HARNESS>_EXTRA_PATHS adlı virgülle ayrılmış bir değişkenle değiştirebilir, örneğin:

export FAILPROOFAI_OPENCLAW_EXTRA_PATHS="user1=/srv/openclaw-a,user2=/srv/openclaw-b"

Ortam değişkenleri

Kalıcı makine davranışı için yapılandırma dosyalarını kullan. Ortam değişkenleri kapsayıcılar, testler ve bir işlem için en yararlıdır.

Değişken	Kullanım
`FAILPROOFAI_HOME`	Tam `~/.failproofai` düzenini yeniden konumlandır
`FAILPROOFAI_LOG_LEVEL`	Yerel günlüğe kaydetme ayrıntılılığını ayarla
`FAILPROOFAI_HOOK_LOG_FILE`	Hook tanılamalarını seçilen bir dosyaya yaz
`FAILPROOFAI_TELEMETRY_DISABLED=1`	Bu işlem için anonim telemetriyi devre dışı bırak
`FAILPROOFAI_NO_FIRST_RUN=1`	Etkileşimli ilk çalıştırma kurulumunu atla
`FAILPROOFAI_NO_AUTO_AUDIT=1`	Kurulum sonrası yerel denetimi atla
`FAILPROOFAI_LLM_BASE_URL`	LLM politikaları tarafından kullanılan OpenAI uyumlu uç noktasını geçersiz kıl
`FAILPROOFAI_LLM_API_KEY`	LLM politikaları tarafından kullanılan API anahtarını sağla
`FAILPROOFAI_LLM_MODEL`	LLM politikaları tarafından kullanılan modeli seç
`FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS`	Özel politika modülü yüklemesini sınırla
`FAILPROOFAI_NO_DOWNLOAD=1`	Paketleri ve daemon ikililerini getirmeyi reddet; kurulu olan enforsu sağlamaya devam eder
`FAILPROOFAI_PACK_BASE_URL`	Paketleri `github.com` yerine bir yansıdan getir
`FAILPROOFAI_<HARNESS>_EXTRA_PATHS`	Bir harness için yapılandırılmış ekstra yakalama yollarını değiştir
`NO_COLOR`	Renkli terminal çıkışını devre dışı bırak

Agent’a özgü home değişkenleri CLAUDE_PROJECTS_PATH, CURSOR_HOME, HERMES_HOME ve OPENCLAW_HOME gibi, Failproof AI’ın bu harness için yerel oturumları nerede keşfettiğini geçersiz kılar.

Bir makineyi güvenli bir şekilde duraklatabilir veya kaldırabilir

failproofai config --pause
failproofai config --status
failproofai config --resume

Yerel oturum duraklatması, Cloud tarafından yönetilen politikaları devre dışı bırakmaz. Sorun rollout’ın kendisi olduğunda Cloud dağıtımlarını Cloud zorlama iş akışı aracılığıyla geri yükle. npm paketini kaldırmadan önce yüklenmiş hook’ları ve daemon’ı kaldırabilir:

failproofai uninstall --dry-run
failproofai uninstall --yes
npm rm -g failproofai

Sürüme özgü ayrıntılar için failproofai <command> --help komutunu çalıştırabilir.

npm rm -g failproofai öncesinde failproofai uninstall komutunu çalıştırabilir; npm yüklenmiş agent hook’larını veya daemon hizmetini kaldırmaz.

Connect your agents

Reference

Makine Kurulumu

Yapılandırma bayrakları

Politika bayrakları

Sunum ve bakım bayrakları

Harness yolları

Ortam değişkenleri

Bir makineyi güvenli bir şekilde duraklatabilir veya kaldırabilir

​Makine Kurulumu

​Yapılandırma bayrakları

​Politika bayrakları

​Sunum ve bakım bayrakları

​Harness yolları

​Ortam değişkenleri

​Bir makineyi güvenli bir şekilde duraklatabilir veya kaldırabilir

Makine Kurulumu

Yapılandırma bayrakları

Politika bayrakları

Sunum ve bakım bayrakları

Harness yolları

Ortam değişkenleri

Bir makineyi güvenli bir şekilde duraklatabilir veya kaldırabilir