Obsidian Sync artık headless istemciyi destekliyor

 (help.obsidian.md)
2 puan yazan GN⁺ 2026-03-01 | 1 yorum | WhatsApp'ta paylaş
  • Obsidian Sync, masaüstü uygulaması olmadan da komut satırı ortamında senkronizasyon yapabilen bir headless istemci sunuyor
  • CI pipeline'ları, sunucular, otomasyon script'leri gibi etkileşimsiz ortamlarda vault senkronizasyonu gerçekleştirilebiliyor
  • ob sync komutuyla tek seferlik veya sürekli senkronizasyon çalıştırılabiliyor ve OBSIDIAN_AUTH_TOKEN ortam değişkeniyle otomatik kimlik doğrulama destekleniyor
  • Uzak vault oluşturma, yerel bağlantı ayarlama, durum kontrolü, yapılandırma değiştirme gibi ayrıntılı komut seti içeriyor
  • Windows ve macOS'ta dosya oluşturma zamanı (birthtime) değerini koruyan bir yerel modül sunarak veri bütünlüğünü güçlendiriyor

Genel bakış

  • Obsidian Sync'in Headless Client aracı, masaüstü uygulaması olmadan vault senkronize etmeyi sağlar
    • CI, otomasyon ajanları ve sunucu ortamlarında kullanışlıdır
    • En güncel değişiklikleri çekebilir veya dosyaları sürekli güncel tutabilir
  • Tek bir cihazda Desktop Sync ve Headless Sync aynı anda kullanılmamalıdır; veri çakışması riski vardır
  • Kurulum npm install -g obsidian-headless komutuyla yapılır

Temel kullanım

  • Giriş: ob login
  • Uzak vault listesini görüntüleme: ob sync-list-remote
  • Yerel vault ayarlama: ob sync-setup --vault "My Vault"
  • Tek seferlik senkronizasyon: ob sync
  • Sürekli senkronizasyon: ob sync --continuous
  • Etkileşimsiz ortamlarda kimlik doğrulamayı otomatikleştirmek için OBSIDIAN_AUTH_TOKEN ortam değişkeni ayarlanabilir

Başlıca komutlar

  • ob sync-list-remote: Hesaptaki tüm uzak vault'ların listesini gösterir; paylaşılan vault'lar da dahildir
  • ob sync-list-local: Yerelde ayarlanmış vault'ları ve yollarını gösterir
  • ob sync-create-remote: Yeni bir uzak vault oluşturur
    • Seçenekler: --name, --encryption(standard veya e2ee), --password, --region
  • ob sync-setup: Yerel ve uzak vault arasında bağlantı ayarlar
    • Seçenekler: --vault, --path, --password, --device-name, --config-dir
  • ob sync: Ayarlanmış vault için senkronizasyonu çalıştırır
    • --continuous seçeneğiyle değişiklik izleme ve sürekli senkronizasyon desteklenir
  • ob sync-config: Vault'un senkronizasyon ayarlarını görüntüler veya değiştirir
    • Çakışma stratejisi (merge/conflict), dosya türleri, senkronize edilecek ayar kategorileri ve hariç tutulacak klasörler belirtilebilir
  • ob sync-status: Vault'un senkronizasyon durumunu ve ayarlarını gösterir
  • ob sync-unlink: Vault'u senkronizasyondan ayırır ve kaydedilmiş kimlik bilgilerini siler

Yerel modül

  • Windows ve macOS için dosya oluşturma zamanını (birthtime) ayarlayan bir yerel eklenti içerir
    • Sunucudan dosya indirilirken özgün oluşturma zamanı korunur
    • N-API sürüm 3'ü hedefler ve Node.js sürümleri arasında ABI uyumluluğunu korur
  • Linux'ta birthtime desteklenmediği için eklenti dahil edilmez, ancak senkronizasyon normal şekilde çalışır
  • Önceden derlenmiş ikili hedefler:
    • win32-x64, win32-arm64, win32-ia32, darwin-x64, darwin-arm64

İlgili okumalar

