Projeni bir kez anlat. Tüm AI agent'ların güncel halini bilsin.
Faydabul Context, repodaki Markdown'ı senkronize eder, her yayını immutable sürüm olarak saklar; Cursor, Claude, ChatGPT ve özel agent'lara arama + MCP sunar.
pnpm add -g @faydabul/cli → faydabul context init → faydabul context sync
Ekipler neden bağlam kaybeder?
Dokümanlar eskir, agent'lar eski dosyaları tekrar okur, hangi cevabın güncel olduğu belirsizleşir.
Dağınık bilgi
Agent'lar için sürüm yok
Güvensiz kopyala-yapıştır
Init, sync, connect
faydabul context init
faydabul.yml içinde context projesini bağlayın; secret taramasıyla yerel dokümanları tarayın.
faydabul context sync
Yalnızca deltaları yükleyin, immutable sürüm yayınlayın, chunk'ları arama için indeksleyin.
Agent bağla
Read token veya MCP araçlarıyla agent'ların aynı yayınlanmış sürümü kaynak göstermesini sağlayın.
Geliştiriciler için
- CI veya laptop'tan delta sync
- Diff ve rollback ile immutable sürümler
- Yol, başlık ve satır ile full-text arama
- Kapsamlı read token'lar ve varsayılan secret engeli
- Koleksiyonlar, paylaşım linkleri ve webhook'lar
- Qdrant ile hibrit vektör arama (worker embedding)
Agent'ların güvenebileceği sürümler
Her sync yeni bir sürüm oluşturur; yayınlayabilir, production'a pinleyebilir veya geçmişi silmeden geri alabilirsiniz. latest ve production alias'ları MCP istemcilerini stabil tutar.
Önce güvenlik
Token'lar sunucuda hash'lenir, anında iptal edilir ve proje kapsamındadır. MCP yanıtlarında doküman içeriği güvenilmeyen veri olarak sarılır.
Kullanım senaryoları
Onboarding
Yeni ekip üyeleri runbook ve ADR'lere dayalı agent yanıtları alır.
Destek ve denetim
Uyumluluk için bir sürümü pinleyin, salt okunur paylaşım linki verin.
CI dokümantasyonu
GitHub Actions her docs değişiminde faydabul context sync --ci çalıştırır.
Çoklu agent ürünleri
Birden fazla agent aynı indeksi kullanır; dosyayı tekrar yüklemez.
Entegrasyonlar
- MCP — search_documents, get_document, list_changes
- HTTP API — özel agent'lar için /api/context/v1
- @faydabul/cli CLI — init, sync, watch, search
- GitHub Actions — main'de docs için örnek workflow
- Qdrant — hibrit arama için vektör katmanı
Örnek arama
Agent'lar kalıcı kaynak URL'leriyle snippet alır.
$ faydabul context search "deploy geri al" → docs/runbooks/deploy.md § Geri alma (satır 42-58) → v12 · skor 0.91 · https://…/documents/…
Dokümanı bir kez gönder. Her agent güncellensin.
Hesap açın, klasörü bağlayın, dakikalar içinde ilk sync'i çalıştırın.
İlk projeyi panelden deneyin
Erken erişim döneminde hesap açabilir, deploy ve AI Gateway akışını inceleyebilirsiniz.