ledger
Projenizin oturumlar arası hafızası.
Claude Code, bağlam penceresi her sıfırlandığında her şeyi unutur.
Bir /compact, bir /clear ya da kapanan bir terminal — ve hedefler, kararlar, çoktan elediğiniz çıkmaz yollar, tam da yazmak üzere olduğunuz satır, hepsi uçup gider. Her oturuma "nerede kalmıştık" diye on dakika anlatarak başlarsınız.
ledger bunu çözer. Kendi kendini güncelleyen küçük bir canlı dosya kümesi tutar — böylece her oturum, bir compaction sonrası soğuktan açılan oturum bile, neyin bittiğini, neyin devam ettiğini, neyin engellendiğini ve tam sonraki adımı tam olarak bilir.
Kendi kendine çalışır. Onu hiç çağırmazsınız.
Kurulum · Nasıl çalışır · Canlı dosyalar · Güvenlik
CC BY-ND 4.0 · Claude Code eklentisi + becerisi · sıfır bağımlılıklı çekirdek
30 saniyelik özet
Projenizi Claude Code'da açtığınız anda, ilk mesajınızdan önce, bu brifing otomatik olarak enjekte edilir:
── ledger · auto-catchup ──
• Önceki oturum: auth refresh flow
• Tam sonraki adım:
src/lib/api.ts:refresh() içine 401-retry interceptor'ı bağla
— cookie yaklaşımı terk edildi (service-worker yarışı).
• Devam eden:
- [~] wire 401-retry interceptor in src/lib/api.ts
• Engellenmiş:
- [!] OAuth callback — blocked: Google console erişimi bekleniyor
• Önceki oturumdan beri commit'ler: 3a1f2e9 add refresh stub
• Çalışma ağacı: 1 commit'lenmemiş dosya.
Bunu siz istemediniz. Çoktan yürüdüğünüz çıkmazı hatırlamak zorunda değilsiniz. Sadece devam edersiniz.
Oturum bittiğinde — ya da Claude Code işin ortasında compact yaptığında — ledger her şeyi otomatik olarak diske anlık görüntüler. Döngü kapanır. Hiçbir şey kaybolmaz.
Kurulum
ledger iki şekilde gelir. Çoğu kişinin istediği eklentidir: otomasyonu sizin için bağlar.
Eklenti olarak (önerilen — kendi kendine çalışır)
# Claude Code içinde:
/plugin marketplace add realdeal88/ledger-tr
/plugin install ledger@ledger-tr
Hepsi bu. Beş hook kurulumda kaydolur. Herhangi bir projeyi açın, bir kez /ledger init çalıştırın, izleme aktiftir.
Bağımsız beceri olarak (yalnızca /ledger komutu, otomatik hook yok)
Yalnızca /ledger komutunu istiyor ve hook kurmamayı tercih ediyorsanız:
git clone https://github.com/realdeal88/ledger-tr
cp -r ledger-tr/skills/ledger ~/.claude/skills/ledger
Namespace notu: Eklenti olarak kurulduğunda komut /ledger:ledger olur (Claude Code eklenti becerilerini namespace'ler). Bağımsız beceri olarak kurulduğunda yalnızca /ledger.
Hızlı başlangıç
# 1. Projeyi Claude Code'da açın
# 2. Canlı dosyaları oluşturun (proje başına bir kez — hiçbir şeyin üzerine yazmaz):
/ledger init
# 3. ...sadece çalışın.
Buradan sonra özel bir şey yapmazsınız. Siz ilerledikçe ledger dosyaları güncel tutar. Projeyi bir dahaki açışınızda — ya da Claude Code compact yaptığı anda — durumunuz çoktan kaydedilmiş ve geri okunmuştur.
Gitmeden önce zengin, elle yazılmış bir devir için: /ledger handoff — ve bağlamı talep üzerine geri yüklemek için: /ledger (veya /ledger catchup).
Nasıl çalışır
Tasarım kuralı tek satır: disiplin hook ile garanti edilir, modelin hafızasıyla değil. Modelin "güncellemeyi hatırlamasına" güvenen her izleme sistemi aynı şekilde başarısız olur — unutan oturum, çöken oturumdur ve durum kaybolur. ledger yazma işlemini beş bloke etmeyen hook aracılığıyla mekanik olarak garanti eder.
| Ne zaman | Hook | Ne olur |
|---|
| Oturum başında | ledger-catchup.sh | auto-catchup brifingini enjekte eder — son konu, tam sonraki adım, devam eden + engellenmiş görevler ve önceki oturumdan beri commit deltası. |
| Çalışırken | ledger-drift.sh | Debounce'lu bir dürtme (en fazla 25 dk'da bir) — yalnızca kod değişiyor ama canlı dosyalar kımıldamadıysa. Geri kalan zaman sessiz. |
| Canlı dosya düzenlemelerinde | ledger-dashboard.sh | HTML panosunu yeniden üretir (debounce'lu). İsteğe bağlı. |
| Bir compaction'dan önce | ledger-checkpoint.sh | SESSION.md'yi anlık görüntüler, LOG.md'ye ekler, canlı dosyaları commit'ler. |
| Oturum sonunda | ledger-checkpoint.sh | Aynı anlık görüntü — böylece yarın taze bir terminal tek bir ritim kaybetmeden devam eder. |
Bunu güvenilir kılan iki şey:
