Obsidian Sync kini mendukung klien headless

 (help.obsidian.md)
2 poin oleh GN⁺ 2026-03-01 | 1 komentar | Bagikan ke WhatsApp
  • Obsidian Sync kini menyediakan klien headless yang memungkinkan sinkronisasi dari lingkungan command line tanpa aplikasi desktop
  • Memungkinkan sinkronisasi vault di lingkungan non-interaktif seperti pipeline CI, server, dan skrip otomasi
  • Menjalankan sinkronisasi sekali jalan atau berkelanjutan dengan perintah ob sync, serta mendukung autentikasi otomatis melalui variabel lingkungan OBSIDIAN_AUTH_TOKEN
  • Mencakup sekumpulan perintah rinci untuk membuat vault jarak jauh, mengatur koneksi lokal, memeriksa status, mengubah konfigurasi, dan lainnya
  • Di Windows dan macOS, tersedia modul native yang mempertahankan waktu pembuatan file (birthtime) untuk memperkuat integritas data

Gambaran umum

  • Headless Client dari Obsidian Sync adalah alat untuk menyinkronkan vault tanpa aplikasi desktop
    • Berguna di CI, agen otomasi, dan lingkungan server
    • Dapat mengambil perubahan terbaru atau menjaga file tetap mutakhir secara berkelanjutan
  • Pada satu perangkat, Sync desktop dan Headless Sync tidak boleh digunakan secara bersamaan, karena ada risiko benturan data
  • Instalasi dilakukan dengan perintah npm install -g obsidian-headless

Cara penggunaan dasar

  • Login: ob login
  • Melihat daftar vault jarak jauh: ob sync-list-remote
  • Menyiapkan vault lokal: ob sync-setup --vault "My Vault"
  • Sinkronisasi sekali jalan: ob sync
  • Sinkronisasi berkelanjutan: ob sync --continuous
  • Di lingkungan non-interaktif, autentikasi dapat diotomatisasi dengan menetapkan variabel lingkungan OBSIDIAN_AUTH_TOKEN

Perintah utama

  • ob sync-list-remote: Menampilkan daftar semua vault jarak jauh di akun, termasuk vault bersama
  • ob sync-list-local: Menampilkan vault yang dikonfigurasi secara lokal beserta path-nya
  • ob sync-create-remote: Membuat vault jarak jauh baru
    • Opsi: --name, --encryption(standard atau e2ee), --password, --region
  • ob sync-setup: Menyiapkan koneksi antara vault lokal dan vault jarak jauh
    • Opsi: --vault, --path, --password, --device-name, --config-dir
  • ob sync: Menjalankan sinkronisasi untuk vault yang telah dikonfigurasi
    • Mendukung pemantauan perubahan dan sinkronisasi berkelanjutan dengan opsi --continuous
  • ob sync-config: Melihat atau mengubah konfigurasi sinkronisasi vault
    • Dapat menetapkan strategi konflik (merge/conflict), jenis file, kategori pengaturan yang akan disinkronkan, folder yang dikecualikan, dan lainnya
  • ob sync-status: Menampilkan status sinkronisasi dan konfigurasi vault
  • ob sync-unlink: Melepas vault dari sinkronisasi dan menghapus kredensial yang tersimpan

Modul native

  • Menyertakan addon native untuk Windows dan macOS yang menetapkan waktu pembuatan file (birthtime)
    • Mempertahankan waktu pembuatan asli saat file diunduh dari server
    • Menargetkan N-API versi 3 dan menjaga kompatibilitas ABI antarversi Node.js
  • Di Linux, birthtime tidak didukung sehingga addon tidak disertakan, tetapi sinkronisasi tetap berfungsi normal
  • Target biner pra-build:
    • win32-x64, win32-arm64, win32-ia32, darwin-x64, darwin-arm64

Bacaan terkait

