Ana içeriğe atla
failproofai gösterge paneli, yapay zeka agent oturumlarınızı izlemek ve politikaları yönetmek için yerel bir web uygulamasıdır. Agent’larınız sizin yokken neler yaptığını görün.

​
Gösterge panelini başlatma

failproofai
http://localhost:8020 adresinde açılır. Gösterge paneli dosya sisteminden doğrudan okur - Claude Code proje klasörleriniz ve failproofai yapılandırma dosyalarınız. Uzak bir servise hiçbir şey yazılmaz.

​
Sayfalar

​
Projeler

Makinenizde bulunan tüm Claude Code, OpenAI Codex, GitHub Copilot CLI (beta), Cursor Agent (beta), OpenCode (beta), Pi (beta) ve Gemini CLI (beta) projelerini listeler. Claude projeleri ~/.claude/projects/ konumundan (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 kaydedilen cwd ile gruplandırılarak keşfedilir; Copilot CLI projeleri her ~/.copilot/session-state/<sessionId>/workspace.yaml taranarak (COPILOT_HOME aracılığıyla yapılandırılabilir) ve cwd alanı ile 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/ geri dönüş olarak taranır) meta.json / session.json / workspace.yaml içindeki cwd skaleri için keşfedilir; OpenCode projeleri ~/.local/share/opencode/opencode.db konumundaki SQLite DB’sini opencode db --format json aracılığıyla sorgulanarak keşfedilir (session ve project tablolarını okur 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 tarayarak (PI_SESSIONS_DIR aracılığıyla yapılandırılabilir) ve her oturumun ilk kaydından cwd çekerek keşfedilir; Gemini CLI projeleri ~/.gemini/tmp/<basename>/chats/session-<timestamp>-<uuid-prefix>.jsonl tarayarak (GEMINI_SESSIONS_DIR aracılığıyla yapılandırılabilir) ve komşu .project_root metin işaretleyicisinden kanonik cwd’yi kurtararak keşfedilir. Birden fazla CLI tarafından kullanılan bir proje, tüm eşleşen rozetlerle tek bir satır olarak görüntülenir. Belirli bir agent CLI’ya göre filtrelemek için tablonun üzerindeki CLI açılır menüsünü kullanın; URL seçiminizi ?cli=claude|codex|copilot|cursor|opencode|pi|gemini olarak korur. Her proje şunları gösterir:
  • Proje adı (klasör yolundan türetilir)
  • CLI rozeti — Claude Code (turuncu), OpenAI Codex (mor), GitHub Copilot (mavi), Cursor Agent (yeşilimsi), OpenCode (kehribar), Pi (pembe) ve/veya Gemini CLI (açık mavi)
  • En son oturum aktivitesinin 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ısı sayısı
  • Hook aktivite sayısı (çalışan politikalar)
Listeyi daraltmak için tarih aralığı filtresi ve oturum ID’si aramasını kullanın. Oturumlar sayfalandırılır. Oturum görüntüleyiciyi açmak için bir oturuma tıklayın.

​
Oturum görüntüleyici

Oturum görüntüleyici, otonom agent’lar için ana soruyu yanıtlar: agent ne yaptı ve yolunda kaldı mı? Başlığın yanındaki bir CLI rozeti, oturumun Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi veya Gemini CLI transkripti olup olmadığını gösterir. Bir oturmda gerçekleşen her şeyin zaman çizelgesini gösterir:
  • Mesajlar - Claude’un metin yanıtları ve kullanıcı istemleri
  • Araç çağrıları - Claude’un çağırdığı her araç, girdisi ve çıktısı ile
  • Politika aktivitesi - Her araç çağrısı için, hangi politikaların çalıştığı ve ne karar döndürdükleri
Üstteki istatistik çubuğu oturum süresini, toplam araç çağrılarını ve hook kararlarının bir özetini (izin / reddet / talimat sayıları) gösterir. Oturumu dışa aktarmak için Günlükleri İndir düğmesine tıklayın. Claude Code, Codex, Copilot, Cursor, Pi ve Gemini oturumları için orijinal disk üzerindeki JSONL transkriptini bayt-bayt olarak alırsınız; OpenCode oturumları için (oturumlar diskte değil SQLite’de bulunur) temel session / messages / parts tablolarını yansıtan bir JSON belgesi alırsınız.

​
Denetim

Agent’ınızın geçmiş oturumlar arasında nasıl gerçekten davrandığının kişilik yönelimli bir raporu. failproofai audit CLI ile aynı taramasını çalıştırır ancak bunu altı bölümlü bir gösterge paneli olarak görüntüler:
  1. Kimlik — agent’ınızı hangi dedektörlerin + politikaların çalıştığına ve ne kadar yoğun olduğuna bağlı olarak 8 arketipten biri (iyimser, kovboy, kaşif, balık belleği, paranoid mimar, hassas inşaatçı, çekiç, hayalet) olarak sınıflandırır. 8×8 piksellik bir sigil, arketip sloganı, “yaygın olarak” / “birincil risk” çerçevesi ve kapanış tek satırını görüntüler.
  2. Agent’ınızı sergileyin — kimlik kartını X / LinkedIn’e göndermek için uygun 1200×630 PNG olarak yakalar (poster yap öğesine tıklayın).
  3. Güçlü yönler — agent’ınızın zaten doğru yaptığı yeşil işaretli davranışlar, canlı denetim verilerinden türetilir (temiz araç çağrısı oranı, ortalama oturum uzunluğu, sıfır kimlik bilgisi sızıntısı, sıfır yeniden deneme fırtınası, vb.).
  4. Puan + liderlik tablosu — 0–100 puan ile harf notu (S/A/B/C/D/F), kohort içinde nereye düştüğünüzü gösteren dağılım histogramı, düzyazı (“B 71’de başlar. 13 puan uzaktasınız.”) ve satırınız vurgulanan bir liderlik tablosu.
  5. Bulgular — etki sırasına göre sıralanmış bulgular kartları. Her kart ne olduğunu, maliyetini, gerçek yakalanmış komutlarla bir kanıt örneğini ve aynı deseni yakalayacak failproofai politikasını ($ failproofai policy add <slug>, tıklayarak kopyala) ortaya çıkarır.
  6. Önerilen politikalar + geri dönüş döngüsü — etkinleştirilmemiş her yerleşik politikanın ızgarası, öngörülen puan kaldırma ile ve “7 gün içinde yeniden denetim” eylemi.
failproofai audit çalışma zamanı tarafından yönlendirilir — temel tarama motoru, desteklenen bayraklar ve transkript başına önbellek değişmezleri için Denetim CLI bölümüne bakın. Gösterge paneli en son sonucu ~/.failproofai/audit-dashboard.json adresinde önbelleğe alır (mod 0600, tek yuva, yeni çalıştırmalar üzerine yazar) böylece yeniden ziyaretler anında olur; hem transkript başına hem de bütün sonuç önbellekleri 7 günden eski olduğunda okunması reddedilir, bu nedenle gösterge paneli asla sessizce bir haftalık sonuç sunmaz — TTL’nin geçmesinden sonra /audit boş durumuna düşer ve yeni bir çalıştırma ister. Raporun alt kısmının yakınında [ şimdi yeniden denetim ] tıklandığında, noCache: true ile /api/audit/run POST’ları — yeniden denetim transkript başına önbelleği atlar ve sessizce önbelleğe alınan sonucu döndürmek yerine her transkripti sıfırdan yeniden tarar — ve gösterge paneli çalıştırma bitene kadar 1Hz’de /api/audit/status öğesini yoklar; çalıştırma sırasında yapışkan bir pembe ilerleme şeridi görüntü bağlantı noktasının en üstüne yapışır ve geçmiş zaman sayacı ile ve başarı sırasında yeni sonuç yerinde değişir (tam sayfa yeniden yükleme yoktur; başarısız yeniden denetim önceki raporu bozulmamış bırakır). Başarısızlık durumunda şerit RerunError.kind (timeout / network / post_failed) kesilmiş kopya ile kırmızıya döner. Boş durum (önbellek yok veya süresi dolmuş) ve sıfır oturum durumu (önbellek varsa ancak tarama transkript bulamadı) ayrı ayrı ortaya çıkarılır.

​
Politikalar

Politikaları yönetmek ve aktiviteyi gözden geçirmek için iki sekmeli bir sayfa.
  • Tek bir panelden failproofai’nin hangi agent CLI’larını koruduğunu seçin — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi ve Gemini CLI’nın tümü yükleme durumu (Etkin / Tespit Edildi / Etkin Değil), kullanıcı kapsamı ayarları yolu ve marka renkli aksent içeren bir satıra sahiptir. Korumak istediğiniz CLI’ları işaretleyin veya işareti kaldırın ve farkı bir adımda yüklemek/kaldırmak için Değişiklikleri Uygula düğmesine tıklayın. İkili dosyası PATH’de tespit edilen CLI’lar önceden işaretlenmiş olur.
  • Tek bir tıklama ile bireysel politikaları açın veya kapatın (~/.failproofai/policies-config.json adresine yazar — yüklü her CLI’da paylaşılır)
  • Parametrelerini yapılandırmak için bir politikayı genişletin (policyParams destekleyen politikalar için)
  • Özel bir politika dosyası yolu ayarlayın

​
Otomatik yenileme

Gösterge panelinin üst gezintisinde bir otomatik yenileme düğmesi vardır. Etkinleştirildiğinde, mevcut sayfa yeni oturumlar ve politika aktiviteleri göründükçe periyodik olarak yenilenir. Uzun süreli otonom agent oturumlarını izlemek için gereklidir.

​
Sayfaları devre dışı bırakma

Gösterge panelinin yalnızca bazı kısımlarına ihtiyacınız varsa, FAILPROOFAI_DISABLE_PAGES öğesini virgülle ayrılmış sayfa adlarının listesine ayarlayın: 
FAILPROOFAI_DISABLE_PAGES=policies failproofai
Geçerli değerler: policies, projects, audit.

​
Projelerin yolunu yapılandırma

Varsayılan olarak, gösterge paneli standart Claude Code projeleri dizininden okur. Özel kurulumlar için geçersiz kılın: 
CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai

​
Localhost olmayan bir konaktan erişim

Gösterge panelini geliştirme modu (npm run dev) içinde çalıştırırken ve localhost dışında bir ana bilgisayar adından erişirken — örneğin, özel bir etki alanı, uzak bir IP veya tünellenmiş bir URL — şuna benzer bir uyarı görebilirsiniz: 
⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
Bu, Next.js’nin HMR (sıcak modül yeniden yükleme) web soketine çapraz köken erişimini engellediğidir ve bu bir salt geliştirme özelliğidir. Konak’ınıza izin vermek için --allowed-origins bayrağını kullanın: 
npm run dev -- --allowed-origins dashboard.example.com
Birden fazla host veya IP için virgülle ayrılmış bir liste geçirin: 
npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
Bunun yerine FAILPROOFAI_ALLOWED_DEV_ORIGINS ortam değişkenini de ayarlayabilirsiniz: 
FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
Bu yalnızca geliştirme modu için geçerlidir. failproofai çalıştırırken (üretim modu), HMR web soketi yoktur ve çapraz köken geliştirme kaynağı sorunu yoktur.