Hafıza OS

Ajanlar değişsin, hafızan aynı yerde kalsın.

Hafıza OS; tercihlerini, kararlarını, işlerini ve kaynaklarını kendi Markdown
kasanda tutman için açık kaynak bir başlangıç sistemi. Claude Code, Codex ve
Antigravity aynı kasaya yönlendirilebilir. Dosya ve terminal erişimi olan diğer
ajanlara da ortak yönerge aktarabilirsin.

Dosyalar sende kalır; Obsidian onları gezmek için isteğe bağlı bir arayüzdür.
Kurulum, bütün sohbetlerini otomatik hatırlama garantisi değildir: yönerge
okuma, kaynaklı geri çağırma ve oturum kaydı farklı katmanlardır.

Neler yapabilirsin?

• Kaynağıyla hatırla: göreve uygun küçük bağlam paketleri, kaynak yolu ve
  sürüm denetimiyle eski bilgiyi güncel karardan ayır.
• Bilgileri bağla: tercih, karar, ders ve örnekleri bilgi ağında
  kapsamlarıyla birleştir; Obsidian'da kaynaklarına git.
• Konu dosyaları oluştur: konu sentezi ile incelenmiş
  bilgileri birlikte gör. Bunlar kaynaklardan türetilen, yenilenebilir görünümlerdir.
• İş ve çıktıları takip et: devam kapsülü, karar geçmişi ve çıktı
  takibi ile sonraki adımı ve doğrulanmış dosya sürümünü bul.
• İstersen erişimi genişlet: Mem0 isteğe bağlı
  indeks, Jev varsayılan kapalı erişim/inceleme danışmanıdır.
  Kanonik kaynak yine yerel kasadır.
• Deneyimi sonraki işe taşı: öğrenme döngüsü ile
  sonuçlardan incelemeli dersler çıkar; karar koşullarını ve istisnaları koru,
  hafızaya dayalı cevapların kaynaklarını kontrol et.

Hangi ajanla?

2026.09.19.1 sürümünün 360 testlik paketi Linux, macOS ve Windows’ta başarılı: gerçek OS koşumu.
İşletim sistemine özgü bir test diğer platformda atlanır. Antigravity CLI 1.1.27
ile Linux'ta gerçek hook → inceleme → farklı oturumda hatırlama zinciri doğrulandı.
Claude Code 2.1.261 için adaptör testleri geçti.
Kurulum ve destek matrisi.

Yapay zekâ ajanına yapıştırarak kur

Dosya ve terminal erişimi olan yapay zekâ ajanına aşağıdaki mesajı yapıştır.
Örneğin Claude Code, Codex veya Antigravity kullanabilirsin:

https://github.com/fornhere/hafiza-os adresindeki hafıza sistemini bilgisayarıma kur.
Önce depodaki AJANLA-KURULUM.md yönergesini oku ve uygula.
İşletim sistemimi ve mevcut kurulumu kontrol et; kişisel dosyalarımın üzerine yazma.
Mem0 ve Jev kullanmak isteyip istemediğimi sohbet içinde tek tek sor.
Anahtarım yoksa resmi anahtar sayfasını açıp almama yardımcı ol.
API anahtarını sohbete isteme; benim erişebildiğim terminalde gizli giriş kullandır.
Bu hizmetleri atlayarak da kurulumu tamamlayabileyim.
Sonunda ne kurulduğunu, neyin atlandığını ve benim yapacağım son adımı açıkla.

Kullandığın ajan kurulumu yürütür ve seçimlerde yardımcı olur. Mevcut kurucu anahtarları
terminalde alır; bunlar sohbet içinde otomatik açılan bir form değildir.
Ajan kullanıcıya açık bir terminal sağlayamıyorsa gizli giriş adımını senin
terminalinde tamamlaman için komutu verir. Yalnız sohbet erişimi olan bir
uygulama bilgisayarına doğrudan kurulum yapamaz. Hazır kurulum bağlantıları
Claude Code, Codex ve Antigravity içindir; diğer ajanlara Markdown yönergesi
aktarılabilir, ancak aynı otomatik kayıt desteği varsayılmaz.

Tek komutla kur

Python 3.10+ kurulu olsun. Linux / macOS terminaline yapıştır:

curl -fsSL https://raw.githubusercontent.com/fornhere/hafiza-os/main/install.sh | bash

Windows PowerShell:

& ([scriptblock]::Create((Invoke-WebRequest 'https://raw.githubusercontent.com/fornhere/hafiza-os/main/install.ps1' -UseBasicParsing).Content))

