Failproof AI CLI

npm install -g failproofai ile yerel CLI’yi yükleyin. Hiçbir argüman olmadan çalıştırarak yerel politika göstergesini açın. Paket Node.js 20.9 veya daha yeni bir sürüm 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 diğer adlardır. failproofai policy, failproofai pack ve failproofai p hepsi failproofai policies yazımlarıdır — paketler ve tek politikalar daha önce üç komut iken şimdi birdir. Eski yazımlar hala çalışır, iki istisna dışında: pack list <source> artık policies show <source> olmuştur ve pack build artık publish olmuştur.

Bir makineyi kurun

CLI’yi yükleyin, ardından makine anahtarını kabuğa okuyun. read -s, komutta asla görünmeyecek şekilde yankılanmayan bir komut isteminde alır:

npm install -g failproofai
read -rs FAILPROOFAI_CLOUD_TOKEN && export FAILPROOFAI_CLOUD_TOKEN

Daha sonra makineyi kurun ve ne uygulayacağını seçin:

failproofai config
failproofai policies add FailproofAI/policies
failproofai config --status

failproofai config kurulumun tamamıdır: failproofaid hizmetini yükler (kök bir kez, sudo -n aracılığıyla — asla etkileşimli bir parola istemi değil), bulduğu her ajan CLI’ye kancaları bağlar ve bir anahtar mevcut olduğunda Cloud’a bağlanır. Terminal olmadan — CI, bir konteyner, onu yöneten bir ajan — sormak yerine uygular ve yapması istenen herhangi bir şey olmazsa 1 ile çıkar. Hiçbir politika seçmez. Bu ikinci komutun işidir ve onsuz yeni yapılandırılan bir makine yalnızca her zaman açık olan korumayı uygular. Ortam değişkenini --token’e tercih edin: komut satırı argümanı kutudaki her kullanıcı tarafından ps aracılığıyla okunabilir. Bu değişkenin koruduğu tek şeydir — herhangi bir komuta yazılan bir anahtar, export dahil, kabuk geçmişine düşer; bu nedenle yukarıda read -s ile okunur. CI’de, bunu gizli mağazadan ayarlayın ve kabuk izlemesini (set -x) kapalı tutun veya izleme bunu yazdırır.

--connect <url> zaten kurulmuş bir makineyi kaydeder. Kayıt başarılı olur olmaz döner — daemon’ı yüklemez ve hiçbir kancayı bağlamaz. Henüz kurulmamış bir makinede düz failproofai config (veya failproofai config --token <key>) kullanın, aksi takdirde hiçbir şey toplamadığı ve uygulamadığı halde bağlı olarak okunur.

Yerel politika göstergesini açmak için failproofai’yi hiçbir argüman olmadan çalıştırın.

