Ana içeriğe atla
failproofai gösterge paneli, AI aracı oturumlarınızı izlemek ve politikaları yönetmek için yerel bir web uygulamasıdır. Aracı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 doğrudan dosya sisteminden okur - Claude Code proje klasörleriniz ve failproofai yapılandırma dosyalarınız. Hiçbir şey uzak bir servise 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/ adresinden bulunur (veya CLAUDE_PROJECTS_PATH tarafından ayarlanan yoldan); Codex projeleri ~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl altındaki her transkripti tarayarak ve her oturumun ilk kaydında kaydedilen cwd ye göre gruplandırılarak bulunur; Copilot CLI projeleri ~/.copilot/session-state/<sessionId>/workspace.yaml adresini tarayarak (COPILOT_HOME üzerinden yapılandırılabilir) ve cwd alanına göre gruplandırılarak bulunur; Cursor Agent projeleri ~/.cursor/agent-sessions/<sessionId>/ (CURSOR_HOME üzerinden yapılandırılabilir, conversations/ ve sessions/ geri plan olarak taranır) altındaki oturum başına meta verilerini tarayarak meta.json / session.json / workspace.yaml içindeki cwd skalarını bulur; OpenCode projeleri ~/.local/share/opencode/opencode.db adresindeki SQLite DB’yi opencode db --format json ile sorgulayarak bulunur (session ve project tablolarını okuyor ve project_id ye göre gruplandırıyoruz); Pi projeleri ~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl (PI_SESSIONS_DIR üzerinden yapılandırılabilir) altındaki oturum başına JSONL transkriptlerini tarayarak ve her oturumun ilk kaydından cwd yi çekerek bulunur; Gemini CLI projeleri ~/.gemini/tmp/<basename>/chats/session-<timestamp>-<uuid-prefix>.jsonl (GEMINI_SESSIONS_DIR üzerinden yapılandırılabilir) adresini tarayarak ve komşu .project_root metin işaretleyicisinden kurallı cwd’i kurtararak bulunur. Birden fazla CLI tarafından kullanılan bir proje, eşleşen tüm rozetlerle tek bir satır olarak görüntülenir. Belirli bir aracı 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 saklar. Her proje şunları gösterir:
  • Proje adı (klasör yolundan türetilmiş)
  • Bir CLI rozeti — Claude Code (turuncu), OpenAI Codex (mor), GitHub Copilot (mavi), Cursor Agent (zümrüt), OpenCode (kehribar), Pi (pembe) ve/veya Gemini CLI (gökyüzü)
  • 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 kimliği
  • Başlangıç ve bitiş zaman damgaları
  • Araç çağrısı sayısı
  • Hook etkinlik sayısı (tetiklenen politikalar)
Listeyi daraltmak için tarih aralığı filtresini ve oturum kimliği aramasını kullanın. Oturumlar sayfalandırılmıştır. Oturum görüntüleyiciyi açmak için bir oturuma tıklayın.

​
Oturum görüntüleyicisi

Oturum görüntüleyicisi, otonom aracılar için kilit soruyu yanıtlar: aracı ne yaptı ve doğru yolda mı kaldı? Başlık yanındaki bir CLI rozeti, oturumun Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi mi, yoksa Gemini CLI transkripti olduğunu gösterir. Bir oturumda olmuş her şeyin zaman çizelgesini gösterir:
  • Mesajlar - Claude’un metin yanıtları ve kullanıcı istemptleri
  • Araç çağrıları - Claude’un çağırdığı her araç, giriş ve çıkışıyla birlikte
  • Politika etkinliği - Her araç çağrısı için hangi politikaların tetiklendiğini ve ne karar döndürdüğünü
Üstteki istatistik çubuğu oturum süresini, toplam araç çağrılarını ve hook kararlarının bir özetini (izin ver / reddet / talimat say) gösterir. Oturumu dışarı aktarmak için Download Logs düğmesine tıklayın. Claude Code, Codex, Copilot, Cursor, Pi ve Gemini oturumları için orijinal disk üzerindeki JSONL transkriplini bayt-bayta alırsınız; OpenCode (oturumları SQLite’de yaşayan, disk üzerinde değil) için temel session / messages / parts tablolarını yansıtan bir JSON belgesi alırsınız.

​
Denetim

