Ana içeriğe atla
failproofai dashboard, AI aracı oturumlarınızı izlemek ve politikaları yönetmek için yerel bir web uygulamasıdır. Aracılarınızın yokken ne yaptığını görün.

​
Dashboard’u başlatma

failproofai
http://localhost:8020 adresinde açılır. Dashboard doğrudan dosya sisteminden okur - Claude Code proje klasörleriniz ve failproofai yapılandırma dosyalarınız. Hiçbir şey uzak bir hizmete yazılmaz.

​
Sayfalar

​
Projeler

Makinenizde bulunan tüm Claude Code projelerini listeler. Projeler ~/.claude/projects/ konumundan (veya CLAUDE_PROJECTS_PATH tarafından ayarlanan yoldan) keşfedilir. Her proje şunları gösterir:
  • Proje adı (klasör yolundan türetilmiş)
  • Oturum sayısı
  • 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ısı sayısı
  • Hook etkinlik sayısı (harekete geçen politikalar)
Listeyi daraltmak için tarih aralığı filtresini ve oturum ID’si 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üleyici

Oturum görüntüleyici, otonom aracılar için temel soruyu yanıtlar: aracı ne yaptı ve yolunda mı kaldı? Bir oturumda gerçekleşen her şeyin bir zaman çizelgesini gösterir:
  • Mesajlar - Claude’un metin yanıtları ve kullanıcı istemleri
  • Araç çağrıları - Claude’un çağırdığı her araç, girişi ve çıkışıyla birlikte
  • Politika etkinliği - Her araç çağrısı için, hangi politikaların harekete geçtiği ve ne karar döndürdükleri
Üstteki istatistik çubuğu oturum süresini, toplam araç çağrılarını ve kanca kararlarının bir özetini (allow / deny / instruct sayıları) gösterir. İndirme düğmesini kullanarak oturumu ZIP veya JSONL dosyası olarak dışa aktarabilirsiniz.

​
Politikalar

Politikaları yönetmek ve etkinliği gözden geçirmek için iki sekmeli bir sayfa.
  • Tek bir tıklamayla bireysel politikaları açıp kapatın (~/.failproofai/policies-config.json dosyasına yazılır)
  • Parametrelerini yapılandırmak için bir politikayı genişletin (policyParams destekleyen politikalar için)
  • Belirli bir kapsam için kancaları yükleyin veya kaldırın
  • Özel bir politika dosya yolu ayarlayın

​
Otomatik yenileme

Dashboard’un üst gezintide bir otomatik yenileme geçişi vardır. Etkinleştirildiğinde, geçerli sayfa yeni oturumlar ve politika etkinlikleri görünürken periyodik olarak yenilenir. Uzun süreli otonom aracı oturumlarını izlemek için gereklidir.

​
Sayfaları devre dışı bırakma

Dashboard’un yalnızca bazı bölümlerine ihtiyacınız varsa, FAILPROOFAI_DISABLE_PAGES değerini virgülle ayrılmış sayfa adları listesine ayarlayın: 
FAILPROOFAI_DISABLE_PAGES=policies failproofai
Geçerli değerler: policies, projects.

​
Tema

Dashboard açık ve koyu modu destekler. Gezinti çubuğundaki düğmeyle geçiş yapın. Tercih, tarayıcınızın yerel depolamada saklanır.

​
Projeler yolunu yapılandırma

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

​
Localhost dışı bir konaktan erişme

Dashboard dev modunda (npm run dev) çalıştırılırken ve localhost dışında bir ana bilgisayar adından erişilirken - örneğin, özel bir alan adı, uzak bir IP veya tünel içinden geçirilen bir URL - aşağıdaki gibi 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üklemesi) websocket’ine cross-origin erişimi engellemesidir; bu dev-only bir özelliktir. Ana bilgisayarınıza izin vermek için --allowed-origins bayrağını kullanın: 
npm run dev -- --allowed-origins dashboard.example.com
Birden fazla ana bilgisayar 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 dev moduna uygulanır. failproofai (production modu) çalıştırılırken HMR websocket’i ve cross-origin dev kaynak sorunu yoktur.