Komut	Sonuç
`failproofai config`	Makineyi kurun: ajanlar, daemon ve bir anahtar mevcut olduğunda Cloud
`failproofai config --token <key>`	Tek seferde kurun ve bağlanın, hiçbir şey sormayarak
`failproofai config --connect <url>`	Zaten kurulmuş bir makineyi kaydedin — daemon yok, kanca yok
`failproofai config --status`	Bağlantı, daemon, teslimat ve duraklama durumunu gösterin
`failproofai policies`	Yerleşik, özel, kural, paket ve Cloud tarafından yönetilen politikaları listeleyin
`failproofai policies --install`	Ajan CLI’lerinize kancaları bağlayın. Kendisinde hiçbir politikayı etkinleştirmez
`failproofai policies add <name>`	Bir politikayı etkinleştirin — yerleşik veya yüklenmiş paketten `<pack-id>:<name>`
`failproofai policies remove <name>`	Bir politikayı devre dışı bırakın, aynı adlandırma
`failproofai policies --uninstall`	Politikaları devre dışı bırakın veya ağı kanca çıkarın
`failproofai policies show <owner>/<repo>`	Bir paket ne taşıdığını, manifestinden okuyun, almadan önce
`failproofai policies show <owner>/<repo> --releases`	Yayımladığı her sürüm ve burada hangisi olduğu
`failproofai policies add <source>`	Bir politika paketini GitHub yayınından yükleyin; hiçbir etiket en yenisini alır ve sabitler
`failproofai publish`	Kendi politikalarınızı bir paket olarak gönderin; `--init` başlamak için bir tane yazıyor
`failproofai policies remove <publisher/name>`	Bir paketi kaldırın
`failproofai audit`	Yerel ajan geçmişini tarayın ve yerel denetim görünümünü açın
`failproofai audit --schedule [days] --email <address>`	Tekrarlayan yerel taramaları planlayın ve bulgularını e-postayla gönderin
`failproofai audit --status`	Rapor adresini, aralığı ve sonraki planlanan taramayı gösterin
`failproofai audit --no-schedule`	Denetim geçmişini silmeden tekrarlayan taramaları durdurun
`failproofai harness list`	Ekstra yakalama yollarını listeleyin
`failproofai flush --wait`	Geçerli olay spool’unu teslim edin
`failproofai backfill --since 30d`	Daha önce geçen geçmişi yeniden okuyun
`failproofai config --pause [duration]`	Bir yerel oturumu varsayılan olarak 30 dakika, en fazla 8 saat duraklatın
`failproofai config --resume`	Duraklatılmış bir yerel oturumu sürdürün; tüm duraklamaları temizlemek için `--all` ekleyin
`failproofai update`	Paket göçlerini tamamlayın ve daemon’ı güncelleyin
`failproofai migrate --dry-run`	Bekleyen ana düzen göçlerini önizleyin veya çalıştırın
`failproofai uninstall`	Paketi kaldırmadan önce kancaları ve daemon’ı kaldırın
`failproofai --version`	Yüklenmiş paket sürümünü yazdırın
`failproofai --help`	Komutları ve genel kullanımı gösterin

Yapılandırma bayrakları

Bayrak	Kullanım
`--token <key>`	Etkileşimli olmayan şekilde kurun ve bağlanın; ayrıca `FAILPROOFAI_CLOUD_TOKEN` adresinden okuyun
`--url <url>`	`app.befailproof.ai` dışında bir yere bağlanın; ayrıca `FAILPROOFAI_CLOUD_URL` adresinden okuyun
`--connect <url>`	Zaten kurulmuş bir makinede yalnızca kaydedin. Daemon ve her kancayı atlar
`--machine-id <id>`	Sabit makine kimliğini ayarlayın
`--machine-label <name>`	Zaten bağlı olan bir makineyı yeniden adlandırın. Kendi başına asla kurulum çalıştırmaz, bu nedenle `failproofai config` sonrasında verin, kurulum sırasında değil
`--no-transcripts`	Transkript içeriği olmadan kararları gönderin
`--disconnect`	Cloud politikası çekişlerini ve olay teslimatını durdurun
`--status`	Geçerli makine durumunu gösterin
`--pause [duration]`	Geçerli dizindeki en yeni oturumu duraklatın; saniye, dakika veya saat kabul eder ve varsayılan olarak 30 dakikadır
`--resume`	Eşleşen bir duraklamayı erken bitirine
`--session <id>`	Duraklatma veya sürdürme için açık oturum belirleyin
`--all`	`--resume` ile, her etkin duraklamayı bitirine

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

Politika bayrakları

Bayrak	Kullanım
`--install`, `-i`	Ağ kancalarını yükleyin. Bundan sonraki adlar bu politikaları etkinleştirir; yok ise, hiçbir politika değişikliği
`--uninstall`, `-u`	Politikaları devre dışı bırakın veya kancaları kaldırın
`--cli <names...>`	Desteklenen bir veya daha fazla ağlarını hedefleyin
`--scope user\|project\|local\|all`	Yapılandırma kapsamını seçin; `all` kaldırmak içindir
`--beta`	Beta politikalarını dahil edin
`--custom`, `-c <path>`	Özel bir politika dosyasını doğrulayın ve yükleyin; tekrarlanabilir

Teslimat 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; ana düzen göçlerini gerçekleştirir, eşleşen daemon ikilisini yükler ve hizmeti yeniden başlatır. --no-daemon yalnızca düzen göçünü gerçekleştirir.

Ağ yolları

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

