Ravenclaw - Yapay zeka kodlama ajanlarının çalışma bağlamını yöneten açık kaynak sistem

Genel bakış

Yapay zeka kodlama ajanlarını (Claude Code, Gemini CLI, Codex vb.) birden fazla projede kullanırken iki sorun yaşadım.

1. Ajanı değiştirince bağlam kayboluyor

Claude Code ile çalışırken Gemini CLI'a geçince, daha önce ne yaptığımı en baştan tekrar anlatmam gerekiyor. Aynı şey, aynı ajanı kullansam bile oturum bittiğinde de oluyor. Proje bazında terminal konuşma kayıtlarını kurcalayarak "buraya kadar geldik, sıradaki bu" demeyi tekrar edip duruyorum.

2. Birden fazla projeyi paralel yürütünce kafa patlıyor

Aynı anda 3-4 proje yürüttüğünüzde, her projenin nereye kadar geldiğini takip etmek bile başlı başına bir iş oluyor. Terminal sekmeleri arasında geçiş yapıp konuşma kayıtlarını kaydırmanın bir sınırı var.

Ravenclaw'ı bu sorunu çözmek için yaptım.

Temel fikir

Ajanın çalışma bağlamını merkezi olarak yönetir.

Hangi ajanı kullanırsanız kullanın (Claude Code, Gemini CLI, Codex), çalışma bağlamı Ravenclaw'da birikir. Ajanı değiştirseniz ya da oturum kesilse bile, yeni oturumda MCP aracıyla önceki durumu aynen yükleyebilirsiniz. Belirli bir ajana bağımlı değildir.

Web UI'da proje bazında epik/sorun yapısı, grafik görünümü ve ilerleme durumu tek bakışta görülebilir; böylece "bu proje şu an nereye geldi?" sorusunu terminal kayıtlarına bakmadan hemen anlayabilirsiniz.

İnsanlar için değil, ajanlar için bir sistem

Ravenclaw'ın biletleri (sorun/epik) ve vikisi Jira ya da Linear'a benziyor olabilir, ancak ana kullanıcı farklıdır.

• Sorun oluşturma, durum değiştirme ve viki yazma işi ajanların işidir
• İnsanlar web UI'da genel durumu kontrol eder; gerektiğinde açıklama ekler veya yorumlarla yön verir
• Ajan karar gerektiren bir durumda Human Input Request gönderirse, buna web üzerinden yanıt verilir

Ajanların programatik olarak erişebilmesi için MCP protokolü üzerinden 40'tan fazla araç sunar; ayrıca tüm işlevler CLI ve REST API ile de kullanılabilir.

Başlıca özellikler

• Web sohbeti: Tarayıcıdan ajana doğrudan talimat verme, gerçek zamanlı akış yanıtları
• Konuşma sürekliliği: claude --resume kullanımı, konuşma geçmişinin veritabanında saklanması
• Proje görselleştirme: Grafik görünümünde epik/sorun yapısını ve ilerlemeyi tek bakışta görme
• Bağlam anlık görüntüsü: Ajan çalışma ilerlemesini kaydeder, sonraki oturumda kaldığı yerden devam eder
• Yetki kontrolü: Ajan çalıştırılırken auto-approve / bypass / accept-edits seçimi
• Çoklu ajan: Aynı projede Claude Code, Gemini CLI veya Codex seçerek çalışma

Teknoloji yığını

TypeScript monorepo (pnpm workspaces)

• API: Hono + PostgreSQL (Drizzle ORM)
• Web: React + Tailwind + ReactFlow
• Ajan entegrasyonu: MCP Protocol (40+ araç)
• CLI: Commander.js
• Test: Playwright E2E (14 adet)

Kurulum

git clone https://github.com/chainofdive/ravenclaw.git  
cd ravenclaw && pnpm install && pnpm build  
docker-compose up -d && pnpm db:push  

Self-hosted'dır; yalnızca PostgreSQL yeterlidir. Apache 2.0 lisanslıdır.

Bu sistemi gerçekten birden fazla yan projeyi yapay zeka ajanlarıyla birlikte paralel yönetmek için kullanıyorum. Geri bildirim ve sorulara açığım.

GitHub: https://github.com/chainofdive/ravenclaw