1 komentar

 
GN⁺ 2026-03-01
Komentar Hacker News
  • Obsidian baru saja menambahkan fitur CLI
    Lihat dokumentasi resmi
    Belakangan ini sangat menyenangkan memakai Obsidian bersama AI CLI. Bahkan tanpa plugin pun langsung bisa dipakai karena strukturnya hanya berupa direktori Markdown
    • Selama ini saya menyinkronkan Obsidian lewat iCloud, tetapi saat mengakses kontainer file iCloud harus memberi izin akses disk penuh, jadi terasa merepotkan
      Penasaran apakah kebanyakan orang memakai Obsidian Sync berbayar, atau memakai alternatif seperti SyncThing
    • Senang melihat CLI kembali mendapat perhatian
    • Di CLI memang belum bisa melihat catatan secara langsung, tetapi beberapa aksi seperti fitur pencarian bisa dipicu
    • Fitur ini sepertinya akan sangat berguna, terima kasih
  • Saya ikut terlibat langsung dalam proyek ini. Kalau ada pertanyaan, akan saya coba jawab
    • Sambil mengucapkan terima kasih karena telah membuat Obsidian, ada yang bertanya apakah ada rencana mengemas headless sync client agar bisa dipakai di Docker atau Podman
      Juga penasaran apakah saat memasang obsidian-headless, CLI ikut tersedia, atau ini murni hanya untuk sinkronisasi
    • Di kantor kami sedang membahas bahwa tidak ada sinkronisasi berbasis CLI, jadi senang melihat fitur resmi ini hadir
      Sekarang kami akan mempertimbangkan Obsidian Sync resmi
    • Penasaran bagaimana konflik sinkronisasi di sistem file ditangani
      Misalnya jika ada edit serentak lalu salah satunya menimpa yang lain, apa yang terjadi pada perubahan saya
    • Ada yang bertanya apakah ada rencana mendukung izin scoped token yang hanya memberi akses ke folder atau catatan tertentu
      Ingin memperbarui catatan tertentu secara otomatis lewat perubahan status atau cron job, tetapi ingin menghindari akses ke seluruh vault
      Produknya sangat bagus sampai-sampai saya juga membeli VIP Catalyst
    • Ingin tahu panduan atau titik awal untuk pengaturan kolaborasi tim ketika banyak orang mengedit dan menyinkronkan file bersama
  • Akan bagus kalau bisa mengedit hanya satu file Markdown saja
    Misalnya hanya ada satu readme.md di sebuah proyek, dan saya tidak ingin membuat vault terpisah beserta file konfigurasinya hanya untuk membukanya
    • Fitur itu rencananya akan ditambahkan suatu saat nanti
      Namun ini tidak sederhana karena banyak fitur Obsidian bergantung pada pengaturan tingkat vault
      Misalnya tema apa yang dipakai, plugin mana yang diaktifkan, bagaimana menangani pelengkapan otomatis [[tautan]], dan sebagainya
  • Fitur kali ini adalah fitur Obsidian yang paling saya inginkan
    Sepertinya akan sangat berguna untuk otomatisasi sisi server atau pekerjaan berbasis RAG
  • Kemarin saya menemukan bug saat menguji headless client dan melaporkannya, lalu hari ini saya melihat bug itu sudah langsung diperbaiki
    Terkait itu saya punya tulisan blog eksperimental → utf9k.net/blog/obsidian-headless
    Alur kerja ini memang belum sempurna, tetapi terasa seperti gesekan dalam proses menulis hingga langsung publish jadi berkurang
    Dulu saya menggabungkan Git atau berbagai plugin Obsidian, tetapi selalu terasa rumit
  • Saya kira cukup memakai Nextcloud seperti folder Markdown lokal, ternyata tidak begitu
    Sepertinya selama ini saya memakainya dengan cara yang benar-benar salah
  • Ada yang punya rekomendasi plugin Obsidian yang mendukung pengeditan AI di mobile?
    Saya ingin mengedit sambil bercakap dengan dokumen seperti di ChatGPT, tetapi belum menemukan yang cocok
    Saya juga penasaran apakah memungkinkan melakukan tool calling untuk revisi sebagian saja tanpa menulis ulang seluruh dokumen
    • Saya sudah mencoba beberapa plugin, tetapi pada akhirnya yang paling baik adalah memakai Claude Code lewat kendali jarak jauh
  • Di desktop saya tidak memakai Obsidian, tetapi di ponsel saya memakainya
    Dengan fitur ini saya sepertinya bisa sinkronisasi di ponsel lalu membuka dokumen di desktop dengan Neovim
  • Selama lebih dari setahun saya mencari “Obsidian CLI” tiap bulan, jadi senang sekali akhirnya ini hadir
    • Saya juga memakai Obsidian bersama Claude atau Codex, tetapi kurang paham nilai tambah apa yang diberikan CLI
      Kalau ini hanya file Markdown biasa, kenapa CLI diperlukan, dan bagaimana AI menangani vault lewat CLI juga membuat saya penasaran
  • Saya memakai Obsidian bersama Claude agent untuk menyinkronkan bahan riset atau log harian
    Dengan skill kustom, ini sebenarnya sudah berjalan cukup baik, tetapi fitur kali ini sepertinya akan membuat alur kerja lebih mulus
    Saya juga membuat alat CLI bernama obsidian-semantic-search untuk mewujudkan pengindeksan embedding LanceDB dan pencarian semantik
    Dengan ini saya bisa membuat keterhubungan internal antarnot jauh lebih baik
    • Ingin tahu apakah detail pengaturannya dengan Claude Code bisa dibagikan lebih lanjut
    • Juga ingin tahu bagaimana cara ini memengaruhi pemakaian token atau kuota