Rehber · Not 178Deneyim
Logseq CLI: graph'ı terminalden sorgulamak ve otomasyona açmak
Logseq DB CLI'ını resmi CLI belgesine göre açıklar: app'ten bağımsız graph işlemleri, list/search/show/query, upsert, backup, import/export, server, sync ve yapılandırılmış JSON/EDN output ile CI/CD otomasyonu.
Yazan Ahmet Canal · 5 Ekim 2026
- Okuma
- 3 dk
- Yayın
- 5 Ekim 2026
- Geri bağlantı
- 1
- Kaynak
- 2
İçindekiler · 14 bölüm
Bilgi ağı · 3 bağlantılı not
DB sürümünün en büyük farklarından biri, graph'ın yalnız GUI içinden kullanılmak zorunda olmaması.
CLI aynı veri modelini terminale çıkarıyor.
CLI nereden geliyor?
Resmî db-version.md CLI'ın nightly application kurulumu ile geldiğini söylüyor.
Ayrıca eski npm tabanlı @logseq/cli aracının ayrı olduğunu özellikle not ediyor.
Bu yüzden internette bulduğun eski CLI örneğini yeni komutlarla aynı kabul etme.
App'ten bağımsız çalışma
Resmî CLI belgesi CLI'ın Logseq app'ten bağımsız çalışabildiğini anlatıyor.
Bu önemli.
Örneğin CI ortamında:
- graph query
- validation
- export
- backup
gibi işler GUI açmadan yapılabilir.
Okuma komutları
CLI belge ailesinde şu tür operasyonlar var:
- list page
- list tag
- list property
- list task
- list node
- list asset
- search block
- search page
- search property
- search tag
- show
- query.
Bu yüzey, graph'ı script içinde analiz etmeye yeterli bir temel sağlar.
Yazma komutları
Upsert ailesi:
- block
- page
- task
- asset
- tag
- property
oluşturma veya güncelleme işleri için kullanılır.
Move ve remove da yapı değişiklikleri sağlar.
Write otomasyonu yaparken production graph yerine küçük test graph ile başla.
Task otomasyonu
CLI task komutu:
- status
- priority
- scheduled
- deadline
alanlarını doğrudan yönetebiliyor.
Bu, örneğin başka sistemden gelen işleri DB graph'a aktaracak otomasyonlar için kullanılabilir.
Ama generic tag/property mutation ile task-specific alanların aynı komutta her zaman birleşmediğini resmî CLI belgesi ayrıntılandırıyor.
Komut sözleşmesini script yazarken doğrudan güncel kaynaktan kontrol et.
Markdown block input
CLI block tree'lerini Markdown benzeri input ile ekleyebilir.
Bullet ve heading'ler block'a dönüşür; indentation child ilişkisini kurar.
Property ve tag davranışı da belirli kurallarla parse edilir.
Önemli sınır:
aynı input tekrar çalıştırıldığında idempotent update garantisi yok; yeni block ağacı oluşturabilir.
Otomasyonda duplicate önleme mantığını sen kurmalısın.
Dry run
CLI'da dry-run davranışı bulunuyor.
Bu, create işlemini gerçek write yapmadan planlanan operasyon olarak görmek için değerli.
MCP'deki pretend yaklaşımıyla aynı güvenlik düşüncesini taşır:
önce ne olacak → sonra yaz.
Yapılandırılmış output
Global output seçeneği:
- human
- json
- edn
biçimlerini destekliyor.
Machine-readable JSON/EDN CI ve script için önemli.
Human output terminal kullanımına uygun.
Bir otomasyon yazarken text table parse etmek yerine structured output kullan.
Query
CLI:
- doğrudan EDN query
- named query
- query list
davranışları sunuyor.
Named query'ler CLI config içinde tekrar kullanılabilir.
Bu, her CI adımında uzun query yazmak yerine merkezi sorgu tanımı kurmayı sağlar.
Backup ve graph lifecycle
Resmî CLI belgesi graph lifecycle işlemlerini de içeriyor:
- graph create
- graph export
- graph import
- graph backup create
- graph backup list
- graph backup restore
- graph backup remove.
Bu yüzden CLI yalnız içerik editörü değil; operasyon aracı.
Server ve doctor
CLI server yönetimi ve doctor kontrolleri de sunuyor.
Doctor:
- runtime script
- data dir permission
- running servers
- revision mismatch
gibi kontroller yapabilir.
Self-host veya automation pipeline'da bu tür health check'ler önemlidir.
CI/CD örneği
Basit bir akış:
- graph export al
- query/validation çalıştır
- yapılandırılmış sonucu kontrol et
- hata varsa pipeline'ı durdur
- gerekiyorsa yeni export üret.
Resmî db-version sayfası GitHub Actions gibi CI/CD platformlarında kullanım örneğini açıkça anıyor.
MCP mi CLI mı?
MCP:
- AI agent konuşması,
- tool çağrıları,
- model bağlamı
için iyi.
CLI:
- deterministik script,
- scheduled job,
- CI,
- batch işlem
için daha uygun.
İkisi aynı graph'ı farklı istemci türlerine açıyor.
Karar
Logseq CLI, DB sürümünü yalnız masaüstü PKM olmaktan çıkarıyor.
Graph artık terminalden sorgulanabilen, değiştirilebilen ve otomasyon pipeline'ına girebilen veri sistemi.
Bu güçle birlikte write komutlarında backup, dry-run ve test graph disiplini de zorunlu hale gelir.
Bu yazıda geçen araçlar
Araçlar örnek içindir; hiçbiri zorunlu değil. Karşılaştırma için araç atlasına bak.
Kaynaklar
Kaynak profili2 web
- Logseq. Logseq CLI. github.com/logseq/logseq/blob/master/docs/cli/logseq-cli.md web
- Logseq. DB version — CLI. github.com/logseq/docs/blob/master/db-version.md#cli web
Deneyim: Editöryal pratik ve kitaplara dayanıyor; birincil araştırma içermiyor. Türler kaynak metninden otomatik çıkarılır. Tüm kaynaklar ve onları anan yazılar Kütüphane’de.
Bu notu kasana al.
Yazının özeti, başlıkları, devam yazıları ve kaynakları Obsidian’a hazır bir kaynak notu olarak iner. “Kendi notum” bölümünü sen doldurursun; okuduğun yazı böylece kasanda bir bağlantıya dönüşür.
Haftada bir not, gelen kutuna bağlansın.
Yeni yazılar ve uygulanabilir tek bir fikir. Reklam yok, istediğin an tek tıkla ayrılırsın.