Skip to main content
failproofai kontrol paneli, AI ajan oturumlarınızı izlemek ve politikaları yönetmek için yerel bir web uygulamasıdır. Ajanlarınız sizin yokken neler yaptığını görün.

​
Kontrol panelini başlatma

http://localhost:8020 adresinde açılır. Kontrol paneli, yerel proje, oturum ve failproofai yapılandırma verilerini doğrudan dosya sisteminden okur. Denetim hatırlatmaları ve davetiyeler gibi isteğe bağlı kimlik doğrulamalı özellikler, bu istekler için gerekli bilgileri (e-posta adresleri dahil) uzak API’lere gönderir.

​
Sayfalar

​
Projeler

Makinenizde bulunan tüm Claude Code, OpenAI Codex, GitHub Copilot CLI (beta), Cursor Agent (beta), OpenCode (beta), Pi (beta), Hermes, OpenClaw, Factory Droid, Devin, Antigravity ve Goose projelerini listeler. Claude projeleri ~/.claude/projects/ dizininden (veya CLAUDE_PROJECTS_PATH tarafından ayarlanan yoldan) keşfedilir; Codex projeleri ~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl altındaki her transkripti tarayarak ve her oturumun ilk kaydında kayıtlı cwd ile gruplandırılarak keşfedilir; Copilot CLI projeleri her ~/.copilot/session-state/<sessionId>/workspace.yaml dosyasını (COPILOT_HOME aracılığıyla yapılandırılabilir) tarayarak ve cwd alanına göre gruplandırılarak keşfedilir; Cursor Agent projeleri ~/.cursor/agent-sessions/<sessionId>/ altındaki oturum başına meta verileri tarayarak (CURSOR_HOME aracılığıyla yapılandırılabilir, conversations/ ve sessions/ yedek olarak kullanılır) meta.json / session.json / workspace.yaml içinde cwd skaler değeri arayarak keşfedilir; OpenCode projeleri ~/.local/share/opencode/opencode.db adresindeki SQLite DB’sini opencode db --format json aracılığıyla sorgulayarak keşfedilir (session ve project tablolarını okuyuz ve project_id ile gruplandırırız); Pi projeleri ~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl altındaki oturum başına JSONL transkriptlerini (PI_SESSIONS_DIR aracılığıyla yapılandırılabilir) tarayarak ve her oturumun ilk kaydından cwd çekerek keşfedilir; Hermes ağ geçidi oturumları ~/.hermes/state.db adresindeki SQLite deposundan doğrudan okunur (HERMES_DB_PATH aracılığıyla yapılandırılabilir) ve source tarafından (Slack/Telegram/cli/cron) hermes-<source> projelerine gruplandırılır — ağ geçidi oturumlarının cwd’si yoktur; OpenClaw ağ geçidi oturumları ~/.openclaw/agents/<agentId>/sessions/*.jsonl dizininden okunur ve openclaw-<agentId> projelerine gruplandırılır (aynı şekilde cwd’siz); Factory Droid projeleri ~/.factory/sessions/<encoded-cwd>/*.jsonl adresindeki JSONL transkriptlerinden keşfedilir ve cwd ile gruplandırılır; Devin projeleri ~/.local/share/devin/cli/sessions.db adresindeki SQLite DB’sinden (her oturumun working_directory ile gruplandırılır); Antigravity projeleri ~/.gemini/antigravity-cli/brain/<conversationId>/…/transcript_full.jsonl adresindeki JSONL transkriptlerinden ve cwd ile gruplandırılarak keşfedilir; ve Goose projeleri ~/.local/share/goose/sessions/sessions.db adresindeki SQLite DB’sinden (her oturumun working_dir ile gruplandırılır). Birden çok CLI tarafından kullanılan bir proje, tüm eşleşen rozet ile tek bir satır olarak gösterilir. Belirli bir ajan CLI’sine göre filtrelemek için tablonun üstündeki CLI açılır menüsünü kullanın; URL seçiminizi ?cli=claude|codex|copilot|cursor|opencode|pi|hermes|openclaw|factory|devin|antigravity|goose olarak korur. Her proje şunları gösterir:
  • Proje adı (klasör yolundan türetilmiş)
  • CLI rozeti — Claude Code (turuncu), OpenAI Codex (mor), GitHub Copilot (mavi), Cursor Agent (yeşilimtırak), OpenCode (kehribar), Pi (pembe) ve/veya Hermes (çivit mavisi)
  • En son oturum etkinliğinin tarihi
Oturumlarını görmek için bir projeye tıklayın.

​
Oturumlar

Bir proje içindeki tüm oturumları listeler. Her oturum şunları gösterir:
  • Oturum ID’si
  • Başlangıç ve bitiş zaman damgaları
  • Araç çağrılarının sayısı
  • Hook etkinlik sayısı (politikaların ateşlenmesi)
Listeyi daraltmak için tarih aralığı filtresini ve oturum ID’si aramasını kullanın. Oturumlar sayfa bölümlüdür. Oturum görüntüleyicisini açmak için bir oturuma tıklayın.

​
Oturum görüntüleyicisi

Oturum görüntüleyicisi, otonom ajanlar için temel soruyu yanıtlar: ajan ne yaptı ve yolda kaldı mı? Başlığın yanındaki CLI rozeti, oturumun Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi, Hermes, OpenClaw, Factory Droid, Devin, Antigravity veya Goose transkripti olup olmadığını gösterir. Bir oturumda meydana gelen her şeyin zaman çizelgesini gösterir:
  • İletiler - Claude’un metin yanıtları ve kullanıcı istekleri
  • Araç çağrıları - Claude’un çağırdığı her araç, giriş ve çıkışı ile birlikte
  • Politika etkinliği - Her araç çağrısı için hangi politikaların ateşlendiği ve hangi kararı döndürdüğü
Üstteki istatistik çubuğu oturum süresini, toplam araç çağrılarını ve hook kararlarının bir özetini (allow / deny / instruct sayıları) gösterir. Oturumu dışa aktarmak için İndirme Günlükleri düğmesine tıklayın. Claude Code, Codex, Copilot, Cursor ve Pi oturumları için orijinal disk üzerindeki JSONL transkriptini byte-for-byte alırsınız; OpenCode oturumları (oturumları SQLite’de, diskte değil) için session / messages / parts tablolarını yansıtan bir JSON belgesi alırsınız.

​
Denetim

Ajanınızın geçmiş oturumlar genelinde gerçekten nasıl davrandığı hakkında kişilik odaklı bir rapor. failproofai audit CLI ile aynı taramasını çalıştırır ancak bunu tek ekranlı paylaşılabilir bir poster + dört alt bölüm olarak gösterir:
  1. Poster — ilk görüntüleme alanını doldurur. failproof_ai uyumlu yazı tipi + denetim etiketi içeren kendi kendine yeterli PNG-yakalama bölgesi · arketipi indeksi (№ NN / 08) + denetim tarihi · sayısal puan (0–100) + yüzdelik sıralama rozeti (en iyi %15) · arketipi adı (iyimser, kovboy, kaşif, balık hafızası, paranoid mimar, hassas yapı ustası, çekiç veya hayalet içinden biri) + 3 anahtar kelime şeridi · // yalnızca ajanların %N'i bu arketiptedir nadir kullanım satırı · 8×8 piksel sigil kutucuğu · denetin → failproof.ai altbilgisi. Üç paylaş düğmesi yakalama kutusunun hemen dışında yer alır: arketipi paylaş (X niyeti), LinkedIn'de paylaş, posteryı indir. Yakalama html-to-image aracılığıyla çalışır, bu nedenle PNG ekranda görünen görüntüyle piksele kadar eşleşir (kesikli kenarlıklar, SVG logo maskesi, degradeler, yazı tipi ölçütleri — tümü korunur).
  2. Güçlü Yönler — sakin ✓ satır listesi ajanınızın zaten iyi yaptığı davranışlar, canlı denetim verilerinden türetilmiş (temiz araç çağrısı oranı, ana dalına doğrudan itme yok, sıfır kimlik bilgisi sızıntısı, sıfır yeniden deneme fırtınaları) — her biri yalnızca ilgili politikanın denetim penceresi boyunca temiz bir kaydı olduğunda gösterilir.
  3. Tuhaflıklar — sızdığı şeylerin tablosu, önem derecesine göre sıralanmış: ne zaman · ne sızdığı + onu yakalayacak politika · önem rozeti · görüldü, burada yineleme yeni (bir kez), N× görüldü (2–9 kez) veya yinelenen (10+) olarak okunur.
  4. İyileştirme Şekli — sakin satır listesi, önerilen her politika için bir tane: beyaz renkli politika adı, tek satırlık açıklama, kurulum komutu + sağ tarafta kopyala düğmesi. Bölüm başlığı tümünü etkinleştir N → öngörülen <puan> · <seviye> (her düzeltme uygulanmış durumdaki ulaşacağınız puan) ve [tümünü yükle] düğmesi her önerilen politika için birleştirilmiş failproofai policy add a b c … komutunu kopyalar.
  5. Daha iyi geri dönün — yan yana iki kart. Sol: hatırlatıcı ayarlayın (3d / 7d / 14d / 30d kadans seçici; kimlik doğrulaması yapıldıktan sonra /api/auth/reminder aracılığıyla kalıcı). Sağ: failproof avantajlarının kilidini açın — bir arkadaşı davet et virgülle/boşlukla/yeni satırla ayrılmış bir arkadaş e-postaları listesini alan bir modal açar (gönderim başına en fazla 10), bunları /api/audit/invite adresine GÖNDERIR, bu da api-sunucusunun POST /v0/invite adresine iletilir. API sunucusu invite@failproof.ai adresinden her alıcı için bir e-posta gönderir ve gönderen CC olarak ayarlanır ve Reply-To belirlenir, bu sayede alıcı kimi davet ettiğini görür ve gönderen gelen kutusunda bir kopya alır. Anonim kullanıcılar davetiyeler gönderilmeden önce gönderenin e-postası bilinmesi için AuthDialog aracılığıyla yönlendirilir. Hak / avantaj yerine getirme sonraki bir adımdır.
failproofai audit çalışması tarafından yönlendirilir — temel tarama motoru, desteklenen bayraklar ve transkript başına önbellek değişmezleri için Denetim CLI sayfasına bakın. Kontrol paneli en son sonucu ~/.failproofai/audit-dashboard.json adresinde önbelleğe alır (0600 modu, tek yuva, yeni çalıştırmalar üzerini yazar), böylece yeniden ziyaretler anlıktır; hem transkript başına hem de bütün sonuç önbellekleri 7 günden eski olduklarında okunma sırasında reddedilir, bu nedenle kontrol paneli hiçbir zaman sessizce bir haftaeski bir sonuç sunmaz — TTL geçtikten sonra /audit boş durumuna devam eder ve taze bir çalıştırma ister. Raporun alt tarafında [ şimdi yeniden denetim ] düğmesine tıklamak /api/audit/run adresine noCache: true ile POST gönderir — yeniden denetim transkript başına önbelleği atlar ve her transkripti sıfırdan yeniden tarar — ve kontrol paneli çalıştırma bitene kadar 1Hz’de /api/audit/status adresini yoklar; çalıştırma sırasında görüntüleme alanının en üstüne yapışan pembe bir ilerleme şeridi sabitlenir ve geçen bir zamanlayıcı ile birlikte, yeni sonuç başarı durumunda yerde değişir (tam sayfa yeniden yükleme yok; başarısız yeniden denetim önceki raporu bozulmamış bırakır). Başarısızlıkta şerit RerunError.kind (timeout / network / post_failed) kopyası olan kırmızıya döner. Boş durum (önbellek yok veya süresi dolmuş) ve sıfır oturum durumu (önbellek var ancak tarama transkript bulamadı) ayrı ayrı yüzeyde gösterilir.

​
Politikalar

Politikaları yönetmek ve etkinliği gözden geçirmek için iki sekmeli sayfa.
  • Tek bir panelden failproofai’nin koruduğu ajan CLI’lerini çoklu seçme — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi ve Hermes’in tümü kurulum durumuna (Active / Detected / Inactive), kullanıcı kapsamı ayarları yoluna ve marka rengli aksan içeren bir satır bulunur. İstediğiniz CLI’leri işaretleyip Değişiklikleri Uygula düğmesine tıklayarak farkı bir adımda yükleyin/kaldırın. PATH’ta ikili dosyası algılanan CLI’ler önceden işaretlenmiş olur.
  • Tekil politikaları tek tıkla açıp kapatın (~/.failproofai/policies-config.json yazılır — yüklü her CLI arasında paylaşılır)
  • Bir politikayı genişleterek parametrelerini yapılandırın (policyParams desteği olan politikalar için)
  • Özel bir politikalar dosyası yolu ayarlayın

​
Otomatik Yenileme

Kontrol paneli üst gezinmede bir otomatik yenileme değiştiricisine sahiptir. Etkinleştirildiğinde, geçerli sayfa yeni oturumlar ve politika etkinlikleri göründüğünde göstermek için periyodik olarak yenilenir. Uzun süre çalışan otonom ajan oturumlarını izlemek için gereklidir.

​
Sayfaları devre dışı bırakma

Kontrol panelinin yalnızca bazı kısımlarına ihtiyacınız varsa, FAILPROOFAI_DISABLE_PAGES ortam değişkenini virgülle ayrılmış sayfa adlarının bir listesi olarak ayarlayın:
Geçerli değerler: policies, projects, audit.

​
Projeler yolunu yapılandırma

Varsayılan olarak, kontrol paneli standart Claude Code projeleri dizininden okur. Özel kurulumlar için bunu geçersiz kılın:

​
Localhost olmayan bir konaktan erişim

Kontrol panelini geliştirme modunda (npm run dev) çalıştırırken ve localhost dışında bir ana bilgisayar adından — örneğin özel bir etki alanı, uzak bir IP veya tünel yapılmış bir URL — erişirken şunun gibi bir uyarı görebilirsiniz:
Bu, Next.js’nin HMR (sıcak modül yeniden yükleme) web soketi’ne çapraz kaynaklı erişimi engellemesidir, bu bir yalnızca geliştirme özelliğidir. Konağınıza izin vermek için --allowed-origins bayrağını kullanın:
Birden çok konak veya IP için virgülle ayrılmış bir liste geçin:
Bunun yerine FAILPROOFAI_ALLOWED_DEV_ORIGINS ortam değişkenini de ayarlayabilirsiniz:
Bu yalnızca geliştirme modunda geçerlidir. failproofai (üretim modu) çalıştırırken, HMR web soketi yoktur ve çapraz kaynaklı geliştirme kaynağı sorunu yoktur.