Kurucu sırayla:

1. Kullandığın ajanı sorar: Codex, Claude Code veya Antigravity.
2. Güncel depo dosyalarını indirip ~/Hafiza kasasını hazırlar. Git gerekmez;
   mevcut klasörün üzerine yazılmaz.
3. Obsidian kurulu değilse resmi masaüstü paketini indirir ve SHA256 değerini
   doğrular. Linux'ta AppImage çalıştırılabilir hazırlanır; Windows/macOS'ta
   indirilen kurucuyu açıp uygulamanın kurulumunu tamamla.
4. “Mem0 API anahtarın var mı?” diye sorar: var / birlikte alalım / atla.
   “Birlikte alalım” seçilirse resmi Mem0 anahtar sayfasını açar; giriş yapıp
   API Keys bölümünden anahtarı kopyalayarak terminale dönmeni anlatır.
5. “Jev için API anahtarın var mı?” diye sorar: var / Vercel’den alalım / atla.
   Yeni anahtar için Vercel model listesini ve API Keys sayfasını açar;
   hesap/takım seçimi → Create key → kopyala → terminale dön adımlarını gösterir.
   Mevcut anahtarın varsa Vercel veya TypeSafe sağlayıcısını seçersin.
   Her iki soruda da Enter ile atlayabilirsin.
6. Ajanın kasa yönerge bağlantısını kurar ve sıradaki adımı gösterir.

API anahtarları gizli girişle alınır; kasanın ve Git'in dışında saklanır.
Mem0 girersen kullanıcı kimliği de sorulur ve uzak arama etkinleştirilir.
Jev girersen seçtiğin sağlayıcının bağlantısı on olarak ayarlanır. Vercel
anahtarı Vercel AI Gateway’e, TypeSafe anahtarı doğrudan TypeSafe’e gider.
19 Eylül 2026 kontrolünde Vercel model listesinde
Jev Free görünüyordu; güncel fiyat ve hesap kotasını açılan sayfada kontrol et.
Tarayıcı açılamazsa kurucu bağlantıyı terminalde gösterir.
Anahtarlar kurulumda canlı API isteğiyle doğrulanmaz; yanlış anahtar hizmeti
çalıştırmaz. Anahtarsız yerel hafıza kullanılabilir. Otomatik sohbet kaydı ve
arka plan incelemesi ayrı kurulur: kullanım rehberi.

Kurulum bitince kasayı Obsidian'da Open folder as vault ile aç; ajanı yeniden
başlatıp kasa klasöründe yeni sohbet başlat. İlk mesaj:

agents.md dosyasını oku. Profilimi birlikte hazırlayalım; soruları tek tek sor.

Başka klasör veya otomatik kullanım için:

curl -fsSL https://raw.githubusercontent.com/fornhere/hafiza-os/main/install.sh | bash -s -- --agent codex --vault "$HOME/Hafiza-Yeni"

--skip-obsidian indirmeyi atlar. --non-interactive --agent codex API sorularını
atlar. Var olan kişisel kasa için bu kurucuyu kullanma; aşağıdaki ajan bağlantısı
adımları mevcut dosyaları yeniden indirmeden uygulanabilir.

İndirdiğin dosyaları önce incelemek istersen Code → Download ZIP ile indir,
baslat.py dosyasını okuyup python3 baslat.py (Windows: py -3 baslat.py) çalıştır.

İlk kez kullanıyorsan

1. Bu sayfanın üstündeki Code → Download ZIP ile indir ve arşivi aç.
   Klasörü kalıcı tutacağın bir yere taşı; örneğin kullanıcı klasöründe Hafiza.
   Bu klasör senin kasan: notların ve ayarların burada duracak.
2. Bilgisayarında Python 3.10+ ve dosya/terminal erişimi olan bir ajan
   (Claude Code, Codex veya Antigravity CLI) olsun. Obsidian isteğe bağlıdır;
   kullanıyorsan bu klasörü Open folder as vault ile aç.
3. Terminali çıkardığın klasörde aç. İçinde agents.md, araclar ve zihin
   klasörlerini görmelisin. Aşağıdaki komutlarda claude yerine kullandığın
   ajana göre codex veya antigravity yaz.

Linux / macOS:

python3 --version
python3 -X utf8 araclar/ajan_kur.py --vault "$PWD" --agent claude
python3 -X utf8 araclar/ajan_kur.py --vault "$PWD" --agent claude --apply

Windows PowerShell:

