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

​
Paneyi başlatma

failproofai
http://localhost:8020 adresinde açılır. Panel 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/ konumundan (veya CLAUDE_PROJECTS_PATH tarafından ayarlanan yoldan) bulunur; 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 her ~/.copilot/session-state/<sessionId>/workspace.yaml dosyasını (COPILOT_HOME ile yapılandırılabilir) tarayarak ve cwd alanına göre gruplandırılarak bulunur; Cursor Agent projeleri ~/.cursor/agent-sessions/<sessionId>/ (CURSOR_HOME ile yapılandırılabilir, conversations/ ve sessions/ geri dönüş olarak denetlenir) altındaki oturum başına meta verilerine meta.json / session.json / workspace.yaml içindeki cwd skaleri arayarak bulunur; OpenCode projeleri SQLite DB’sini ~/.local/share/opencode/opencode.db adresinde opencode db --format json komutuyla sorgulayarak bulunur (session ve project tablolarını okuyup project_id ye göre gruplandırırız); Pi projeleri ~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl (PI_SESSIONS_DIR ile 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 ile yapılandırılabilir) dosyalarını tarayarak ve .project_root text işaretçisinin komşusundan kanonik cwd yi kurtararak bulunur. Birden fazla CLI tarafından kullanılan bir proje, tüm eşleşen rozetleriyle birlikte tek bir satır olarak görüntülenir. Belirli bir agent CLI’ye 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|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 (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 kimliği
  • Başlangıç ve bitiş zaman damgaları
  • Araç çağrısı sayısı
  • Hook aktivite 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üleyici

Oturum görüntüleyici, otonom agent’lar için temel soruyu yanıtlar: agent ne yaptı ve yolunda mı kaldı? Başlığın yanındaki CLI rozeti, oturumun Claude Code, OpenAI Codex, GitHub Copilot CLI, Cursor Agent, OpenCode, Pi veya Gemini CLI transkripti olup olmadığını gösterir. 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ş ve çıkışı ile
  • Politika aktivitesi - Her araç çağrısı için, hangi politikaların tetiklendiği ve hangi kararı döndürdükleri
En üstteki istatistik çubuğu oturum süresini, toplam araç çağrısı sayısını ve hook kararlarının bir özetini (allow / deny / instruct sayıları) gösterir. Oturumu dışa aktarmak için Download Logs düğmesine tıklayın. Claude Code, Codex, Copilot, Cursor, Pi ve Gemini oturumları için diskteki orijinal JSONL transkriptini byte-for-byte alırsınız; OpenCode oturumları (oturumları SQLite’ta, diskte değil) için temel session / messages / parts tablolarını yansıtan bir JSON belgesi alırsınız.

​
Politikalar

Politikaları yönetmek ve aktiviteyi gözden geçirmek için iki sekmelik bir sayfa.
  • Tek bir panelden failproofai’nin koruduğu agent CLI’lerini çoklu seçin — Claude Code, OpenAI Codex, GitHub Copilot, Cursor Agent, OpenCode, Pi ve Gemini CLI’nin tümünün kurulum durumunu (Active / Detected / Inactive), kullanıcı kapsamı ayarları yolunu ve marka renkli vurgusunu gösteren bir satırı vardır. İstediğiniz CLI’leri işaretleyin veya işareti kaldırın ve bir adımda diff’i yüklemek/kaldırmak için Apply changes öğesine tıklayın. İkili dosyası PATH’te algılanan CLI’ler önceden işaretlenmiştir.
  • Bireysel politikaları tek bir tıklamayla açın veya kapatın (~/.failproofai/policies-config.json dosyasına yazılır — kurulu tüm CLI’ler arasında paylaşılır)
  • Politika parametrelerini yapılandırmak için bir politikayı genişletin (policyParams destekleyen politikalar için)
  • Özel bir politika dosyası yolu ayarlayın

​
Otomatik yenileme

Panelin üst gezintisinde bir otomatik yenileme geçişi vardır. Etkinleştirildiğinde, geçerli sayfa göründüğü için yeni oturumları ve politika aktivitesini göstermek üzere periyodik olarak yenilenir. Uzun süreli otonom agent oturumlarını izlemek için gereklidir.

​
Sayfaları devre dışı bırakma

Panelinizin yalnızca 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.

​
Proje yolunu yapılandırma

Varsayılan olarak, panel 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

Paneyi 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 alan 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’in HMR (sıcak modül yeniden yükleme) web soketine çapraz köken erişimini bloke ettiği durumdur ve bu yalnızca geliştirme özelliğidir. Konağınıza izin vermek için --allowed-origins bayrağını kullanın: 
npm run dev -- --allowed-origins dashboard.example.com
Birden çok 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 geliştirme modunda geçerlidir. failproofai’yi çalıştırırken (üretim modu), HMR web soketi ve çapraz kaynak geliştirme kaynağı sorunu yoktur.