1 yorum

 
GN⁺ 2026-03-01
Hacker News yorumları
  • Obsidian CLI özelliğini yeni eklemiş.
    resmi dokümanlara bakılabilir.
    Son zamanlarda Obsidian’ı yapay zeka CLI’larıyla birlikte kullanmak gerçekten çok eğlenceli. Eklenti olmadan da, sadece bir Markdown dizin yapısı olduğu için hemen kullanılabiliyor.
    • Obsidian’ı iCloud ile senkronize ediyordum ama iCloud dosya kapsayıcısına erişirken tam disk izni istemesi rahatsız ediciydi.
      Herkes ücretli Obsidian Sync mi kullanıyor, yoksa SyncThing gibi alternatiflere mi yöneliyor merak ediyorum.
    • CLI’nin yeniden ilgi görmesi sevindirici.
    • CLI üzerinden notlar henüz doğrudan görüntülenemiyor ama arama özelliği gibi bazı işlemler tetiklenebiliyor.
    • Bu özelliğin gerçekten çok faydalı olabileceğini düşünüyorum, teşekkürler.
  • Bu projeye bizzat katkıda bulundum. Sorusu olan varsa yanıtlamaya çalışırım.
    • Obsidian’ı yaptıkları için teşekkür edip, headless sync client’ı Docker ya da Podman’da kullanılabilecek şekilde paketleme planları olup olmadığını sormuş.
      Ayrıca obsidian-headless kurulunca CLI’nin de birlikte gelip gelmediğini, yoksa bunun sadece senkronizasyon için mi olduğunu merak ediyor.
    • Şirkette CLI tabanlı senkronizasyonun olmadığından bahsediyordum; resmi bir özelliğin gelmiş olması sevindirici.
      Artık resmi Obsidian Sync’i değerlendirmeyi düşünüyorum.
    • Dosya sisteminde senkronizasyon çakışması olursa bunun nasıl ele alındığını merak ediyorum.
      Örneğin aynı anda düzenleme yapıldığında bir taraf diğerinin üstüne yazarsa, benim değişikliklerime ne olacağını bilmek istiyorum.
    • Belirli klasörlere veya notlara erişebilen scoped token izinlerini destekleme planı olup olmadığını soruyor.
      Durum değişiklikleri veya cron job aracılığıyla belirli notları otomatik güncellemek istiyor ama tüm vault erişiminden kaçınmak istiyor.
      Ürünü beğendiği için VIP Catalyst de satın almış.
    • Birden fazla kişinin dosyaları düzenleyip senkronize ettiği ekip iş birliği ayarları için bir rehber ya da başlangıç noktası olup olmadığını soruyor.
  • Yalnızca tek bir Markdown dosyasını düzenleyebilmek güzel olurdu.
    Örneğin projede sadece bir readme.md varsa, onu açmak için ayrı bir vault ve ayar dosyaları oluşturmak istemiyorum.
    • Bu özellik bir gün eklenecek.
      Ancak Obsidian’ın birçok özelliği vault düzeyindeki ayarlara bağlı olduğu için bu basit değil.
      Örneğin hangi temanın kullanılacağı, hangi eklentilerin etkin olacağı, [[link]] otomatik tamamlamasının nasıl ele alınacağı gibi düşünülmesi gereken pek çok şey var.
  • Bu özellik, Obsidian’da en çok istediğim şeydi.
    Sunucu tarafı otomasyon ya da RAG tabanlı işler için gerçekten çok faydalı görünüyor.
  • Dün headless client’ı test ederken bir hata bulup bildirmiştim; bugün hemen düzeltilmiş olduğunu gördüm.
    Bununla ilgili yazdığım deneysel bir blog yazısı da var → utf9k.net/blog/obsidian-headless
    Bu iş akışı kusursuz değil ama yazı yazıp hemen yayımlamaya kadar olan sürtünmeyi azalttığını hissettiriyor.
    Eskiden Git ya da çeşitli Obsidian eklentilerini bir araya getiriyordum ama bu hep karmaşık oluyordu.
  • Ben sadece Nextcloud’u yerel bir Markdown klasörü gibi kullanmanın yeterli olduğunu sanmıştım ama öyle değilmiş.
    Görünüşe göre tamamen yanlış kullanıyormuşum.
  • Mobilde AI düzenleme destekleyen bir Obsidian eklentisi önerisi olan var mı merak ediyorum.
    ChatGPT gibi belgeyle konuşarak düzenleme yapmak istiyorum ama henüz uygun bir şey bulamadım.
    Belgenin tamamını yeniden yazmadan, kısmi düzenleme yapan tool calling mümkün mü ondan da emin değilim.
    • Birçok eklenti denedim ama sonunda uzaktan kontrol yöntemiyle Claude Code kullanmak en iyi sonuç verdi.
  • Masaüstünde Obsidian kullanmıyorum ama telefonda kullanıyorum.
    Bu özellik sayesinde telefonda senkronize edip masaüstünde belgeleri Neovim ile açabilirim gibi görünüyor.
  • Bir yıldan uzun süredir her ay “Obsidian CLI” diye aratıyordum; sonunda çıkmış olması harika.
    • Ben de Obsidian’ı Claude ya da Codex ile birlikte kullanıyorum ama CLI’nin ne gibi ek değer sunduğunu çok anlayamıyorum.
      Sadece Markdown dosyalarıysa CLI neden gerekli, ayrıca yapay zeka CLI üzerinden vault’u nasıl kullanıyor merak ediyorum.
  • Obsidian’ı Claude agent ile birlikte kullanarak araştırma materyallerimi ve günlük kayıtlarımı senkronize ediyorum.
    Zaten özel bir skill ile oldukça iyi çalışıyordu ama bu özellik iş akışını daha da pürüzsüz hâle getirecek gibi görünüyor.
    Ayrıca LanceDB embedding indeksleme ve anlamsal aramayı gerçekleştirmek için obsidian-semantic-search adlı bir CLI aracı da geliştirdim.
    Bu sayede notlar arasında daha iyi iç bağlantılar kurulabiliyor.
    • Claude Code ile ilgili ayrıntılı kurulumunu biraz daha paylaşabilir misin?
    • Bu yaklaşımın token kullanımı ya da kota üzerinde nasıl bir etkisi olduğunu da merak ediyorum.