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.
-
Kasan yoksa Obsidian'ı kur ve bir kasa oluştur.
-
İ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.
-
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
-
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.