Obsidian CLI

Comanda il tuo vault.

Tutto ciò che puoi fare in Obsidian, lo puoi fare dalla riga di comando.

terminale
# Apri la nota giornaliera odierna
obsidian daily

# Cerca nel tuo vault
obsidian search query="appunti della riunione"

# Aggiungi un’attività alla tua nota giornaliera
obsidian daily:append content="- [ ] Fai la spesa "

Casi d’uso

Obsidian CLI è un ambiente programmabile per plain text.

Sviluppa.
Sviluppa plugin e temi più velocemente. Modifica il codice, ricarica, testa ed esegui il debug senza uscire dal terminale.
Collabora.
Distribuisci la documentazione, sincronizza i vault condivisi sui server, e integra Obsidian negli strumenti del tuo team.
Automatizza.
Orchestra il tuo flusso di lavoro con cron jobs, script shell e integrazioni personalizzate. Se sai scriptarlo, puoi farlo.
Sperimenta.
Leggi, cerca e scrivi nel tuo vault in modo programmatico. Consenti agli strumenti agentici di interagire con il tuo vault.

Inizia

Installa Obsidian CLI

01

Aggiorna Obsidian

Scarica l’ultima versione dell’installer di Obsidian Download →

02

Attiva il CLI

Abilita Interfaccia a riga di comando in ImpostazioniInformazioni.

03

Registra il CLI

Segui le istruzioni a schermo per aggiungere la CLI al PATH del tuo sistema. Riavvia il terminale per applicare le modifiche.

La registrazione aggiunge il file binario di Obsidian al tuo PATH tramite ~/.zprofile. Se usi bash o fish, aggiungi manualmente il percorso alla configurazione della tua shell.

~/.zprofile
export PATH="$PATH:/Applications/Obsidian.app/Contents/MacOS"

L’eseguibile aggiunge un redirector terminale Obsidian.com insieme a Obsidian.exe. Ciò è necessario perché Obsidian funziona come applicazione GUI.

AppImage: Un symlink è creato in /usr/local/bin/obsidian (richiede sudo). Se sudo non funziona, ricorre a ~/.local/bin.

Flatpak: Un symlink è creato automaticamente. Se l’operazione non va a buona fine, creane uno manualmente che punti all’export Flatpak.

Esegui il tuo primo comando

Una volta installato, sei pronto per iniziare. Tieni presente che l’app Obsidian deve essere in esecuzione.

Esegui un comando

terminale
# Mostra aiuto
obsidian help

Usa la modalità TUI

terminale
# Apri TUI (con autocompletamento)
obsidian

Esempi

Guardalo in azione

Scopri alcuni esempi pratici, dagli appunti quotidiani all’automazione per sviluppatori.

terminale
# Apri la nota giornaliera odierna
obsidian daily

# Aggiungi un’attività alla tua nota giornaliera
obsidian daily:append content="- [ ] Fai la spesa "

# Cerca nel tuo vault
obsidian search query="appunti della riunione"

# Leggi il file corrente
obsidian read

# Elenca tutte le attività dalle note giornaliere
obsidian tasks daily

# Crea una nuova nota basata su un template
obsidian create name="Viaggio a Parigi" template=Viaggi

# Vedi tutti i tag e la loro frequenza
obsidian tags counts

# Compara due versioni di un file
obsidian diff file=README from=1 to=3
terminale
# Apri gli strumenti per sviluppatori
obsidian devtools

# Ricarica il plugin in sviluppo
obsidian plugin:reload my-plugin

# Cattura screenshot dell’app
obsidian dev:screenshot file=shot.png

# Esegui JavaScript
obsidian eval "app.vault.getFiles().length"

# Esamina errori JS
obsidian dev:errors

# Ispeziona le proprietà CSS
obsidian dev:css selector=".workspace"

# Esegui query sugli elementi del dDOM
obsidian dev:dom selector=".nav"
terminale
#!/bin/bash
# Automatizza la routine mattutina

# Apri la nota giornaliera odierna
obsidian daily

# Aggiungi attività di ruotine
obsidian daily:append content="- [ ] Controlla la posta in entrata"
obsidian daily:append content="- [ ] Controlla il calendario"

# Copia i file recenti negli appunti
obsidian files sort=modified limit=5 --copy

# Cerca collegamenti non risolti 
obsidian unresolved

# Cerca un vault specifico ed esporta come JSON
obsidian search query="status::active" vault="Note" format=json

Scorciatoie da tastiera

Scorciatoie da tastiera

Comode scorciatoie da tastiera e completamento automatico integrati nella TUI.

Navigazione

Vai a sinistra / Ctrl+B
Vai a destra / Ctrl+F
Inizio riga Ctrl+A
Fine riga Ctrl+E
Parola precedente Alt+B
Parola successiva Alt+F

Modifica

Cancella fino all’inizio della riga Ctrl+U
Cancella fino alla fine della riga Ctrl+K
Cancella parola precedente Ctrl+W / Alt+⌫
Accetta suggerimento Tab
Ignora suggerimento Shift+Tab
Accetta il primo suggerimento

Generali

Comando precedente / Ctrl+P
Comando successivo / Ctrl+N
Cronologia delle ricerche Ctrl+R
Cancella Escape
Ripulisci schermo Ctrl+L
Esci Ctrl+C / Ctrl+D

Sync

Sincronizzazione headless

Esegui Obsidian Sync senza GUI. Tutta la velocità, privacy e la crittografia end-to-end di Obsidian Sync, su qualsiasi server o ambiente automatizzato.

  • Automatizza i backup remoti.
  • Automatizza la pubblicazione di un sito web.
  • Consenti agli strumenti agentici l’accesso a un vault senza dare l’accesso al resto del computer.
  • Sincronizza un vault condiviso con il tuo team a un server che alimenta altri strumenti.
  • Esegui automazione pianificate: aggrega note giornaliere in riepiloghi settimanali, aggiungi automaticamente tag e altro ancora.

Inizia

Scopri come installare e usare Obsidian CLI.