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

README, Notion, Slack ve eski sohbetler çelişir; agent'lar tahmin eder.

Agent'lar için sürüm yok

Cuma deploy oldu; asistan hâlâ salı dokümanını referans gösteriyor.

Güvensiz kopyala-yapıştır

Dokümanlardaki secret'lar ve geniş token'lar riski büyütür.

Init, sync, connect

1

faydabul context init

faydabul.yml içinde context projesini bağlayın; secret taramasıyla yerel dokümanları tarayın.

2

faydabul context sync

Yalnızca deltaları yükleyin, immutable sürüm yayınlayın, chunk'ları arama için indeksleyin.

3

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.

Ücretsiz hesap aç

İlk projeyi panelden deneyin

Erken erişim döneminde hesap açabilir, deploy ve AI Gateway akışını inceleyebilirsiniz.