Beyin

Neden?

Notlar Obsidian'da yazılır, Claude Code gibi ajanlar avenoxbeyin ile onları her oturumda okur. Ama kasa büyüdükçe neyin nereye bağlandığını görmek zorlaşır. Beyin kasanı okur ve dört görünümde gösterir. Sayılar elle yazılmaz; klasör değiştikçe kendiliğinden güncellenir.

flowchart LR
    O["Obsidian: sen yazarsın"] --> K[("Kasa klasörü: Markdown notlar")]
    C["Claude Code + avenoxbeyin: hafıza"] --> K
    K -->|yalnız okur, canlı izler| B["Beyin: sen görürsün"]
    B -.->|çift tık: notu aç| O

Ağ	Küre
Her proje ve tür kendi kümesinde; bir nota tıkla, bağlantıları parlasın.	Kasanın yavaşça dönen 3B haritası; sürükleyerek döndür.

Genel bakış
Haftalık aktivite, en çok bağlanan notlar, bugünün notu ve çözülmemiş bağlantılar gibi kasa sağlığı uyarıları.

Gizlilik

• Asla yazmaz. Uygulama kasandaki hiçbir dosyayı değiştirmez; düzenleme Obsidian'da yapılır. Yalnız seçtiğin kasa yolu ve görünüm ayarları, kasanın dışında macOS ayarlarında tutulur.
• İnternete çıkmaz. Ağ isteği, hesap, analitik yok. "Beyne sor" cihazdaki yerel aramadır. Bir notun içindeki web bağlantısına kendin tıklarsan macOS onu varsayılan tarayıcında açar; ⌘O notu Obsidian'a devreder.
• "visibility": "private" notların içeriği gösterilmez ve aramaya girmez.

Bu iddialar bağımsız bir güvenlik denetiminden geçmedi; avenoxbeyin ekibi de doğrulamadı. Uygulama App Sandbox kullanmadığı için ağsızlığı macOS zorlamaz. Kendin kontrol etmek için depoyu klonla (bkz. Kaynaktan derleme) ve:

Scripts/verify_offline.sh                          # kaynaktan derler; kodu, ikiliyi ve bağlı çerçeveleri tarar
Scripts/verify_offline.sh /Applications/Beyin.app  # indirdiğin uygulamayı tarar

Betik ağ ya da yazma API'si, web görünümü, güncelleyici, gömülü adres ve ağ yetkisi bulursa ne bulduğunu yazar ve hata koduyla çıkar. Her değişiklikte CI'da da çalışır.

Kurulum

Gereken: macOS 26 (Tahoe) veya üstü. Obsidian ve avenoxbeyin isteğe bağlı ama önerilir.

1. Kasan yoksa Obsidian'ı kur ve bir kasa oluştur.

2. İstersen avenoxbeyin'i kur. Kasa klasörünü Claude Code'da aç ve şunu yaz:

   https://avenox.lol/beyin.md adresini oku. Bu klasöre ikinci beynimi kur.

   Ayrıntılar: avenoxbeyin kurulumu.

3. Beyin'i indir. Beyin.zip dosyasını indir, aç ve Beyin.app'i Uygulamalar klasörüne sürükle. Bu sürüm henüz Apple onaylı değil: ilk açılışta macOS uyarırsa Sistem Ayarları › Gizlilik ve Güvenlik › Yine de Aç. Terminal'den uyarısız kurmak için:

   curl -fsSLO https://github.com/yigit2015/beyin-mac/releases/latest/download/Beyin.zip
   ditto -x -k Beyin.zip /Applications && open /Applications/Beyin.app
   

4. Aç ve kasanı seç. Varsayılan klasör ~/Beyin. Kasan başka yerdeyse açılış ekranındaki Başka klasör seç… düğmesini kullan; seçim hatırlanır, sonra Ayarlar'dan değiştirebilirsin.

Notlarını açmadan denemek için Ornek-Kasa.zip'i indir, aç ve o klasörü seç.

Kısayollar

Kısayol	İş
⌘1 · ⌘2 · ⌘3 · ⌘4	Odak · Ağ · Küre · Genel bakış
⌘F / ⌘L / ⌘K	Notlarda ara / Beyne sor / Komut paleti
⌘O, çift tık	Seçili notu Obsidian'da aç
⌘R	Kasayı yeniden oku
⌘+ ⌘− ⌘0	Yakınlaştır, uzaklaştır, sıfırla
⌥⌘I · ⌃⌘S	İnceleme paneli · kenar çubuğu

Hangi kasalarla çalışır?

• avenoxbeyin kasası: avenoxbeyin'in Markdown sözleşmesini esas alır. Hiçbir klasörün var olduğunu varsaymaz; çekirdek klasörü ve kategorileri önce frontmatter'dan (kind, project, visibility), sonra klasör adlarından keşfeder.
• Herhangi bir Obsidian kasası: her üst klasör bir küme olur. [[wikilink]]'ler Obsidian gibi çözülür.

Neyin okunup neyin atlandığı: docs/UYUMLULUK.md.

İsteğe bağlı: Claude Code sohbetlerini kasaya arşivle

extras/sohbet-arsivi her Claude Code konuşmasını kasandaki projects/sohbet-arsivi/ klasörüne Markdown olarak yazar; Beyin bunları Sohbetler olarak gösterir.

Bu, konuşmanın tam metnini diske yazar. API anahtarı ve token gibi kalıplar maskelenir ama her şeyi yakalayamaz. avenoxbeyin'in kendi sohbet izi bilerek yalnız üst bilgi tutar; hangisini istediğine sen karar ver.

Kurulum ve kapatma adımları: extras/sohbet-arsivi/README.md.

Kaynaktan derleme

Xcode 26 (Swift 6.2+) gerekir.

git clone https://github.com/yigit2015/beyin-mac.git
cd beyin-mac
swift test                      # çekirdek testleri
Scripts/package_app.sh          # Beyin.app oluşturur
open Beyin.app

Geliştirirken BEYIN_VAULT=/yol/kasa ile başka bir kasa, BEYIN_PREVIEW=1 ile önizleme verisi açılır. python3 Scripts/ornek_kasa.py örnek kasayı yeniden üretir.

Teşekkür ve bağlantı

Beyin, avenoxbeyin'in (MIT) Markdown ve frontmatter sözleşmesine uygun okumaya çalışır; onun kodunu içermez ve çalıştırmaz. Avenox ile resmi bir bağı yoktur, topluluk tarafından yapılmış bir araçtır.

Hata ve öneriler için issue açabilirsin.

Lisans

MIT

---

English

Beyin ("brain" in Turkish) is a read-only macOS app that visualizes an Obsidian vault as a live network, a rotating globe and an overview dashboard. It aims to follow the avenoxbeyin Markdown contract and works with any Obsidian vault (top-level folders become clusters).

• Never writes to your vault, makes no network requests, hides private notes. These claims have not been independently audited, nor verified by the avenoxbeyin team; check them yourself with Scripts/verify_offline.sh (or Scripts/verify_offline.sh /Applications/Beyin.app), which also runs in CI.
• Requires macOS 26 (Tahoe). Download Beyin.zip, drag Beyin.app to Applications, pick your vault folder. The build is not notarized yet: on first launch use System Settings › Privacy & Security › Open Anyway.
• Build from source: swift test && Scripts/package_app.sh.
• The UI is in Turkish. Unofficial community project, not affiliated with Avenox. MIT licensed.