Aracınızın geçmiş oturumlar arasında gerçekte nasıl davrandığının kişiliğe dayalı bir raporu. failproofai audit CLI ile aynı taramayı çalıştırır ancak onu altı bölümlü bir gösterge paneli olarak sunar:
  1. Kimlik — aracınızı 8 prototipten birine sınıflandırır (the optimist, the cowboy, the explorer, the goldfish, the paranoid architect, the precision builder, the hammer, the ghost) hangi dedektörlerin + politikaların tetiklendiğine ve ne kadar ağır olduğuna göre. 8×8 piksel sigil, prototip sloganı, “common in” / “primary risk” çerçevelemesi ve kapanış tek satırlık açıklamayı sunar.
  2. Aracınızı gösterin — kimlik kartını X / LinkedIn’e gönderi için uygun 1200×630 PNG olarak yakalar (make poster ye tıklayın).
  3. Güçlü yönler — aracınız zaten doğru yaptığı yeşil işaretli davranışlar, canlı denetim verilerinden türetilmiş (temiz araç çağrısı oranı, ortalama oturum uzunluğu, sıfır kimlik bilgisi sızıntıları, sıfır yeniden deneme fırtınaları, vb.).
  4. Puan + lider tablosu — 0–100 puan harf notasıyla (S/A/B/C/D/F), kohort içinde nerede düştüğünüzü gösteren dağılım histogramı, metin (“a B starts at 71. you’re 13 points away.”) ve satırınız vurgulanan lider tablosu.
  5. Bulgular — etki sırasına göre sıralanmış politika başına kartlar. Her kart ne olduğunu, ne maliyeti olduğunu, gerçek yakalanan komutlar içeren kanıt örneği ve aynı deseni yakalaması gereken failproofai politikasını ($ failproof policy add <slug>, kopyala-tıkla) sunar.
  6. Önerilen politikalar + geri döngü — bir boşluğu kapatması gereken etkinleştirilenmiş her yerleşik politikanın ızgarası, projeksiyon puanı callout’u ve “7 gün içinde yeniden denetle” CTA.
failproofai audit çalışma zamanıyla yürütülür — temel tarama motoru, desteklenen işaretler ve transkript başına önbellek değişmezleri için Audit 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 gerçekleşir; [ Re-run ↻ ] ye tıklamak /api/audit/run adresine POST eder ve gösterge paneli çalıştırma bitene kadar /api/audit/status adresinde 1Hz’de yoklar. Boş durum (önbellek yok) ve sıfır oturum durumu (önbellek var ama tarama hiçbir transkript bulamadı) ayrı ayrı sunulur.

​
Politikalar

Politikaları yönetmek ve etkinliği gözden geçirmek için iki sekmeli sayfa.
  • failproofai’nin hangi aracı CLI’lardan koruması gerektiğini tek bir panelden çoklu seçim yapın — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi ve Gemini CLI’ın tümünün yükleme durumunu gösteren (Active / Detected / Inactive), kullanıcı kapsamı ayarları yolunu ve marka renkli vurgusunu içeren satırı vardır. İstediğiniz CLI’ları işaretleyin veya işareti kaldırın ve farkı tek adımda yüklemek/kaldırmak için Apply changes ye tıklayın. İkilisi PATH üzerinde tespit edilen CLI’lar önceden işaretlenmiştir.
  • Tek tıklamayla ayrı politikaları açıp kapatın (~/.failproofai/policies-config.json yazılır — her yüklü CLI arasında paylaşılır)
  • Politikanın parametrelerini yapılandırmak için bir politikayı genişletin (policyParams destekleyen politikalar için)
  • Özel politika dosyası yolu ayarlayın

​
Otomatik yenileme

Gösterge panelinin üst gezinmesinde otomatik yenileme seçeneği bulunur. Etkinleştirildiğinde, mevcut sayfa yeni oturumları ve politika etkinliklerini gösterilir olarak düzenli aralıklarla yenilenir. Uzun süreli otonom aracı oturumlarını izlemek için gereklidir.

​
Sayfaları devre dışı bırakma

Gösterge panelinin sadece bazı bölümlerine 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.

​
Proje yolunu yapılandırma

Varsayılan olarak, gösterge paneli standart Claude Code proje 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 dev modunda çalıştırırken (npm run dev) ve localhost dışında bir ana bilgisayardan (örneğin özel bir etki alanı, uzak IP veya tünelle bağlanan URL) erişirken şöyle 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 (hot module reload) WebSocket’ine yönelik çapraz kaynaklı erişimi engeleyen ve sadece geliştirme modunda kullanılan bir özelliğidir. Konağınıza izin vermek için --allowed-origins işaretini kullanın: 
npm run dev -- --allowed-origins dashboard.example.com
Birden fazla ana bilgisayar veya IP için virgülle ayrılmış bir liste iletin: 
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 dev modunda geçerlidir. failproofai (production modunda) çalıştırırken, HMR WebSocket yoktur ve çapraz kaynaklı dev kaynak sorunu yoktur.