Obsidian Sync agora oferece suporte a clientes headless

 (help.obsidian.md)
2 pontos por GN⁺ 2026-03-01 | 1 comentários | Compartilhar no WhatsApp
  • O Obsidian Sync agora oferece um cliente headless que permite sincronizar pela linha de comando sem o app de desktop
  • É possível realizar a sincronização de vaults em ambientes não interativos, como pipelines de CI, servidores e scripts de automação
  • Com o comando ob sync, é possível executar sincronização única ou contínua, com autenticação automática via variável de ambiente OBSIDIAN_AUTH_TOKEN
  • Inclui um conjunto detalhado de comandos para criar vault remoto, configurar conexão local, verificar status e alterar configurações
  • No Windows e no macOS, oferece um módulo nativo que preserva o horário de criação do arquivo (birthtime), reforçando a integridade dos dados

Visão geral

  • O Headless Client do Obsidian Sync é uma ferramenta para sincronizar vaults sem o app de desktop
    • Útil em ambientes como CI, agentes de automação e servidores
    • Permite trazer as mudanças mais recentes ou manter os arquivos continuamente atualizados
  • Em um mesmo dispositivo, não se deve usar o Sync de desktop e o Headless Sync ao mesmo tempo, pois há risco de conflito de dados
  • A instalação é feita com o comando npm install -g obsidian-headless

Uso básico

  • Login: ob login
  • Ver lista de vaults remotos: ob sync-list-remote
  • Configurar vault local: ob sync-setup --vault "My Vault"
  • Sincronização única: ob sync
  • Sincronização contínua: ob sync --continuous
  • Em ambientes não interativos, é possível automatizar a autenticação configurando a variável de ambiente OBSIDIAN_AUTH_TOKEN

Principais comandos

  • ob sync-list-remote: exibe a lista de todos os vaults remotos da conta, incluindo vaults compartilhados
  • ob sync-list-local: mostra os vaults configurados localmente e seus caminhos
  • ob sync-create-remote: cria um novo vault remoto
    • Opções: --name, --encryption (standard ou e2ee), --password, --region
  • ob sync-setup: configura a conexão entre o vault local e o remoto
    • Opções: --vault, --path, --password, --device-name, --config-dir
  • ob sync: executa a sincronização do vault configurado
    • Com a opção --continuous, oferece monitoramento de alterações e sincronização contínua
  • ob sync-config: consulta ou altera as configurações de sincronização do vault
    • Permite definir estratégia de conflito (merge/conflict), tipos de arquivo, categorias de configuração a sincronizar e pastas excluídas
  • ob sync-status: exibe o status e as configurações de sincronização do vault
  • ob sync-unlink: desvincula o vault da sincronização e remove as credenciais salvas

Módulo nativo

  • Inclui um addon nativo para Windows e macOS que define o horário de criação do arquivo (birthtime)
    • Ao baixar arquivos do servidor, preserva o horário de criação original
    • Tem como alvo a versão 3 do N-API e mantém compatibilidade de ABI entre versões do Node.js
  • No Linux, birthtime não é compatível, então o addon não é incluído, mas a sincronização funciona normalmente
  • Alvos dos binários pré-compilados:
    • win32-x64, win32-arm64, win32-ia32, darwin-x64, darwin-arm64

Leituras relacionadas