py -3 --version
py -3 -X utf8 .\araclar\ajan_kur.py --vault "$($PWD.Path)" --agent claude
py -3 -X utf8 .\araclar\ajan_kur.py --vault "$($PWD.Path)" --agent claude --apply

İlk kurulum komutu yapılacakları gösterir; --apply olan komut uygular.
Ajanı yeniden başlat ve kasa klasörünü aç. İlk mesaj olarak şunu gönder:

Bu klasör benim hafıza kasam. Önce agents.md dosyasını oku ve oradaki
açılış sırasını izle. Sonra zihin/çekirdek.md için bana kısa bir mülakat yap;
soruları tek tek sor. Cevaplarımdan bir profil taslağı çıkar, onayladığım
bilgileri dosyaya yaz. Boş alanları tahmin ederek doldurma.

Bu başlangıç ajana kasanın yerini ve çalışma yönergelerini tanıtır.
Sohbetlerin arka planda kaydı ayrıca kurulur.
Adım adım kullanım rehberi →: günlük mesaj örnekleri,
yeni sohbette hatırlama denemesi ve isteğe bağlı kayıt kurulumu.

Günlük kullanım

Ajana normal konuşarak ne yapmak istediğini söyle:

• Kaldığın yerden devam: “Bu projede son kararımız neydi? Kaynağını bul,
  açık kalan işi söyle ve oradan devam edelim.”
• Tercihini kullan: “Metni yazmadan önce kasadaki anlatım tercihlerimi oku.”
• Bilgiyi düzelt: “Bu not artık geçerli değil. Kaynağını bul ve değişiklik
  taslağını göster.”
• Kayıt dışında tut: “Bu konuşmayı hafızaya alma.”

Ajanın verdiği dosya yolunu açarak sonucu kontrol et. İlk kullanımda geçmiş
bilgi bulunmaması normaldir; kasa senin notlarınla dolacak. Kişisel kasanı
bu kamu deposuna yükleme.

Son eklenenler

• 19 Eylül: kaynaklı öğrenme döngüsü: aday incelemesi,
  karar gerekçeleri ve koşulları, doğrulanmış sonuçlardan ders çıkarma ve cevap atıf kontrolü.

• 19 Eylül, 2026.09.19.1: yerel Windows/macOS/Linux motoru; Claude/Antigravity
  oturum adaptörleri, ortak makbuz erişimi, güvenli hook kurulum/geçişi ve üç OS testi.

• 19 Eylül: üç istemci için ortak yönerge kurucusu ve genel Markdown aktarımı.

• 18 Eylül: kaynaklı konu dosyaları, isteğe bağlı Jev danışmanı, bilgi ağı,
  karar/çıktı takibi ve hafızanın görünür kullanım bilgisi.

Tüm güncelleme notları · Kullanım doğrulama
· Fayda ölçümü

Sınırlar ve gizlilik

Bu depo kişisel hafızanın kendisi değil, şablonudur. Kişisel kopyanı özel tut;
anahtar, parola ve özel yazışmaları kamu deposuna koyma. Görev ajanı doğrudan
kanonik kataloğa veya Mem0'a yazmaz; kaynaklı aday ayrı incelemeden geçer.
Mem0/Jev açıldığında belirli içerikler uzak servise gider; ilgili rehberleri oku.

Kaydın bulunması, cevabın doğruluğu ve işine faydası ayrı ölçülür. Konu
sentezinin kelime temelli yönlendirmesi bütün doğal dil sorularını çözmez;
Jev puanları da kullanıcı onayı değildir. İstemci izinleri, yönerge önceliği ve
bağlam sınırları nedeniyle bir dosyanın kurulmuş olması okunacağını kanıtlamaz.

• agents.md: kasa kuralları ve çalışma biçimi.
• zihin/: kimlik, kaynaklı hafıza, son oturum ve açık işler.
• komuta/: öncelikler, ajan brief'i ve inceleme yönergeleri.
• projeler/, günlük/, arşiv/: süren işler, tarihli kayıtlar ve kapanmış işler.
• gelen-kutusu/: henüz ayıklanmamış girdiler.
• araclar/: yerel erişim ve bakım araçları; yalnız Mem0'a ait değildir.

Aşağıdaki örnekler POSIX kabuğu içindir; Windows'ta Python için py -3 -X utf8 ve PowerShell yollarını kullan.

python3 araclar/hafiza.py --vault . validate
python3 araclar/hafiza.py --vault . context 'ilgili karar' --limit 5 --char-budget 1200

Hafıza politikası, konsolidasyon,
görünürlük ve yayın sınırları.

Lisans

MIT.