Desteklenen ağ adları claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity ve goose olur. Etiketler, iki kök aynı projenin kopyalarını içerdiğinde türetilen ajan kimliklerinin ad alanlarını verir. Ç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şlaması olmadan yeniden yüklenir. Konteyner ortamları, dosyada 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ın. Ortam değişkenleri konteynerler, testler ve bir süreç için en kullanışlıdır.

Değişken	Kullanım
`FAILPROOFAI_CLOUD_TOKEN`	Cloud anahtarı, `--token` yerine. Bunu tercih edin: bir argüman, kutudaki her kullanıcı tarafından `ps` aracılığıyla okunabilir. Bunu `read -s` ile veya CI gizli mağazasından ayarlayın, asla anahtarı bir komuta yazarak, hangi durumda da kabuk geçmişine düşer
`FAILPROOFAI_CLOUD_URL`	Cloud URL’si, `--url` yerine. Daemon’ın okuduğu aynı değişken
`FAILPROOFAI_HOME`	Tüm `~/.failproofai` düzenini taşıyın
`FAILPROOFAI_LOG_LEVEL`	Yerel günlük ayrıntısını ayarlayın
`FAILPROOFAI_HOOK_LOG_FILE`	Kanca tanılamalarını seçili bir dosyaya yazın
`FAILPROOFAI_TELEMETRY_DISABLED=1`	Bu işlem için anonim telemetriyi devre dışı bırakın
`FAILPROOFAI_NO_FIRST_RUN=1`	Etkileşimli ilk çalıştırma kurulumunu atlayın
`FAILPROOFAI_NO_AUTO_AUDIT=1`	Kurulum sonrası yerel denetimi atlayın
`FAILPROOFAI_LLM_BASE_URL`	LLM politikaları tarafından kullanılan OpenAI uyumlu uç noktayı geçersiz kılın
`FAILPROOFAI_LLM_API_KEY`	LLM politikaları tarafından kullanılan API anahtarını sağlayın
`FAILPROOFAI_LLM_MODEL`	LLM politikaları tarafından kullanılan modeli seçin
`FAILPROOFAI_POLICY_LOAD_TIMEOUT_MS`	Özel politika modülü yüklenmesini sınırlandırın
`FAILPROOFAI_NO_DOWNLOAD=1`	Paketleri ve daemon ikililerini getirmeyi reddedin; yüklü olanlar uygulamaya devam eder
`FAILPROOFAI_PACK_BASE_URL`	`github.com` yerine bir yansıdan paketleri getirin
`FAILPROOFAI_<HARNESS>_EXTRA_PATHS`	Bir ağ için yapılandırılmış ekstra yakalama yollarını değiştirin
`NO_COLOR`	Renkli terminal çıktısını devre dışı bırakın

CLAUDE_PROJECTS_PATH, CURSOR_HOME, HERMES_HOME ve OPENCLAW_HOME gibi ajana özel ana değişkenler, Failproof AI’nin bu ağ için yerel oturumları nerede keşfettiğini geçersiz kılar.

Bir makineyi güvenli bir şekilde duraklatın veya kaldırın

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

Yerel oturum duraklaması Cloud tarafından yönetilen politikaları devre dışı bırakmaz. Cloud dağıtımlarını Cloud uygulama iş akışı aracılığıyla geri yükleyin; sorun rollout’ün kendisiyse. npm paketini kaldırmadan önce, yüklenmiş kancaları ve daemon’ı kaldırın:

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

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

npm rm -g failproofai öncesinde failproofai uninstall çalıştırın; npm yüklenmiş ajan kancalarını veya daemon hizmetini kaldırmaz.

Connect your agents

Reference

Bir makineyi kurun

Yapılandırma bayrakları

Politika bayrakları

Teslimat ve bakım bayrakları

Ağ yolları

Ortam değişkenleri

Bir makineyi güvenli bir şekilde duraklatın veya kaldırın

​Bir makineyi kurun

​Yapılandırma bayrakları

​Politika bayrakları

​Teslimat ve bakım bayrakları

​Ağ yolları

​Ortam değişkenleri

​Bir makineyi güvenli bir şekilde duraklatın veya kaldırın

Bir makineyi kurun

Yapılandırma bayrakları

Politika bayrakları

Teslimat ve bakım bayrakları

Ağ yolları

Ortam değişkenleri

Bir makineyi güvenli bir şekilde duraklatın veya kaldırın