1 comentários

 
GN⁺ 2026-03-01
Comentários do Hacker News
  • O Obsidian acabou de adicionar funcionalidade de CLI
    Veja a documentação oficial
    Ultimamente tem sido muito divertido usar o Obsidian com uma AI CLI. Mesmo sem plugins, dá para aproveitar na hora porque é simplesmente uma estrutura de diretórios Markdown
    • Eu vinha sincronizando o Obsidian com iCloud, mas era incômodo porque ele exigia permissão de disco completo ao acessar o contêiner de arquivos do iCloud
      Queria saber se todo mundo usa o Obsidian Sync pago ou alternativas como SyncThing
    • Fico feliz em ver a CLI ganhando destaque de novo
    • Ainda não dá para ver notas diretamente pela CLI, mas já é possível acionar algumas operações, como busca
    • Parece que vou conseguir usar esse recurso de forma muito útil, obrigado
  • Eu participei diretamente deste projeto. Se tiverem perguntas, posso tentar responder
    • Agradece por terem criado o Obsidian e pergunta se há planos de empacotar o cliente de sincronização headless para uso com Docker ou Podman
      Também quer saber se, ao instalar o obsidian-headless, a CLI vem junto ou se é algo dedicado apenas à sincronização
    • Eu estava justamente comentando no trabalho que não havia sincronização por CLI, então fico feliz em ver um recurso oficial
      Agora vou considerar o Obsidian Sync oficial
    • Queria saber como são tratados conflitos de sincronização no sistema de arquivos
      Por exemplo, se houver edições simultâneas e um lado sobrescrever o outro, o que acontece com minhas alterações?
    • Pergunta se há planos para oferecer permissões com scoped token que permitam acesso apenas a pastas ou notas específicas
      Quero atualizar automaticamente certas notas com mudanças de estado ou cron jobs, mas prefiro evitar acesso ao vault inteiro
      Gostei tanto do produto que até comprei o VIP Catalyst
    • Queria saber se existe algum guia ou ponto de partida para uma configuração de colaboração em equipe em que várias pessoas editem arquivos e sincronizem juntas
  • Seria bom poder editar apenas um único arquivo Markdown
    Por exemplo, se eu só tiver um readme.md em um projeto, não quero criar um vault separado e um arquivo de configuração só para abrir isso
    • Esse recurso deve ser adicionado em algum momento
      Mas não é simples, porque muitos recursos do Obsidian dependem de configurações no nível do vault
      Por exemplo, qual tema usar, quais plugins ativar, como tratar o autocompletar de [[links]] etc.
  • Este era o recurso do Obsidian que eu mais queria
    Parece que vai ser realmente útil para automação no lado do servidor ou tarefas baseadas em RAG
  • Ontem encontrei e reportei um bug enquanto testava o cliente headless, e hoje já vi que foi corrigido
    Sobre isso, tenho um post experimental no blog → utf9k.net/blog/obsidian-headless
    Esse fluxo de trabalho não é perfeito, mas dá a sensação de haver menos atrito entre escrever e publicar logo em seguida
    Antes eu combinava Git com vários plugins do Obsidian, mas sempre ficava complexo
  • Eu achava que bastava usar o Nextcloud como uma pasta local de Markdown, mas não era isso
    Acho que eu estava usando tudo completamente errado
  • Alguém tem recomendação de plugin do Obsidian com suporte a edição com IA no celular?
    Quero conversar com o documento e editá-lo como no ChatGPT, mas ainda não encontrei algo adequado
    Também tenho dúvida se existe tool calling que permita editar só partes do texto sem reescrever o documento inteiro
    • Testei vários plugins, mas no fim o melhor foi usar o Claude Code por controle remoto
  • Não uso Obsidian no desktop, mas uso no celular
    Com esse recurso, acho que vou poder sincronizar no telefone e abrir os documentos com Neovim no desktop
  • Faz mais de um ano que pesquiso “Obsidian CLI” todo mês, então estou muito feliz que finalmente saiu
    • Eu também uso o Obsidian com Claude ou Codex, mas não entendo muito bem qual valor extra a CLI traz
      Se já são apenas arquivos Markdown, por que a CLI é necessária, e como a IA lida com o vault por meio dela?
  • Eu uso o Obsidian com um agente Claude para sincronizar material de pesquisa ou registros diários
    Já funciona muito bem com habilidades personalizadas, mas esse recurso deve deixar o fluxo de trabalho mais fluido
    Também criei uma ferramenta de CLI chamada obsidian-semantic-search para implementar indexação de embeddings no LanceDB e busca semântica
    Com isso, dá para criar melhor as conexões internas entre as notas
    • Queria saber se você pode compartilhar um pouco mais da configuração detalhada com o Claude Code
    • Também queria entender que impacto essa abordagem tem no uso de tokens ou nas cotas