Repository navigation
Releases
Heart 1.9.14 — Görüldü-temizleme, güvenilir reattach, terminal temizleme
1.9.8 üzerine biriken düzeltmeler:
Aksiyon göstergesi
- Kırmızı bekleme sayısı artık o terminale bakınca temizlenir (klasör / proje / Dock / üst bar 🔔). Claude tekrar durunca yeniden alarm verir. Ses + bildirim her beklemede çalmaya devam eder.
Kalıcı terminaller
- Güvenilir reattach: uygulamayı kapatıp açınca oturumlar geri gelir. Açılış anındaki "list-sessions boş döndü" yarış durumu retry ile giderildi.
- Terminalleri temizle paneli ("+" menüsünden): tüm canlı Heart terminallerini listeler, tek tek veya "aktif hariç" toplu kapatır, ve "+" sürdürme geçmişini temizler.
- Sekme adları Claude'un kendi başlığından gelir; fare tekerleğiyle geçmişte scroll.
Kurulum: Heart.zip → aç, Heart.app'i /Applications'a taşı, ilk açılışta xattr -cr /Applications/Heart.app.
Heart 1.9.8 — Claude action indicator + persistent terminals
Claude Code entegrasyonu — aksiyon göstergesi
- Her terminaldeki Claude oturumu çalışıyor (yeşil) / seni bekliyor (kırmızı) olarak görünür — hem sidebar satırında hem session sekmesinde.
- Klasör başlıklarında ve proje sekmelerinde kırmızı bekleyen sayısı, Dock rozeti, ses + sistem bildirimi.
- Üst barda tıklanınca seni bekleyen terminale götüren kırmızı 🔔 rozet.
- Hook'lar
~/.claude/settings.json'a otomatik, idempotent kurulur (mevcut ayarlar korunur).
Kalıcı terminaller (tmux)
- Claude terminalleri uygulamayı kapatıp açınca yaşamaya devam eder ve otomatik geri bağlanır.
- Kapatılan terminaller hatırlanır; "+" menüsünden resume ile aynı sohbete geri dönülür (reboot sonrası da).
- "Terminal N" numaraları sabittir, silince kaymaz.
- Sekme adları Claude'un kendi başlığından otomatik gelir.
- Fare tekerleğiyle scroll, tmux geçmişinde gezinir.
Kurulum: Heart.zip → aç, Heart.app'i /Applications'a taşı, ilk açılışta xattr -cr /Applications/Heart.app.
Heart 1.8.7 — ⌘T / ⌘W terminal shortcuts
Yeni kısayollar
Yeni "Terminal" menüsünde (menubar'dan görünür):
- ⌘T — New Terminal / Session
- Claude task açıkken: yeni Claude session (ClaudeDetailView'daki + pill ile aynı)
- Diğer task: yeni terminal task'ı spawn'lar. Kaydedilmiş bir terminal path'i varsa onu kullanır; yoksa o anki task'ın cwd'sinden başlar. Aktif proje altına eklenir.
- ⌘W — Close Active Terminal / Session
- Claude task açıkken: aktif session'ı kapatır (PTY öldür + pill kaldır)
- ⌘T ile veya "+ Terminal" menüsüyle spawn edilmiş geçici terminal task'ı: stop + sil
- User-config'li task'lar (service / quick / browser / vs.): hiçbir şey yapmaz — kazara kayıt silmemek için.
⌘Q hakkında not
İstediğin ⌘Q'yu kullanmadım — macOS'un standard "uygulamadan çık" kısayolu. Eğer ⌘Q'yu terminal kapatma için override etseydim, Heart'tan çıkamaz hale gelirdin. ⌘W platform-native "close" verb'i ve aynı işi yapıyor — Finder, Safari, Terminal, hepsinde aynı mantık.
Güncelleme
Heart toolbar → güncelleme butonu.
Heart 1.8.6 — Repaint button + resize debounce + auto-recovery
Claude render glitch — profesyonel kurtarma katmanı
Önceki teoriler (winsize, scrollback, env var) tek başlarına çözmedi. Bu release teşhis yerine kurtarmaya odaklanıyor — sorunu tahmin etmek yerine kullanıcının her durumda kontrolde kalmasını sağlıyor.
Yeni
- "Repaint" butonu detail bar'da (Clear yanında) + ⌘⇧R kısayolu. Tıklayınca: SwiftTerm'in layout pass'ini yeniden çalıştırır (
terminal.resize), pending escape state'lerini temizler (softReset— buffer kaybolmaz, yalnız cursor / mod state'i), ve tüm canvas'ı yeniden çizer. Karakterler bozuk göründüğü an tek tuşa basıyorsun. - Otomatik recovery on task switch — başka bir task'a tıklayıp dönmek "bazen düzeltiyordu"; artık bu kazara değil deterministik: task değişiminden 200ms sonra otomatik
repaint. Yani sadece geçiş yapmak yeter. - Resize debounce — pencere / sidebar drag'i sırasında SwiftTerm'in ağır
processSizeChange+ TIOCSWINSZ zincirini her mouse-move'da değil drag bittikten 80ms sonra tek seferde çalıştırıyor. "Resize yapınca bazen daha kötü oluyor" şikayetinin direkt cevabı: o drag'lerde SwiftTerm'in resize pipeline'ı her frame koşuyordu. Real-time tracking için view boyutu hala anlık güncelleniyor — sadece ağır kısım coalesce ediliyor. - İlk attach çift-refresh — terminal ekrana ilk geldiğinde t=0 ve t=350ms olmak üzere iki refresh. İlki SwiftUI'nin layout pass'i ile yarışıyor, ikincisi sonrasına garanti veriyor.
Workflow
Bozulduğun an: ⌘⇧R veya toolbar'daki Repaint. Bu kadar.
Güncelleme
Heart toolbar → güncelleme butonu (1.8.4'ün log + Force Quit fallback'i hâlâ içeride).
Heart 1.8.5 — Sidebar UX (task/folder akışı)
Sidebar UX paketi (5 odaklı düzeltme)
- Move to menüsündeki duplicate root bug fix — sağ tık → Move to artık proje adını yalnızca tek satırda "At project root" olarak gösteriyor (eski label "X (root)" ikiye katlanıyordu).
- Quick chip'lere Move to — quick chip'e sağ tık → Move to → root + folder seçenekleri. Folder içinde takılan bir chip artık kolayca dışarı taşınabilir (JSON edit gerekmiyor).
- Quick bar'a sağ tık → New quick action / New folder — chip alanına sağ tık ile direkt quick task veya folder ekleyebilirsin.
- Drag-and-drop:
- Sidebar row'ları ve quick chip'leri sürüklenebilir (drag preview accent renkli)
- Folder header'larına ve folder-şekilli quick chip'lere drop = task o folder'a taşınır (hover'da accent outline)
- Sidebar'ın alt drop zone'u artık JSON import + "folder dışına çıkar" iki işlevde
- Edit/Add Task sheet'i Type-first — sheet açıldığında en üstte 2×3 büyük tip kartı (icon + ad + 1 satır açıklama). Önce tip seçilince form alttaki alanlar ona göre adapte oluyor (Browser → URL, GitHub → repo path, vs.). Auto-start toggle Network bölümüne taşındı.
Güncelleme
Heart toolbar → güncelleme butonu (1.8.4'ün log + Force Quit fallback'i hala içeride).
Heart 1.8.4 — Updater log + Force Quit fallback
Düzeltme
"Yeni sürüm kuruluyor ve uygulama yeniden başlatılıyor…" ekranı bir noktada donup hiçbir tuşa cevap vermiyordu (Heart kapanmayı bekliyor ama child PTY veya pencere termination'ı bloke ediyor).
- Updater artık her adımı log'luyor (download URL, unzip path, script path, chmod/nohup exit kodları, terminate tetik anı). UpdateView indirme ve kurulum state'lerinde monospace, otomatik kayan timeline gösteriyor — neyin nerede takıldığı görünür.
- Kurulum state'inde disabled "Kapat" yerine artık turuncu "Force Quit & Install" butonu var. Tıklayınca Heart
exit(0)ile sertçe kapanır; helper script zaten arka planda hazır olduğu için pid kaybolur kaybolmaz update'i tamamlar ve Heart'ı yeniden açar. - Güvence için:
NSApp.terminate(nil)çağrısından 7 saniye sonra hala buradaysak otomatikexit(0).
Bilinen iyileştirmeler (1.8.3'ten)
- Proje tab geçişlerinde pending state + alt shimmer
- ⌘1..⌘9 kısayolları (Claude task aktifken session, değilse proje)
Güncelleme
Heart toolbar'daki güncelleme butonu → "Şimdi Güncelle".
Eğer 1.8.3 donmaya devam ederse: zip'i indirip elle /Applications/Heart.app'a kopyala, xattr -cr /Applications/Heart.app.
Heart 1.8.3 — Tab switch feedback + ⌘1..9 + Claude render retry
Yeni
- Proje geçişlerinde loading hissi — tıkladığın pill anında pending state'e geçiyor (mini spinner + yarım yarım accent dolgu), tab şeridinin altında ince bir accent bar shimmer ediyor. SwiftUI sidebar + detail tree'yi yeniden inşa ederken "tıkladım mı acaba" boşluğu bitti.
- ⌘1..⌘9 kısayolları — yeni "Go" menüsünde 9 slot:
- Ana sayfa / normal task seçiliyken → N'inci proje tab'ine geçer.
- Claude task aktifken → o task'ın N'inci Claude session'una geçer.
Aynı tuşlar, context'e göre route ediliyor.
Claude harf-harf sorunu
Bir teori daha denedim (önceki winsize fix yetmedi):
- Spawn env'ine
TERM_PROGRAM=HeartveCLAUDE_CODE_NO_FLICKER=0ekledim — Claude Code'un alt-screen "flicker-free" renderer'ı kapansın (SwiftTerm o escape'leri temiz parse edemiyor). - Scrollback 50k'dan 10k'ya düşürüldü — render queue'su daha hafif.
Çözmediyse haber et — bir sonraki adım PTY raw byte log dump'ı olacak ki SwiftTerm'i ne kırıyor görebileyim.
Heart 1.8.2 — Quick folders + Terminal launcher
Yeni özellikler
- Quick chip'lerinde folder desteği — quick action'ları folder içine atarsan, sidebar üstündeki chip stripte folder bir dropdown chip olarak görünür. Tıklayınca içindeki chip'ler menüden seçilir. Çok chip'in olduğunda strip dağılmaz.
- Detail bar'da "+ Terminal" butonu — Terminal/Browser tab şeridinin en sağında "+" pill. Tıklayınca:
- Kayıtlı path'lerin listesi (yoksa "No saved paths yet" hatırlatması)
- Browse for new path… — yeni klasör seçici (otomatik kaydedilir + hemen yeni terminal açar)
- Manage paths… — sheet ile rename/değiştir/sil
- Her tıklama yeni bir shortcut-kind task'ı yaratıyor → istediğin kadar paralel terminal açabilirsin.
- Path'ler
~/Library/Application Support/Heart/terminal-shortcuts.jsoniçinde global olarak saklanır — proje silinse bile listeyle taşınır.
Güncelleme
Heart'taki güncelleme butonu tek tıkla geçirir.
Heart 1.8.1 — Terminal cols/rows sync fix
Düzeltmeler
- Terminal render bozulması — Heart içinde
claude(ve dinamik UI çizen diğer CLI'lar) çalıştırırken karakterlerin tek tek alt alta düşmesi sorunu giderildi. Sebep: container view geç layout olduğunda ya da detail pane'ler arasında swap yapılınca child process eski (bazen 0×0) winsize ile kalıyordu.OutputView.attach()swap sonrasısetFrameSize'ı yeniden tetikliyor → SwiftTermprocessSizeChangeçağrılıyor →terminal.resize+ TIOCSWINSZ child PTY'ye gidiyor.- Container'ın
setFrameSizeoverride'ı pencere/sidebar/split resize'larında terminal view'a forward ediyor. terminalView()artık 1200×720 (≈140×42) initial frame ile başlıyor — ilk spawn layout cycle'ından önce bile sağlam cols/rows alıyor.- Spawn komutu
stty cols X rows Yile prefix'leniyor, env'eCOLUMNS/LINESekleniyor — başlangıçta terminal genişliğini cache'leyen tool'lar doğru değeri görüyor.
Güncelleme
Uygulamadaki güncelleme butonundan tek tıkla geçilebilir. Manuel kurulum için zip'in içindeki INSTALL.txt'e bak.
Heart 1.8.0 — Per-project storage + Git/Update views + universal binary
What's new
Per-project storage
Each project now lives in its own projects/<id>.json instead of a single global tasks.json. Settings (⚙️) only edits the active project. Dragging a JSON onto a tab replaces just that project; AppDelegate routes external file drops into the current window, so they no longer spawn a second window. Existing setups migrate automatically — old tasks.json is preserved as tasks.json.bak.
GitHub-style git panel
New kind: "github" task renders a built-in panel — staged/unstaged diff, commit, push, pull — without leaving Heart.
In-app update checker
Compares the bundled version against the latest GitHub release and surfaces a toolbar badge when an update is available.
Universal binary
Built for arm64 + x86_64. Apple Silicon and Intel Macs install from the same zip.
Terminal polish
- 50k scrollback (was 500) — long build logs and Claude sessions stay readable
- Forces
TERM=xterm-256color+COLORTERM=truecolorso CLIs render in color from frame zero
Install
- Drag
Heart.appinto/Applications - Run
xattr -cr /Applications/Heart.app(clears Gatekeeper quarantine on ad-hoc signed apps) - Open via Spotlight: ⌘+Space → "heart"
Requires macOS 13+.