Claude Code, Codex veya Google Antigravity ile kullanabileceğin yerel ikinci beyin. Notların Markdown dosyalarında kalır; bir istemcide kaydettiğin kaynak ve iş sonucu diğerinde de bulunabilir. Obsidian ile açabilir, normal bir metin editörüyle düzenleyebilirsin.
Python 3.11 veya üzeri yeterli. Git, pip, Mem0 hesabı, API anahtarı veya sürekli açık sunucu gerekmez. Kullandığın AI istemcisinin kendi kurulumu ve hesabı ayrı olarak gerekir.
V3.5.1: Güncelleyici depo adı değişikliğine hazırlandı; herkesin 3.5.1'e geçmesi önerilir (notlar). V3.5.0 ile aynı vault'ta paralel oturumlar ve birden çok makine destekleniyor (oturum başına devir kartı, çoklu makine rehberi),
recapson işleri kaynaklarıyla listeliyor, istemediğin skill ve adaptörleri kapatabiliyorsun ve Windows MSIX ortamında state yolu doğru sabitleniyor. Mevcut kurulumda vault içindepython3 beyin.py updateçalıştır; V3.1.0 ve sonrasında yeni sürümleri oturum başında görürsün. Sürüm notları · Güncelleme rehberi.
- Obsidian'da yeni bir vault oluştur veya mevcut vault klasörünü seç.
- Bu klasörü Codex, Claude Code veya Antigravity ile aç.
- Aşağıdaki mesajı yapıştır:
https://avenox.lol/beyin.md adresini oku. Bu klasöre ikinci beynimi kur. Mevcut kurulum varsa notlarımı koruyarak güncelle. Gerekli indirme ve kurulum adımlarını sen yap. Sonunda örnek bir bilgiyi kaydedip yeni oturumda geri okuyarak birlikte doğrulayalım.
Ajan resmi kararlı paketi bulur, checksum ile doğrular, geçici alanda açar, kurulumu yapar ve sağlık kontrolünü çalıştırır. Kullanıcı yalnızca istemcinin gösterdiği normal klasör, workspace veya hook güven incelemesini tamamlar.
Görsel anlatım, kopyalanabilir mesaj ve manuel indirme: avenox.lol/ikincibeyin.
- Son kararlı sürüm sayfasını aç.
beyin-v3-X.Y.Z.zipdosyasını ve yanındaki SHA-256 dosyasını indir (X.Y.Zsayfadaki sürüm numarasıdır). GitHub'ın otomatik “Source code” arşivi yerine bu paketi seç. - Obsidian'da bir vault oluştur veya mevcut vault klasörünü seç. Notlarını başka yere taşıman gerekmez.
- Açtığın paket klasöründe terminal aç ve vault yolunu kendi klasörünle değiştir:
macOS / Linux:
python3 scripts/install_v3.py --vault "/tam/yol/Beynim"Windows:
py -3 scripts/install_v3.py --vault "C:\Notlar\Beynim"Kurulum üç istemci için proje bağlantılarını, ortak motoru, üç başlangıç skill'ini ve güncelleme kısayolunu kurar. Bundan sonra paket klasörünü açık tutman gerekmez.
Hermes Agent kullanıyorsan aynı motor bir Hermes eklentisi üzerinden bağlanır; installer eklenti dosyalarını vault içine yazar, ama profil bazlı bağlantı ve hermes plugins enable beyin-v3 adımını sen yaparsın. Adımlar: docs/v3/HERMES.md. Bu destek V3.1.0 ve sonraki paketlere dahildir.
Vault klasörünü kullandığın AI istemcisinde açıp yeni bir oturum başlat. Codex'te /hooks ekranında yeni hook tanımlarını inceleyip güven; diğer istemcilerde workspace güvenini tamamla. İstemci güvenini kurucu senin adına uydurmaz. Agent ile kurulum yapmak istersen SETUP-V3.md rehberini takip etmesini iste.
OpenCode için ek adım yok: installer vault içine eklentisini yazar, OpenCode vault klasöründe açılınca aynı motora bağlanır. Aynı eklenti OpenCode 1.x (1.3.4 ve sonrası) ve 2.x ile çalışır. OpenCode 2.x eklentileri istemci kapansa da çalışan arka plan servisinde yükler; bu yüzden orada SessionEnd yalnız oturum silinince veya servis durunca gelir, tur sonu senkronizasyonu Stop ile her turda sürer. Adımlar: docs/v3/OPENCODE.md.
OMP (Oh My Pi) için ek adım yok: installer vault içine .omp/hooks/pre/beyin-v3.ts yazar, OMP vault klasöründe açılınca aynı motora bağlanır. Dosyayı global agentDir'e kopyalama; vault dışında işe yaramaz. Adımlar: docs/v3/OMP.md.
V3.1.0 kişilik/süreklilik davranışı: yeni kurulum düşünme ortağı kimliğini ve başlangıç notlarını oluşturur; mevcut Core/Soul, kullanıcı düzeltmeleri, aktif konular ve son oturum kaynakları açılışta önceliklidir. Kalıcı öğrenimler aktif ajan tarafından kavram ve bağlantı notlarına işlenir. V2/V3 karşılaştırması ve doğrulama. Bu davranış V3.1.0 ve sonraki paketlere dahildir.
Ajanına şunu söyle:
Beyin skill'ini kullan. Beni tanımak için kısa sorular sor; cevapları kaynak notlara kaydet. Sonra birlikte bir görev oluşturup tekrar okuyalım.
Kurulu üç skill:
| Skill | Ne zaman kullanılır? |
|---|---|
| beyin | Not bulmak, bilgi kaydetmek, görev değiştirmek, iş sonucu ve ders çıkarmak |
| beyin-doktor | Bir not bulunamıyorsa, bağlantı veya kayıt sorunu varsa |
| beyin-guncelle | Kurulu sistemi kontrol etmek, güncellemek veya geri almak |
Bunlar .agents/skills altında bulunur; istemciler aynı kaynakları kullanır. Eklemek istediğin kişisel skill'leri ayrıca içe alabilirsin. Aynı adlı farklı içerik sessizce ezilmez.
Notu yaz, ajana ne istediğini söyle. Kaynaklar oturum açılışı ve konuşmanın uygun noktalarında yeniden indekslenir. İstemciler kapalıyken sürekli tarayan bir servis yoktur. Önemli iş sonuçları kısa, kaynak bağlantılı kayıtlarla tutulur; tüm sohbetin kendiliğinden doğru bilgiye dönüştüğü iddia edilmez.
Beyin sohbet metnini saklamaz. Claude Code yerel sohbet kayıtlarını (~/.claude/projects/) varsayılan olarak 30 gün sonra siler; kalıcı olmasını istediğin karar ve bilgiyi nota yazdır. Süreyi uzatmak için ~/.claude/settings.json içine örneğin "cleanupPeriodDays": 365 ekle (Claude Code belgesi).
Son günlerde ne yapıldığını görmek için vault klasöründe python3 beyin.py recap --days 7
çalıştır. Son yedi UTC gününün kaynak bağlantılı iş sonuçlarını en yeniden eskiye listeler;
model çağırmaz. Bunlar ajanın yazdığı sonuç iddialarıdır, bağımsız doğrulanmış olgular
değildir. Özel notlara giden bağlantılar gizlenir, silinmiş kaynaklar listelenmez.
--days (1-366) ve --limit (1-100) ile aralığı ve uzunluğu değiştirebilirsin.
Bir şey ters giderse ajana “beyin-doktor ile kontrol et” de. Terminalden, vault klasöründe:
python3 beyin.py doctorWindows'ta aynı komutun başında py -3 kullan. Kurulumda özel runtime yolu seçtiysen kurulu beyin.py bunu zaten bilir.
Ajanına “ekonomik moda geç”, “otomatik kontrolleri kapat” veya “kontrol aralığını 30 dakika yap” diyebilirsin. Üç istemci aynı vault tercihini kullanır; güncellemeler tercihini korur.
| Mod | Yerel kontrol | Oturuma eklenen bağlam |
|---|---|---|
| Normal (varsayılan) | Her ilgili istemci olayında | Oturum başı ve mesajlarda, en çok 5000 karakter |
| Ekonomik | Yeni oturumda; sonrasında en az 15 dakika aralıklı | Yalnız oturum başında, en çok 2000 karakter |
| Manuel | Otomatik kapalı | Otomatik kapalı |
Süre dolunca kendi başına çalışan bir zamanlayıcı kurulmaz; bir sonraki istemci olayı kontrolü başlatır. İstemciler kapalıyken işlem yapılmaz. Yerel Python kontrolleri model çağırmaz; otomatik Luna/Sonnet maliyeti yoktur. Ajana yaptırdığın işler ve eklenen bağlam normal istemci tüketimine girer. Ekonomik veya manuel modda gerektiğinde kaynaklar açık context/sync komutuyla tazelenir.
İsteğe bağlı Jev danışmanı bundan ayrıdır: varsayılan kapalıdır, yalnız kendi TypeSafe API anahtarı olanlar içindir ve kurucu onu ne sorar ne kurar. Durumu python3 beyin.py jev status gösterir; jev shadow, jev on ve jev off ile değiştirilir. Anahtar istemeyen yerel seçenek olarak ayrı kurulan açık ağırlıklı Laya sunucusu da seçilebilir (jev shadow --provider laya); Beyin'e PyTorch veya model girmez. Laya yalnız gölge modda çalışır: ölçümde Jev'den çok daha zayıf çıktığı için puanları ölçüm ve gizlilik denemeleri için kaydedilir, gördüğün sonucu değiştirmez. Ayrıntılar ve sınırlar.
Tercihler: python3 beyin.py preferences. Ekonomik: preferences --profile economical. Manuel: preferences --profile manual. Aralık: preferences --interval-minutes 30. Opt-in sır süzgeci: preferences --secret-filter on. Windows'ta py -3 kullan. Ayrıntılar.
Last-Session.md son oturumların devir kartlarıdır (oturum başına ## YYYY-MM-DD HH:MM · <etiket> · <session_id[:8]> başlığıyla açılır, oturum yalnız kendi kartını düzenler), Threads.md açık konuların güncel durumudur. İkisi de yerinde güncellenir, alta eklenmez. Varsayılan sınır 3.000 ve 8.000 karakterdir. Sınır aşılırsa oturum başı bağlamı tek satırlık Memory hygiene: uyarısıyla açılır ve doctor aynı bilgiyi gösterir. Ajan o zaman python3 beyin.py companion-compact çalıştırır: eski bölümler ve eski tarihli kayıtlar kelimesi kelimesine companion klasöründeki Arşiv/ altına, özel işaretli aylık bir dosyaya taşınır. Hiçbir metin silinmez veya özetlenmez, model çağrılmaz, zamanlayıcı kurulmaz. Planı önce görmek için --dry-run, sınırları değiştirmek için preferences --last-session-chars 4000 --threads-chars 12000 (0 kapatır). Ayrıntılar.
Ajanına “beynimi güncelle” diyebilir veya vault içindeki kısayolu açabilirsin:
- macOS:
Beyni Güncelle.command - Windows:
Beyni Guncelle.cmd - Linux:
Beyni Güncelle.desktopveyaBeyni Güncelle.sh
Kısayol aynı updater'ı çalıştırır. Terminalde önce kontrol etmek istersen:
python3 beyin.py update --check
python3 beyin.py updateYeni sürüm kontrolü varsayılan olarak açıktır: oturum başında ayrı bir süreç günde en fazla bir kez GitHub sürüm bilgisini kontrol eder. Not, prompt veya hesap bilgisi göndermez; model çağırmaz. İlk sonuç sonraki oturumda veya doctor çıktısında görünür. Aynı sürüm için bildirim bir kez gösterilir. Otomatik kurulum yapılmaz.
- Hafif kontrol:
python3 beyin.py update --check --metadata-only - Bildirimi kapat:
python3 beyin.py preferences --update-notifications off - Aç:
python3 beyin.py preferences --update-notifications on - Bir sürümü sustur:
python3 beyin.py update --dismiss X.Y.Z
Windows'ta python3 yerine py -3 kullan. V3.0.2 kurulumunda yeni seçenekler ilk update işleminden sonra gelir.
Varsayılan kaynak yalnız resmi GitHub stable release paketidir; geliştirme dalından kendiliğinden kod çekmez. Paket yayınlanmamışsa veya erişilemiyorsa hata bildirir, güncellenmiş gibi davranmaz. İndirilmiş ZIP ile çevrimdışı güncelleme ve geri alma için güncelleme rehberi.
Aynı kurucuyu mevcut vault üzerinde çalıştır. Notlar, Companion dosyaları, eski daily/ ve knowledge/ içerikleri korunur. Tanınan eski writer'lar geri alınabilir biçimde devreden çıkarılır; özelleştirilmiş sistem dosyası veya çalışan eski worker varsa işlem durur ve açıklama verir.
V2'nin arka planda model çağıran günlük özetleyici/derleyici akışı V3'te çalışmaz. Bunun yerine aktif ajan bilinçli olarak iş sonucu ve bilgi notu yazar. Yeni sonuç bağlantıları daily/v3/ ve knowledge/v3/outcomes.md altında oluşturulur. Eski günlükler yeniden özetlenmez. Geçiş ve sınırları · Tarihsel V2 rehberi.
Kullanıcı notları updater'ın değiştireceği sistem dosyaları değildir. Yönetilen dosyada farklı bir değişiklik görülürse conflict bildirilir; ilgisiz desteklenen ayar değişiklikleri birleştirilir. Yedek ve journal vault dışında yereldir. Bir kesinti sonrası recover veya rollback kullanılabilir.
Arama yerel kelime eşleştirmesi kullanır; genel doğal dil anlama veya her soruda doğru hatırlama sözü vermez. Motor kendisi model çağırmaz; ajana yaptırdığın işler istemcinin normal kullanımına girer. Otomatik doğrulamalar ve gerçek istemci kontrolleri ayrı raporlanır.
Kaynak formatı · Runtime · Semantik test sözleşmesi · Sürüm paketi ve updater · Birden çok makine.
Açık kaynak, MIT lisansı. Avenox tarafından günlük ikinci beyin iş akışlarından geliştirildi. V2 bilgi derleme fikri için Karpathy'nin bilgi tabanı desenine teşekkürler.